# Obtener un complemento de pago

> `GET https://api.cfdi.express/v1/payments/{id}` — Devuelve el complemento de pago con su UUID, los saldos del momento del pago y las URLs firmadas de sus archivos.

URL de esta página: https://cfdi.express/docs/api/obtener-complemento-de-pago
Autenticación: requiere API key (`Authorization: Bearer sk_test_…` o `sk_live_…`)

### Parámetros de ruta

| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| `id` | string | sí | Id del complemento de pago. |

## Ejemplos

### cURL

```bash
curl https://api.cfdi.express/v1/payments/pay9x2m6q4k1v3p8d7n5c0bt \
  -H "Authorization: Bearer sk_test_..."
```

## Respuesta

### 200 OK

```json
{
  "id": "pay9x2m6q4k1v3p8d7n5c0bt",
  "object": "payment",
  "livemode": false,
  "status": "stamped",
  "invoiceId": "inv7k3q9x2m4v1t8p6d0n5cb",
  "merchantId": "mkq2f8v3x1t7p9d4n6c0b5rz",
  "uuid": "5c9e7f22-1a3b-4d8e-9f01-2b3c4d5e6f70",
  "numParcialidad": 1,
  "monto": 2000.00,
  "formaPago": "03",
  "fechaPago": "2026-08-18T12:00:00.000Z",
  "saldoAnterior": 3670.00,
  "saldoInsoluto": 1670.00,
  "currency": "MXN",
  "files": {
    "status": "ready",
    "xmlUrl": "https://files.cfdi.express/5c9e7f22....xml?X-Amz-Expires=900&...",
    "pdfUrl": "https://files.cfdi.express/5c9e7f22....pdf?X-Amz-Expires=900&...",
    "zipUrl": "https://files.cfdi.express/5c9e7f22....zip?X-Amz-Expires=900&..."
  },
  "cancellation": null,
  "stampedAt": "2026-08-18T18:31:12.006Z",
  "createdAt": "2026-08-18T18:31:10.554Z"
}
```

## Errores

| Status | code | Cuándo aparece |
|---|---|---|
| 401 | `unauthorized` | Falta el header Authorization o la llave es inválida. |
| 404 | `not_found` | El complemento no existe en tu cuenta. |

## Relacionados

- [POST /v1/invoices/{id}/payments](https://cfdi.express/docs/api/timbrar-complemento-de-pago) — Timbrar REP
- [GET /v1/payments](https://cfdi.express/docs/api/listar-complementos-de-pago) — Listar REPs

---

Referencia completa: https://cfdi.express/docs/api · OpenAPI: https://api.cfdi.express/openapi.json · Llaves: https://dash.cfdi.express