Documentación / API / Complementos de pago (REP)

Listar complementos de pago

GEThttps://api.cfdi.express/v1/paymentsAPI key

Lista los complementos de pago de la cuenta con filtros por factura, emisor, estatus, UUID y fechas.

Autenticación

Authorization: Bearer sk_test_... | sk_live_...

Parámetros

Query string

Campo	Tipo	Descripción
limit	integer	Elementos por página. Entre 1 y 100. Default 10.
starting_after	string	Id del último REP de la página anterior (cursor).
merchantId	string	Filtra por emisor.
invoiceId	string	Filtra por la factura pagada.
status	string	stamping, stamped, stamp_failed, cancel_pending o cancelled.
uuid	string	Busca por folio fiscal del REP.
createdFrom	string	Fecha ISO 8601 mínima de creación.
createdTo	string	Fecha ISO 8601 máxima de creación.

Ejemplos

cURL

curl -G https://api.cfdi.express/v1/payments \
  -H "Authorization: Bearer sk_test_..." \
  --data-urlencode "invoiceId=inv7k3q9x2m4v1t8p6d0n5cb"

Respuesta

200 OK

{
  "object": "list",
  "data": [
    {
      "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" },
      "cancellation": null,
      "stampedAt": "2026-08-18T18:31:12.006Z",
      "createdAt": "2026-08-18T18:31:10.554Z"
    }
  ],
  "has_more": false
}

Errores

Status	code	Cuándo aparece
401	unauthorized	Falta el header Authorization o la llave es inválida.
429	rate_limited	Excediste el límite de requests por minuto de tu cuenta (300 por default). La respuesta incluye Retry-After.

Continuar

POSTTimbrar REP GETObtener REP