FITALAPI

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 returned después de completed y 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_id guardado 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.

Qué sigue

Seguridad.

Ver esta página en Markdown

En esta página