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

# Autenticación

> Crea tu clave de API, envía las credenciales y elige los alcances.

## Visión general

La API de DoglyTdc Pay usa **claves de API** con `client_id` y `client_secret`. No hay intercambio por token: envías ambas partes en cada solicitud, siempre a través de HTTPS.

![Captura de pantalla: Claves de API en DoglyTdc Pay](https://mintcdn.com/dogly-tdc/qOnot79kPtISSKbW/images/pay/pay-api.png?fit=max\&auto=format\&n=qOnot79kPtISSKbW\&q=85\&s=3002ebf0377906f83f1b8dbbd6f19284)

Claves de API en DoglyTdc Pay

## Flujo de autenticación

```mermaid theme={null}
sequenceDiagram
  participant App as Tu aplicación
  participant Pay as DoglyTdc Pay API
  App->>Pay: GET /products (Authorization: Basic …)
  Pay->>Pay: verifica la clave, el secreto y los alcances
  Pay-->>App: 200 { data: [...] }
```

## 1 - Crear la clave de API

**1. Abre DoglyTdc Pay**

Entra en **DoglyTdc Pay › Integraciones › DoglyTdc Pay API**.

**2. Crea la clave**

Asigna un nombre (ej.: "Mi tienda") y selecciona los alcances.

**3. Copia el secreto**

El `client_secret` aparece **una sola vez**. Guárdalo en un gestor de secretos.

> [!WARNING]
>
> DoglyTdc solo guarda un resumen (hash) del secreto. Si lo pierdes, revoca la clave y crea otra.

## 2 - Enviar las credenciales

Tres formatos aceptados (usa uno):

```bash Basic (recomendado) theme={null}
curl https://ucsyxzpdbnuyehizezvb.supabase.co/functions/v1/doglytdc-pay/v1/products \
  -u "dpk_SU_CLIENT_ID:SU_CLIENT_SECRET"
```

```bash Bearer theme={null}
curl https://ucsyxzpdbnuyehizezvb.supabase.co/functions/v1/doglytdc-pay/v1/products \
  -H "Authorization: Bearer dpk_SU_CLIENT_ID:SU_CLIENT_SECRET"
```

```bash Headers separados theme={null}
curl https://ucsyxzpdbnuyehizezvb.supabase.co/functions/v1/doglytdc-pay/v1/products \
  -H "X-Client-Id: dpk_SU_CLIENT_ID" \
  -H "X-Client-Secret: SU_CLIENT_SECRET"
```

## 3 - Alcances de acceso

Cada endpoint exige **todos** los alcances de su línea. Las lecturas requieren `read` + el recurso; las escrituras requieren `write` + el recurso.

| Alcance | Para qué sirve |
| - | - |
| `read` | Leer datos de la cuenta |
| `write` | Crear y modificar datos (junto con el alcance del recurso) |
| `products` | Productos |
| `offers` | Ofertas y precios |
| `orders` | Pedidos y reembolsos |
| `subscriptions` | Suscripciones |
| `webhooks` | Listar y crear webhooks |
| `payments` | Enlaces de pago |
| `withdrawals_read` | Ver saldo y retiros |
| `withdrawals_request` | Solicitar retiro (siempre con confirmación en la app) |

Sin el alcance, la respuesta es `403 insufficient_scope` indicando cuáles faltan.

## Seguridad

* Usa la clave **solo en el servidor**. Nunca la incluyas en el navegador, en la app o en un repositorio.
* Una clave por integración, con el mínimo de alcances.
* Revoca de inmediato cualquier clave expuesta, en **Integraciones › DoglyTdc Pay API**.
* Los reembolsos y enlaces de pago siempre requieren tu aprobación dentro de DoglyTdc Pay.

## Ejemplos de clientes

```javascript Node.js theme={null}
const auth = Buffer.from(`${process.env.DPAY_CLIENT_ID}:${process.env.DPAY_CLIENT_SECRET}`).toString("base64");
const res = await fetch("https://ucsyxzpdbnuyehizezvb.supabase.co/functions/v1/doglytdc-pay/v1/orders", { headers: { Authorization: `Basic ${auth}` } });
const { data } = await res.json();
```

```python Python theme={null}
import os, requests
r = requests.get("https://ucsyxzpdbnuyehizezvb.supabase.co/functions/v1/doglytdc-pay/v1/orders", auth=(os.environ["DPAY_CLIENT_ID"], os.environ["DPAY_CLIENT_SECRET"]))
print(r.json()["data"])
```

```php PHP theme={null}
$ch = curl_init("https://ucsyxzpdbnuyehizezvb.supabase.co/functions/v1/doglytdc-pay/v1/orders");
curl_setopt($ch, CURLOPT_USERPWD, getenv("DPAY_CLIENT_ID") . ":" . getenv("DPAY_CLIENT_SECRET"));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$orders = json_decode(curl_exec($ch), true)["data"];
```


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