Interpretar la respuesta
Una vez que el pagador haya completado su interacción con la Hosted Payment Page, debe redirigirlo a su sitio web, determinar el resultado del pago y presentarle un recibo.
Paso 1: Redirigir al pagador a su sitio web
Una vez que el pagador finaliza su Hosted Payment Page interacción, regresa a su sitio web. Para lograr esto, debe proporcionar la URL a la que se les redirige de una de las siguientes maneras:
- Proporcione el campo interaction.returnUrl en la operación Initiate Checkout.
- Defina la devolución de llamada completa para la Hosted Payment Page. Para obtener más información, consulte Implementación de devoluciones de llamadas.
Paso 2: Determinar el resultado del pago
EL motor de pagos envía el resultado del pago en un campo resultIndicator de una de dos maneras, dependiendo de cómo el pagador fue redirigido a su sitio:
- Se adjunta a la URL (interaction.returnUrl) utilizada para devolver al pagador a su sitio web.
- Proporcionado como parámetro de entrada a la función proporcionada en la devolución de llamada completa o agregado a la URL proporcionada en la devolución de llamada completa.
Puede determinar el éxito del pago comparando el parámetro resultIndicator con el parámetro successIndicator devuelto en la respuesta de INITIATE CHECKOUT. Una coincidencia indica que el pago se realizó correctamente.
Paso 3: Mostrar un recibo de pago
Si la operación fue exitosa, muestre un recibo de pago al pagador en su sitio web y actualice su sistema con los detalles del pago. Puede recuperar los datos de pago de varias formas:
- Con una solicitud de API: utilice la operación Retrieve Order.
- Desde Merchant Administration: los detalles de pago se registran en Merchant Administration, en la página Detalles de pedido y transacción. Podrás buscar el pago y realizar operaciones posteriores.
- Usando Reporting: si su perfil del negocio tiene la función Reporting habilitada, puede descargar datos de pago en un reporte formateado desde el motor de pagos.
- Desde notificaciones por correo electrónico o Webhook: si se suscribe a notificaciones en Merchant Administration, recibirá una notificación por correo electrónico o Webhook por cada pago exitoso.
Dedique algún tiempo a examinar los campos de respuesta de transacción para cada operación relevante en la Referencia de API. Todos los campos proporcionan información valiosa, puede almacenar algunos de ellos localmente por motivos de contabilidad, conciliación y trazabilidad. Cuanto más compleja sea su integración, más útil puede resultar estudiar códigos de respuesta específicos para identificar todos los aspectos del estado de la transacción.