Skip to main content
POST
Complemento de pago

Authorizations

x-api
string
header
required

API key emitida por Ipsofactura, enviada en el header x-api.

Headers

Idempotency-Key
string

Alternativa a idempotency_key en el cuerpo: reenviar la misma llave devuelve la respuesta del primer intento (Idempotency-Replayed: true) en lugar de timbrar otra vez, y la misma llave con un cuerpo distinto es 422 IDEMPOTENCY_KEY_REUSED. Máximo 100 caracteres ASCII imprimibles, sin espacios. Si además envías el campo en el cuerpo, los dos valores deben coincidir; si no, la respuesta es 400 VALIDATION_ERROR.

Maximum string length: 100
Example:

"order-4711"

Body

application/json
pagos
object[]
required
Minimum array length: 1
rfc_emisor
string
required
Minimum string length: 1
fecha
string
Pattern: \d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(Z|[+-]\d{2}:\d{2})?
folio
string
idempotency_key
string

Llave estable opcional (por ejemplo, el id del pago de origen). Reenviar la misma llave devuelve el CFDI ya timbrado en lugar de crear otra parcialidad. Máximo 100 caracteres ASCII imprimibles, sin espacios.

Maximum string length: 100
Pattern: ^[\x21-\x7E]+$
Example:

"pago-2026-08-0042"

rfc_receptor
string

Opcional y sólo útil en el sandbox: RFC reservado que fuerza un escenario (los mismos que en POST /cfdi/timbrar). No se timbra — el receptor del complemento lo determina el CFDI relacionado, como exige el SAT — y en producción se ignora.

Maximum string length: 13
serie
string

Response

Complemento de pago timbrado

documentos_relacionados
object[]
fecha_timbrado
string
deprecated
folio
string
id
string
sandbox
boolean
sello_cfdi
string
sello_sat
string
serie
string
stamped_at
string
uuid
string