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
Un403 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.