Saltar al contenido principal

Empezar

Todas las APIs de FINORA comparten las mismas reglas de base. Conocerlas te ahorra trabajo en cada integración.

Lo que comparten​

  • HTTPS y JSON en todas las APIs públicas.
  • Credenciales por sistema, nunca por persona: cada integración tiene su propia credencial, con el menor alcance posible.
  • Idempotencia: toda escritura acepta o exige la cabecera Idempotency-Key. Reintenta siempre con la misma clave.
  • Errores legibles por programa: las respuestas de error siguen Problem Details (RFC 7807 o RFC 9457) e incluyen un codigo estable. Decide por el código, nunca por el texto.
  • Webhooks firmados: los avisos llevan la cabecera X-Finora-Signature con una marca de tiempo (t) y una firma HMAC-SHA256 (v1). Verifícala sobre el cuerpo crudo y en tiempo constante.

Pasos​

  1. Solicita tus credenciales de sandbox para la API que vas a integrar.
  2. Revisa la autenticación que usa esa API.
  3. Prueba todos los caminos en el sandbox, incluidos los rechazos y los resultados en duda.