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:

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.

No utilice el valor del parámetro resultIndicator como número de recibo.

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.

Es una buena práctica validar si los datos que proporcionó para la transacción son los mismos que los datos utilizados para procesar la transacción. Por ejemplo, verifique que el monto devuelto en la respuesta de la transacción coincida con el valor que envió en la solicitud.