Maneja errores y limitaciones
Diseña tu integración para fallas de validación, disponibilidad del servicio, límites y resultados inciertos de la red.
Códigos de estado
| Estado | Significado | Acción |
|---|---|---|
| 400 | Datos de solicitud inválidos | Corrige la solicitud; no la reintentes sin cambios. |
| 401 | Clave de API ausente, inválida o inactiva | Revisa x-api-key y la rotación de claves. |
| 404 | No se encontró el pago o recurso para el tenant | Revisa el ID y el alcance del tenant. |
| 422 | La red bancaria rechazó la operación | Revisa el código de error y no reintentes la solicitud sin cambios. |
| 503 | El servicio de pagos no está disponible | Reintenta más tarde después de confirmar el estado del pago original. |
| 5xx | Falla del gateway o de la red bancaria | Considera el resultado incierto y consulta el pago. |
Limitaciones actuales
- El reverso de C2P es el único flujo de reverso compatible.
- La entrega de webhooks se intenta una sola vez, sin reintento automático y con un tiempo de espera de 10 segundos.
- externalRef correlaciona registros, pero no proporciona idempotencia.
- La aplicación del tenant obtiene los tokens C2P; el backend no se comunica con los clientes.
Recupérate de forma segura
- Registra el intento
Guarda la referencia de tu pedido y cualquier ID de pago del gateway que se haya devuelto.
- Resuelve la incertidumbre
Consulta por ID de pago o por externalRef cuando no hayas recibido un ID.
- Reintenta deliberadamente
Envía otra operación de escritura solo después de confirmar que la original no se completó.