Lista para producción
Lo que debes cumplir antes de mover dinero real.
Cuando todas las casillas estén marcadas, tu integración puede salir a producción. Cambiar de ambiente sólo cambia la base y la llave.
- KYB aprobado. Conceptos. Escenario:
kyb_required. - Contrato firmado, con la cláusula de responsabilidad por montos. Límites.
- Giro mercantil, representante legal e identificación entregados a FITAL. Soporte.
- Ciclo completo probado en la cuenta de prueba: pago, fallo, devolución. Cuenta de prueba. Escenarios:
payment_completed,payment_failed,payment_returned. - Reintento con misma clave probado ante timeout. Reintentos.
- 429 y 503 manejados con espera. Límites. Escenarios:
rate_limited,service_unavailable. - Firma de webhook verificada, con rechazo de firma mala y de timestamp vencido. Verificar la firma.
- Duplicados y desorden de eventos resueltos. Webhooks.
- Manejo de
returneddespués decompletedy de un pago que se reabre. Conciliar. Escenario:payment_returned. La reapertura no tiene escenario: simula sus eventos. - Llave de producción en gestor de secretos, nunca en código, con su rotación prevista antes de los 180 días. Vencimiento.
- IP de salida registradas en la llave. IP permitidas. Escenario:
ip_not_allowed. - Firewall abierto a las IP de webhooks, si aplica. IP de webhooks.
- Comportamiento ante caída total definido. Salud y estado. Escenario:
status_degraded. - Cambio de base y llave por configuración, sin tocar código. Ambientes.
-
request_idguardado en tus registros. Soporte. - Primer pago real de monto pequeño, con resultado conciliado. Conciliar.
Errores comunes
- Salir sin registrar IP: una llave de producción sin lista no opera y responde
403 ip_not_allowed. - Probar sólo el camino feliz.