Obtener un complemento de pago
GEThttps://api.cfdi.express/v1/payments/{id}API key
Devuelve el complemento de pago con su UUID, los saldos del momento del pago y las URLs firmadas de sus archivos.
Autenticación
Authorization: Bearer sk_test_... | sk_live_...Parámetros
Parámetros de ruta
| Campo | Tipo | Descripción |
|---|---|---|
| idreq | string | Id del complemento de pago. |
Ejemplos
cURL
curl https://api.cfdi.express/v1/payments/pay9x2m6q4k1v3p8d7n5c0bt \
-H "Authorization: Bearer sk_test_..."Respuesta
200 OK
{
"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. |