> ## Documentation Index
> Fetch the complete documentation index at: https://docs.doglytdc.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Introdução

> Entenda conceitos, pré-requisitos e como funciona a API do DoglyTdc Pay.

## 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

```bash theme={null}
https://ucsyxzpdbnuyehizezvb.supabase.co/functions/v1/doglytdc-pay/v1/
```

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](https://mintcdn.com/dogly-tdc/qOnot79kPtISSKbW/images/pay/pay-dashboard.png?fit=max\&auto=format\&n=qOnot79kPtISSKbW\&q=85\&s=9e36adb112641383d49df6296ddd5d10)

Painel do DoglyTdc Pay

## Pré-requisitos

**1. Conta no DoglyTdc**

Uma conta ativa em [doglytdc.dev](https://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.

> [card] [Guia completo de autenticação](https://docs.doglytdc.dev/pt-BR/pay/authentication.md)
>
> Como criar a chave, enviar as credenciais e escolher os escopos.

## Formato das requisições

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

```http theme={null}
Authorization: Basic base64(client_id:client_secret)
Content-Type: application/json
```

## Formato das respostas

As respostas são JSON. Listas vêm dentro de `data`:

```json theme={null}
{
  "data": [
    { "id": "8f0c…", "name": "Curso de exemplo", "price_cents": 1990, "currency": "BRL" }
  ]
}
```

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

| Código | Descrição |
| - | - |
| `200` | Requisição bem-sucedida |
| `201` | Recurso criado |
| `202` | Pedido recebido; precisa da sua aprovação no DoglyTdc Pay |
| `400` | Dados inválidos |
| `401` | Chave ausente, inválida ou revogada |
| `403` | A chave não tem os escopos exigidos |
| `404` | Recurso não encontrado nesta conta |
| `429` | Limite de requisições atingido |
| `503` | Serviço indisponível no momento; tente de novo |

## 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

> [card] [Primeira chamada em 5 minutos](https://docs.doglytdc.dev/pt-BR/pay/get-started/first-call.md)
>
> Do zero à primeira resposta.

> [card] [Receber sua primeira venda](https://docs.doglytdc.dev/pt-BR/pay/get-started/first-sale.md)
>
> Produto, webhook e evento chegando.

> [card] [Guia de webhooks](https://docs.doglytdc.dev/pt-BR/pay/concepts/webhooks.md)
>
> Eventos, assinatura e retentativas.

> [card] [Referência da API](https://docs.doglytdc.dev/pt-BR/pay/api-reference/products/list.md)
>
> Todos os endpoints com "Try it".


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.