Autorizador JSON
Estado: Próximamente
Beta privada en preparación: el servicio está construido y probado, pero todavía no hay sandbox ni servidor público. Esta documentación se publica para que puedas diseñar tu integración. La vista ISO por data element solo se habilita bajo acuerdo.
El Autorizador JSON permite a adquirentes, fintechs, comercios grandes y procesadores autorizar tarjetas emitidas en FINORA (solo on-us en v1) por HTTPS y JSON. El servicio traduce cada petición al mensaje ISO 8583 del emisor, asigna los identificadores de red (terminal, STAN, RRN y fecha de transmisión) y los persiste antes de enviar: tú nunca armas ni numeras mensajes ISO.
Qué puedes hacer
| Operación | Ruta | Estado |
|---|---|---|
| Autorizar una compra, una preautorización o una consulta de saldo | POST /v1/authorizations | Próximamente |
| Consultar una autorización por id o por tu clave | GET /v1/authorizations/{id}, GET /v1/authorizations?idempotencyKey=… | Próximamente |
| Reversar | POST /v1/authorizations/{id}/reversals | Próximamente |
| Devolver una compra | POST /v1/authorizations/{id}/refunds | Próximamente (requiere el medio TOKEN) |
| Capturar una preautorización | POST /v1/authorizations/{id}/captures | Próximamente |
| Vista por data element | POST /v1/iso/messages | Solo bajo acuerdo |
Guías
- Autenticación: mTLS, firma JWS detached, fecha, nonce y lista de IP.
- Diccionario ISO 8583: qué campo JSON llena cada data element.
- Flujos: compra, preautorización, reverso y devolución.
- Idempotencia y plazos: reintentar sin doble cargo y qué hacer con una
INDETERMINADA. - Códigos y errores: DE 39 publicado y errores HTTP.
- Medios, límites y sandbox.
Principios
- Decide por
resultado, nunca por el código de respuesta. - El número de la tarjeta nunca viaja en claro: los medios de v1 son una credencial de billetera FPW1 y, próximamente, un token.
- Ningún reintento genera un segundo envío: misma
Idempotency-Keyy mismo cuerpo devuelven la respuesta guardada. - Importes sin redondeo: el valor llega como texto con exactamente los decimales de la moneda.
Referencia
Consulta la referencia de la API.