Partner / Rail API

Pre autorización de ingresos (bancos)

Este bloque no es para empresas usuarias: lo consume el banco del riel (hoy Credicomer sobre Transfer365) antes de acreditar una transferencia entrante hacia una cuenta virtual. Conecta valida en línea la cuenta, la empresa, los montos, los límites operativos, las reglas de fraude y el veredicto AML, y responde APPROVED, REVIEW o REJECTED. La decisión reserva la operación por 30 minutos; el banco confirma o cancela después.

Autenticación de cada llamada

Ciclo de vida de una reserva

Cada llamada va firmada. El banco envía x-conecta-key-id, x-conecta-timestamp (segundos, desfase máximo 5 minutos) y x-conecta-signature, que es el HMAC-SHA256 en hexadecimal de timestamp.MÉTODO.ruta.cuerpo con el secreto compartido. Cuando el banco habilite certificados, se suma mTLS sin cambiar el contrato. La referencia bank_reference es la llave de idempotencia: repetir la misma llamada devuelve la misma decisión, nunca una segunda reserva.

Reintentos seguros. Ante un timeout o una respuesta perdida, reintentá la misma llamada tal cual. Enviá además x-conecta-correlation-id (o correlation_id en el cuerpo) con un identificador propio y estable de la operación: Conecta lo usa como segunda llave de idempotencia y lo devuelve en cada respuesta. Una repetición llega con "replayed": true y exactamente la misma decisión y el mismo auth_id. La confirmación se toma de forma exclusiva: si dos reintentos llegan a la vez, uno acredita y el otro recibe 409 DUPLICATE_REQUEST para reintentar más tarde; nunca se acredita dos veces. Si la acreditación falla internamente, la reserva queda liberada y el reintento vuelve a intentarlo. Cancelar dos veces devuelve la misma respuesta; cancelar algo ya confirmado responde 409 ALREADY_SETTLED.

Si CORSA no responde, la operación se aprueba con AML_UNAVAILABLE_REVIEW y queda marcada para revisión manual en el Portal. Un bloqueo explícito de listas sí rechaza.