- Pautas de integración
- Características soportadas (métodos de pago)
- Implementación de una integración de pago mediante explorador
Implementación de una integración de pago mediante explorador
Los métodos de pago mediante explorador permiten que un pagador pague por los productos y servicios en línea en el sitio web del proveedor de pago mediante explorador. ANZ eGate payment gateway redirige el explorador del pagador al sitio web del proveedor de pagos mediante explorador, donde el pagador inicia sesión, selecciona los detalles de la tarjeta, revisa el pago y completa la interacción.
ANZ eGate payment gateway admite los siguientes métodos de pago mediante explorador:
Prerrequisitos
Para implementar los pagos mediante explorador a través de ANZ eGate payment gateway, necesita:
- Una cuenta con el proveedor de pago mediante explorador.
- Una página en el sitio de su tienda a la que ANZ eGate payment gateway lleve de vuelta el explorador del pagador al completar la interacción.
Se recomienda que se suscriba al servicio de Notificaciones para recibir notificaciones (correo electrónico) si el pago se realiza correctamente. ANZ eGate payment gateway (en su nombre) también puede enviar notificaciones por correo electrónico al pagador.
Pagos mediante explorador a través de la integración de Hosted Checkout
Si tiene una integración de Hosted Checkout existente, el método de pago mediante explorador estará disponible en forma automática en cuanto ANZ Worldline Payment Solutions haya configurado correctamente su perfil de negocio en ANZ eGate payment gateway, con el vínculo de adquirente para el proveedor de pagos mediante explorador.
El siguiente diagrama ilustra el flujo de pago mediante explorador en un modelo de Hosted Checkout:
- Usted inicia una interacción de Hosted Checkout cuando el pagador está listo para pagar en el sitio de su tienda. El ANZ eGate payment gateway muestra la interfaz de pago elegida por usted: una página Lightbox o una página de pago hospedado.
- Al pagador se le presenta la interfaz de pago, donde se muestra el método de pago mediante explorador como una opción de pago.
- Cuando el pagador selecciona el método de pago mediante explorador, ANZ eGate payment gateway redirige el explorador del pagador al sitio web del proveedor de pagos mediante explorador para que inicie sesión y seleccione los detalles del pago o realice el pago.
- Una vez completada la interacción del pagador en el sitio web del proveedor de pagos mediante explorador, al pagador se le presenta el resultado del pago a través de:
- Recibo hospedado: el resultado del pago se muestra en la página de pago hospedado/Lightbox. Este es el comportamiento predeterminado.
- Recibo en el sitio de su tienda: puede optar por mostrar el resultado del pago al pagador en el sitio de su tienda. Para conocer las pautas de integración, consulte Regresar al pagador al sitio de la tienda.
El pagador también puede obtener el resultado de un pago correcto a través de notificaciones por correo electrónico enviadas por ANZ eGate payment gateway. Usted debe suscribirse a las notificaciones al pagador en Merchant Administration.
Recuperando el resultado de la transacción
Puede utilizar Merchant Administration o realizar una operación Retrieve Order
/Retrieve Transaction
para averiguar si el pago se realizó correctamente o no. Consulte la sección "Cómo interpretar el resultado de la transacción" en la página de integración específica del pago mediante explorador.
También puede averiguar si el pago se realizó correctamente o no a través de su integración (solo si decide regresar al pagador al sitio de su tienda) o mediante el servicio de Notificaciones (correo electrónico).
Pagos mediante explorador a través de la integración de Direct Payment
El siguiente diagrama ilustra el flujo de pago mediante explorador en un modelo de Direct Payment:
Estos son los pasos de integración para un pago mediante explorador a través de la integración de Direct Payment:
Cuando el pagador selecciona el método de pago mediante explorador, realice una operación Initiate Browser Payment
para proporcionar información sobre el pedido y para obtener la URL de redirección del método de pago mediante explorador. Deberá proporcionar lo siguiente en la solicitud de operación Initiate Browser Payment
:
order.amount
: el monto del pedido.order.currency
: la moneda en la que se está pagando el pedido.sourceOfFunds.type
: el método de pago mediante explorador. Por ejemplo, PAYPAL, UNION_PAY.browserPayment.returnUrl
: la URL de retorno es una página en su sitio web. El explorador del pagador se redirige a esta página al completar el pago en el sitio web del proveedor de pagos mediante explorador. Puede que desee incluir información en la URL de retorno para identificar el pedido del pagador en su sitio web.browserPayment.operation
: el tipo de transacción que desea crear cuando el pagador completa la interacción. Tiene dos opciones:
Authorize
: una transacción en la que el pago se autoriza con las fuentes de financiamiento subyacentes del pagador, pero no se captura de forma inmediata.Pay
: una transacción en que el pago se autoriza y, si resulta exitoso, se captura en forma inmediata.
Tenga en cuenta que ANZ eGate payment gateway ignora los privilegios configurados en su cuenta de negocio con ANZ eGate payment gateway.
PayPal y UnionPay SecurePay admiten operaciones Authorize y Pay; los demás métodos de pago mediante explorador (Sofortbanking, giropay, BancaNet) solo admiten Pay.
También puede proporcionar detalles adicionales sobre el pedido, por ejemplo, dirección de facturación, dirección de envío, detalles del cliente, etc.
Utilizar la browserPayment.redirectUrl
proporcionada en la respuesta Initiate Browser Payment
para redirigir el explorador del pagador al sitio web del proveedor de pagos mediante explorador.
Una vez que se haya completado la interacción del pagador en el sitio web del proveedor de pagos mediante explorador, ANZ eGate payment gateway regresa el explorador del pagador al sitio de su tienda, utilizando la browserPayment.returnUrl
proporcionada en la solicitud de Initiate Browser Payment
. El sitio de su tienda debe identificar el pedido a través de la información proporcionada en la URL de retorno.
Si el explorador del pagador no aparece en un plazo razonable, realice una operación Retrieve Transaction
(consulte el Paso 4) para averiguar sobre el estado de la interacción y si el pago se realizó correctamente o no.
Después de haber recibido el explorador del pagador, utilice Retrieve Transaction
para averiguar si el pago se realizó correctamente o no.
La respuesta Retrieve Transaction
puede contener detalles sobre el pedido y, dependiendo del método de pago, puede contener detalles sobre el pagador, según lo devuelto por el proveedor de pagos mediante explorador.
Utilice la información proporcionada para mostrar el resultado de la transacción al pagador. Consulte la sección "Cómo interpretar el resultado de la transacción" en la página de integración específica del pago mediante explorador.
Si la transacción no se realizó correctamente, ejecute nuevamente los pasos del 1 al 4 con el mismo ID de pedido.
Probar una integración de pago mediante explorador
Para obtener más información sobre cómo probar los métodos de pago mediante explorador admitidos, consulte Probar pagos mediante explorador.
Solución de problemas y preguntas frecuentes
Puede hacer seguimiento del progreso de un pago mediante explorador utilizando el campo browserPayment.interaction.status
y los respectivos campos de hora devueltos en la respuesta Retrieve Transaction
/Retrieve Order
.
browserPayment.interaction.status=INITIATED
browserPayment.interaction.timeInitiated
=<the date and time the payment was successfully initiated is set>browserPayment.interaction.status=REDIRECTED_TO_PROVIDER
browserPayment.interaction.timeRedirected
=<the date and time the payer's browser was received from your shop site and redirected to the browser payment provider's website is set>browserPayment.interaction.status=RETURNED_TO_MERCHANT
browserPayment.interaction.timeReturned
=<the date and time the payer's browser was received from the browser payment provider's website and redirected back to your shop site is set>browserPayment.interaction.status=COMPLETED
browserPayment.interaction.timeCompleted
=<the date and time the payment was completed is set>
Estos campos pueden servir para solucionar problemas.