Pasos de integración
Para implementar la solución Hosted Checkout básica en su sistema, siga las instrucciones a continuación.
Prerrequisitos
Antes de implementar una solución Hosted Checkout, verifique con your payment service provider para asegurarse de que cumple con los siguientes prerrequisitos:
- Asegúrese de que tiene una cuenta de negocio y que su perfil del negocio esté habilitado para el servicio de Hosted Checkout.
- Seleccione y configure su método de autenticación API.
- Si desea recibir notificaciones sobre pagos exitosos, habilite el servicio de Notificaciones. Permite que Mastercard Gateway envíe notificaciones por correo electrónico o Webhook y notificaciones por correo electrónico al pagador en su nombre.
Implementación de una solución Hosted Checkout
La solución Hosted Checkout funciona a través de operaciones API (solicitudes y respuestas), que se utilizan, por ejemplo, para iniciar o recuperar información sobre diversas transacciones de pago y almacenar detalles de tarjetas. También necesita la biblioteca Checkout JavaScript para implementar la Hosted Payment Page en su aplicación o página web, cuando se necesita la participación del pagador para recopilar detalles de pago para una transacción.
Puede utilizar todas las operaciones API disponibles para las API del servidor REST. Sin embargo, no necesita las operaciones de API relacionadas con Hosted Session, ya que solo son necesarias para el método de integración relacionado. Para obtener información general sobre cómo realizar solicitudes de API de servidor, consulte Realizar una solicitud de API de servidor.
Las operaciones disponibles para usted se limitan a la capacidad de los adquirentes configurados en su perfil del negocio con el motor de pagos. Si el adquirente no soporta una función en el motor de pagos, el motor de pagos de ese adquirente rechazará cualquier solicitud de operación para ejecutar dicha función.
Cuando se necesita la participación del pagador, cada tarea que realiza con Hosted Checkout consta de los siguientes pasos:
- Establecer una sesión de pago
Solicite una sesión de pago mediante la operación INITIATE CHECKOUT. - Implementar la Hosted Payment Page
Muestre al pagador una página incrustada o una página de pago e inicie el proceso de pago. Opcionalmente, incluya devoluciones de llamada para manejar eventos que ocurren durante la interacción de pago, como que el pagador cancele el pago, que la sesión expire o que redirija al pagador a otro sitio web para finalizar el pago (como cuando se usa PayPal). - Interpreta la respuesta
Recibe los resultados del pago desde el motor de pagos y actualiza tu sistema con los detalles del pago. Devuelva al pagador a su sitio web y muéstrele el recibo de pago.
Para obtener una colección de solicitudes de ejemplo que cubren las solicitudes de operación de transacción comunes, descargue la colección de Postman.
Una vez completada la integración, podrá gestionar la transacción inicial con el pagador utilizando Hosted Payment Page para proporcionar sus detalles de pago y autorización:
- Determine las personalizaciones que debe realizar según los métodos de pago específicos que desea admitir en la Hosted Payment Page.
- Defina cualquier personalización que desee utilizar en la Hosted Payment Page UI.
- Considere qué tipo de seguridad u otras funciones adicionales quiere ofrecer o utilizar en su integración.
- Implemente cualquier transacción posterior que desee iniciar desde su servidor backend, como CAPTURE o REFUND.
- Pruebe toda su solución.
Preguntas frecuentes
¿Son compatibles los exploradores de Microsoft con Hosted Checkout?
Sí, se admiten las versiones 113 y posteriores de Microsoft Edge.
¿Qué tan segura es la integración de Hosted Checkout?
El modelo de Hosted Checkout es seguro, ya que requiere que usted se autentique en el motor de pagos, y los detalles de pago recopilados en la Hosted Payment Page se envían directamente del explorador del pagador al motor de pagos.
¿Cómo puedo optimizar mis interacciones móviles con Hosted Checkout?
Si desea ofrecer a sus clientes una buena experiencia móvil para Hosted Checkout, agregue una metaetiqueta llamada viewport
a la página de su sitio.
<meta name="viewport" content="width=device-width, initial-scale=1">
Defina los valores de ventana gráfica correctos para sus páginas y pruebe su propio sitio con ellos.