Consideraciones para métodos con Redirect

Aspectos comunes para CARD cuando usa Redirect, Cuotéalo y transferencia bancaria.

Esta guía reúne las consideraciones comunes para los flujos donde la autorización continúa fuera de tu checkout y luego retorna al comercio mediante un form post.

---

Métodos que aplican

CARD con Redirect

Aplica cuando la autorización de tarjeta requiere continuar fuera de la sesión inicial.

Transferencia Bancaria

El usuario continúa el pago fuera del checkout y luego retorna al comercio.

Cuotéalo

La operación continúa en una experiencia externa de pago en cuotas.

---

Flujo general

1. Inicia la autorización

   Envía el POST /charges con el método de pago correspondiente.

2. Carga la URL entregada

   Cuando la respuesta incluya la URL de continuación del flujo, cárgala para que el usuario pueda seguir con el pago.

3. Recibe el retorno al comercio

   Cuando el usuario finalice la autorización, el orquestador redirigirá hacia la redirect_url enviada en el request.

4. Procesa el form post

   El retorno se realiza en formato form post e incluye los campos authorization_result y signature.

5. Valida la autenticidad

   Decodifica authorization_result y valida signature antes de confiar en el contenido.

6. Confirma desde backend

   Usa Notificaciones o Consulta como confirmación final del estado.

---

Campos enviados al redirect_url

Campo	Descripción
authorization_result	Contendrá un json-string en base64 con el resultado de la autorización.
signature	Contendrá una firma para validar que el json de respuesta es auténtico.

---

Parámetros del authorization_result

Campo	Descripción	Ejemplo	Tipo	Obligatorio
success	Indica si el proceso se realizó correctamente	true	String	SI
merchant_code	Identificador del comercio	your_merchant_code	String	SI
merchant_operation_number	Número de pedido de la operación	2391645	String	SI
transaction	Objeto con información de la transacción	Object	Object	SI
meta	Objeto que contiene metadatos del flujo ejecutado	Object	Object	SI

---

Objeto authorization_result.transaction

Campo	Descripción	Ejemplo	Tipo	Obligatorio
transaction_id	Identificador de la transacción	5hk8rwa3h3cq9oyfs3a28v1ms	String	SI
state	Estado de la transacción	AUTORIZADO	String	SI
currency	Código de la moneda autorizada	604	String	SI
amount	Monto autorizado en centavos	15000	String	SI
processor_response	Resultado detallado del procesamiento. Este objeto puede variar según el método de pago.	Object	Object	NO

processor_response es variable y puede modificarse en el tiempo. Tómalo como referencial y complementa la integración con la documentación específica del método.

---

Objeto authorization_result.meta.status

Campo	Descripción	Ejemplo	Tipo	Obligatorio
code	Código que representa el resultado del flujo ejecutado	00	String	SI
message_ilgn	Mensajes resultantes del flujo	Array	Object	SI

---

Objeto authorization_result.meta.status.message_ilgn[]

Campo	Descripción	Ejemplo	Tipo	Obligatorio
locale	Localidad a nivel de lenguaje para el mensaje del flujo ejecutado	es_PE	String	SI
value	Mensaje resultante del flujo ejecutado	Procesado correctamente	String	SI

---

Recomendaciones

No cambies el estado de la orden únicamente por el retorno del navegador. La fuente final de verdad debe ser backend.

Valida siempre signature antes de procesar authorization_result.

Maneja explícitamente escenarios donde el usuario regresa sin completar el pago o abandona el flujo.

Si no recibes confirmación S2S, realiza consulta activa con intervalos razonables.

---

Siguiente paso

API de Consulta

Complementa los métodos con redirect usando consulta y reconciliación.