Pular para o conteúdo principal

Visão geral

A API do DoglyTdc Pay é uma API REST para integrar sua aplicação ao DoglyTdc Pay: listar produtos, pedidos e assinaturas, consultar saldo, criar webhooks e pedir links de pagamento e reembolsos pelo código. O DoglyTdc Pay recebe por PIX e por Saldo DoglyTdc. Não existe pagamento por cartão.

URL base

Todos os endpoints ficam sob esse prefixo. Exemplo: a lista de produtos é https://ucsyxzpdbnuyehizezvb.supabase.co/functions/v1/doglytdc-pay/v1/products.
Captura de tela: Painel do DoglyTdc Pay

Painel do DoglyTdc Pay

Pré-requisitos

1

Conta no DoglyTdc

Uma conta ativa em doglytdc.dev com o DoglyTdc Pay ativado.
2

Chave de API

Um client_id (dpk_…) e um client_secret criados em DoglyTdc Pay › Integrações › DoglyTdc Pay API.
3

Escopos certos

Cada endpoint exige escopos. Marque só os que sua integração usa.

Guia completo de autenticação

Como criar a chave, enviar as credenciais e escolher os escopos.

Formato das requisições

Toda requisição leva a chave no header Authorization:

Formato das respostas

As respostas são JSON. Listas vêm dentro de data:
Valores de dinheiro são sempre inteiros em centavos (1990 = R$ 19,90) e a moeda vem em currency (BRL ou USD).

Códigos de status HTTP

Ações que movem dinheiro

Reembolsos e links de pagamento não executam direto pela API. A API responde 202 com um approval_id e você confirma em DoglyTdc Pay › Integrações › MCP. Assim, uma chave vazada nunca tira dinheiro da sua conta sozinha.

Próximos passos

Primeira chamada em 5 minutos

Do zero à primeira resposta.

Receber sua primeira venda

Produto, webhook e evento chegando.

Guia de webhooks

Eventos, assinatura e retentativas.

Referência da API

Todos os endpoints com “Try it”.