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

# Introducción

> Entiende conceptos, requisitos previos y cómo funciona la API de DoglyTdc Pay.

## Visión general

La API de DoglyTdc Pay es una API REST para integrar tu aplicación con DoglyTdc Pay: listar productos, pedidos y suscripciones, consultar saldo, crear webhooks y solicitar links de pago y reembolsos mediante código.

DoglyTdc Pay recibe pagos mediante **PIX** y **Saldo DoglyTdc**. No existen pagos con tarjeta.

### URL base

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

Todos los endpoints se encuentran bajo este prefijo. Ejemplo: la lista de productos es `https://ucsyxzpdbnuyehizezvb.supabase.co/functions/v1/doglytdc-pay/v1/products`.

![Captura de pantalla: Panel de DoglyTdc Pay](https://mintcdn.com/dogly-tdc/qOnot79kPtISSKbW/images/pay/pay-dashboard.png?fit=max\&auto=format\&n=qOnot79kPtISSKbW\&q=85\&s=9e36adb112641383d49df6296ddd5d10)

Panel de DoglyTdc Pay

## Requisitos previos

**1. Cuenta en DoglyTdc**

Una cuenta activa en [doglytdc.dev](https://doglytdc.dev) con DoglyTdc Pay activado.

**2. Clave de API**

Un `client_id` (`dpk_…`) y un `client_secret` creados en **DoglyTdc Pay › Integraciones › DoglyTdc Pay API**.

**3. Scopes correctos**

Cada endpoint exige scopes. Marca solo los que utiliza tu integración.

> [card] [Guía completa de autenticación](https://docs.doglytdc.dev/es/pay/authentication.md)
>
> Cómo crear la clave, enviar las credenciales y elegir los scopes.

## Formato de las peticiones

Cada petición incluye la clave en el encabezado `Authorization`:

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

## Formato de las respuestas

Las respuestas son en formato JSON. Las listas vienen dentro de `data`:

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

Los valores monetarios son siempre **enteros en centavos** (`1990` = R\$ 19,90) y la moneda viene en `currency` (`BRL` o `USD`).

### Códigos de estado HTTP

| Código | Descripción |
| - | - |
| `200` | Petición exitosa |
| `201` | Recurso creado |
| `202` | Solicitud recibida; requiere tu aprobación en DoglyTdc Pay |
| `400` | Datos inválidos |
| `401` | Clave ausente, inválida o revocada |
| `403` | La clave no tiene los scopes requeridos |
| `404` | Recurso no encontrado en esta cuenta |
| `429` | Límite de peticiones alcanzado |
| `503` | Servicio no disponible en este momento; intenta de nuevo |

## Acciones que mueven dinero

Los reembolsos y los links de pago **no se ejecutan directamente a través de la API**. La API responde `202` con un `approval_id` y tú confirmas en **DoglyTdc Pay › Integraciones › MCP**. De esta manera, una clave filtrada nunca retirará dinero de tu cuenta por sí sola.

## Próximos pasos

> [card] [Primera llamada en 5 minutos](https://docs.doglytdc.dev/es/pay/get-started/first-call.md)
>
> Desde cero hasta la primera respuesta.

> [card] [Recibir tu primera venta](https://docs.doglytdc.dev/es/pay/get-started/first-sale.md)
>
> Producto, webhook y recepción de eventos.

> [card] [Guía de webhooks](https://docs.doglytdc.dev/es/pay/concepts/webhooks.md)
>
> Eventos, firma y reintentos.

> [card] [Referencia de la API](https://docs.doglytdc.dev/es/pay/api-reference/products/list.md)
>
> Todos los endpoints con "Try it".


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