Skip to main content
La API de SimplePay usa codigos HTTP para separar errores de validacion, autenticacion, permisos, estado de negocio y fallas temporales.

Codigos comunes

Estrategia de retries

1

Reintenta solo operaciones seguras

Para writes, reintenta si y solo si mandaste Idempotency-Key.
2

Usa exponential backoff

No hagas loops agresivos contra 429 o 5xx.
3

Guarda request IDs

Si la respuesta incluye identificadores de debugging, guardalos junto a tu orden.
4

No confirmes por timeout

Si tu create checkout tuvo timeout, lee por tu referencia o espera webhook. No marques pagado por asumir exito.

Ejemplo de handler

api-client.ts

Errores de politica

Un 403 no siempre significa “API key mala”. Tambien puede significar:
  • El tenant no tiene habilitado el producto.
  • El monto excede limites.
  • El metodo de pago no esta permitido.
  • Live esta bloqueado.
  • El flujo necesita revision manual.
  • La key no tiene el scope requerido.
Usa Payment policy para inspeccionar elegibilidad antes de mostrar un metodo de pago o una opcion de installments.
Last modified on June 21, 2026