Catálogo de errores
| code | status | significado |
|---|---|---|
unknown_parameter | 400 | clave desconocida en el cuerpo (param = la clave) |
invalid_request | 400 | campo inválido/faltante (param cuando aplica) |
missing_idempotency_key | 400 | Idempotency-Key faltante en un POST de creación |
invalid_idempotency_key | 400 | Idempotency-Key malformado |
idempotency_key_reuse | 409 | misma clave, cuerpo diferente |
reserved_metadata_key | 400 | clave metadata con prefijo reservado |
merchant_net_not_positive | 400 | link absorb con neto ≤ 0 |
not_available_in_live | 403 | endpoint solo-sandbox llamado en producción |
invalid_api_key | 401 | clave inexistente/revocada |
insufficient_scope | 403 | clave sin el alcance del endpoint |
payment_link_not_found | 404 | link inexistente para el tenant |
payment_not_found | 404 | pago inexistente para el tenant |
event_not_found | 404 | evento inexistente (el endpoint de eventos es planeado) |
internal_error | 500 | error inesperado — cite request_id |
Alcances (scopes)
payment_links:write · payment_links:read (planeado) · payment_intents:read · payment_intents:write · quotes:read · quotes:write · payments:read · payments:write · events:read (planeado).
Contrato canónico v1. Una divergencia entre el código y este documento es un bug del código; cambiar este documento requiere un ADR.