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

# Introducción

> Referencia interactiva de la API de Veripay generada desde OpenAPI 3.1.

## Base URL

```
https://veripay.datagora.mx/api
```

Todos los endpoints públicos están bajo el prefijo `/v1/cep/*`. Las rutas de gestión (`/keys`, `/admin/*`) usan **sesión de Supabase** y no son consumibles desde código de cliente.

## Autenticación

```http theme={null}
x-api-key: vk_live_xxxxxxxx.SECRETO
```

Genera tu key en el [dashboard](https://veripay.datagora.mx/keys). Detalles en [Autenticación](/concepts/authentication).

## Convenciones

|                          |                                                                                                       |
| ------------------------ | ----------------------------------------------------------------------------------------------------- |
| **Encoding**             | UTF-8                                                                                                 |
| **Content-Type request** | `application/json`                                                                                    |
| **Errores**              | JSON `{ error, message, details? }` — ver [Errores](/concepts/errors)                                 |
| **Versionado**           | Prefijo `/v1`. Cambios breaking subirán a `/v2`.                                                      |
| **Idempotencia**         | Las descargas son seguras de reintentar; el CEP es inmutable por (`fecha`, `clave_rastreo`, `monto`). |
| **Timeout sugerido**     | `15s` por request                                                                                     |

## Tipos de endpoints CEP

<CardGroup cols={2}>
  <Card title="Modo explícito" icon="bullseye">
    `/v1/cep/{xml,pdf,base64,xml_base64}` — requieren `emisor` y `receptor` (códigos Banxico de 5 dígitos).
  </Card>

  <Card title="Modo auto" icon="wand-magic-sparkles">
    `/v1/cep/{xml,pdf,zip}_auto` — infieren emisor/receptor desde la `cuenta`. Ver [Inferencia](/concepts/inference).
  </Card>
</CardGroup>

## Headers de respuesta útiles

| Header                | Significado                                      |
| --------------------- | ------------------------------------------------ |
| `X-Inferred-Emisor`   | Código Banxico inferido (sólo `_auto`)           |
| `X-Inferred-Receptor` | Código Banxico inferido (sólo `_auto`)           |
| `X-Date-Used`         | Fecha exacta consultada en Banxico               |
| `X-Attempts`          | Intentos realizados antes del hit                |
| `X-Request-Id`        | ID único del request, úsalo al contactar soporte |