Masterpass
Masterpass es un servicio que permite a los pagadores almacenar, administrar y compartir de manera segura su información de pago, de envío e información de dirección de facturación, con las páginas web y aplicaciones móviles con las que realice transacciones. Esto es útil si desea mejorar la experiencia de pago para el pagador y además reducir los costos de cumplimiento de PCI, ya que el proveedor de billeteras asegura y protege la información del pagador.
Prerrequisitos
Para usar Masterpass a través de Mastercard Gateway, su proveedor de servicios de pago debe tener incorporado el perfil del negocio suyo en Masterpass. Una vez que se haya incorporado satisfactoriamente, se le emitirá un Identificador de finalización de pedido, que su proveedor de servicios de pago usa para habilitarlo y configurarlo para Masterpass.
Masterpass Standard Checkout
Masterpass Standard Checkout permite al pagador interactuar con su billetera digital Masterpass sin tener que salir de su página web. La interacción se realiza en un Lightbox que aparece en la parte superior de su página de pago.
En el siguiente diagrama aparece una muestra del flujo de pago para el sitio de su tienda y Masterpass.
- Un pagador explora el sitio de la tienda, selecciona uno o más productos y hace clic en COMPRA CON Masterpass en la página de pagos.
- En el Masterpass Lightbox, que aparece en la parte superior del sitio de la tienda, el pagador:
- Inicia sesión en su billetera de Masterpass.
- Selecciona una tarjeta de pago.
- Selecciona una dirección de envío o agrega una nueva.
- Hace clic en un botón para confirmar su elección y cierra Masterpass Lightbox.
- En el sitio de su tienda, el pagador finaliza la compra y usted muestra el resumen/recibo del pedido.
Solicite una interacción de Masterpass Standard Checkout
Si tiene una integración de Hosted Checkout existente, Masterpass estará disponible en forma automática una vez que active el servicio correctamente.
Si desea tener un control total sobre la interacción de Masterpass Lightbox en su página de pago, puede seleccionar esta opción para invocar Lightbox usted mismo.
<script src="https://masterpass.com/lightbox/Switch/integration/MasterPass.client.js"></script>
<script type="text/javascript">
// INITIALIZE and INVOKE THE MASTERPASS LIGHTBOX
MasterPass.client.checkout({
"version":"v6",
"successCallback": onSuccessfulCheckout,
"cancelCallback": onCancel,
"failureCallback": onFailure,
// USE PARAMETERS FROM THE OPEN WALLET RESPONSE
"requestToken": "<wallet.masterpass.requestToken>",
"merchantCheckoutId": "<wallet.masterpass.merchantCheckoutId>",
"allowedCardTypes": "<wallet.masterpass.allowedCardTypes>"
});
// RETRIEVE PARAMETERS FROM THE LIGHTBOX INTERACTION
function onSuccessfulCheckout(data) {
document.getElementById('oauthToken').value=data.oauth_token;
document.getElementById('oauthVerifier').value=data.oauth_verifier;
document.getElementById('checkoutUrl').value=data.checkout_resource_url;
}
function onCancel() {
// do something to tell you the cardholder cancelled
}
function onFailure() {
// do something to tell you things have gone wrong
}
</script>
- Realice una operación de
Create Sessionpara obtener un ID de sesión. - Use el ID de sesión de la respuesta de
Create Sessionen una operación deOpen Walletpara obtener los datos necesarios para invocar el Masterpass Lightbox. Deberá proporcionarle lo siguiente en la operaciónOpen Wallet:
order.walletProvider: configure esto enMASTERPASS_ONLINE.order.amount: el monto del pedido.order.currency: la moneda en la que se está pagando el pedido.wallet.masterpass.originUrl: la URL de la página que invocó el Masterpass Lightbox.
- Consulte la biblioteca de cliente JavaScript de
MasterPass.client.jsen su página de pago.- Para prueba:
https://sandbox.masterpass.com/lightbox/Switch/integration/MasterPass.client.js. - Para transacciones en producción:
https://masterpass.com/lightbox/Switch/integration/MasterPass.client.js.
- Para prueba:
-
Cuando el pagador haga clic en COMPRA CON Masterpass, invoque Masterpass Lightbox mediante los siguientes parámetros desde la respuesta de
Open Wallet.wallet.masterpass.requestTokenwallet.masterpass.merchantCheckoutIdwallet.masterpass.allowedCardTypes
Debe proporcionar una URL de devolución de llamada o métodos de devolución de llamada para administrar la respuesta de la interacción de Masterpass Lightbox. Para obtener más información sobre cómo administrar las devoluciones de llamada, consulte Documentación de Masterpass.
-
Recupere los siguientes parámetros (devueltos únicamente si la interacción de Masterpass Lightbox fue satisfactoria) desde la URL de devolución de llamada o un método de devolución de llamada correcto, y páselos a su servidor web.
oauth_tokenoauth_verifiercheckout_resource_url
- Realice una operación de
Update Session From Walletpara obtener los detalles de pago y envío del pagador desde Masterpass. Deberá proporcionar los siguientes parámetros en esta operación.
- ID de sesión: el identificador para la sesión de pago según lo ha devuelto la operación
Create Session. order.walletProvider: configure esto enMASTERPASS_ONLINE.wallet.masterpass.oauthToken: eloauth_tokenrecuperado de la devolución de llamada.wallet.masterpass.oauthVerifier: eloauth_verifierrecuperado de la devolución de llamada.wallet.masterpass.checkoutUrl: elcheckout_resource_urlrecuperado de la devolución de llamada.
Si la interacción se realiza correctamente, la sesión devuelta contendrá los detalles de pago del pagador desde la interacción de Masterpass.
Si la interacción del pagador Masterpass incluye una autenticación 3-D Secure, entonces los resultados de autenticación DS se agregan a la sesión y se devuelven en la respuestaUpdate Session From Wallet. Consulte Pago avanzado.Referencia de la API de Actualizar sesión desde billetera [REST][NVP]
- ID de sesión: el identificador para la sesión de pago según lo ha devuelto la operación
- Use la sesión devuelta para presentar una página de confirmación de pedido o envíe un pago al Mastercard Gateway. Consulte Realizar una operación con la sesión.
Requisitos de Marca Masterpass para el sitio de la tienda
Debe cumplir con los requisitos de marca de la interfaz de usuario de Masterpass cuando lo presente como opción a los pagadores en su sitio web. Para obtener guías acerca de cómo presentar los elementos de interfaz de usuario en sus páginas de pago, consulte Marca Masterpass.
Emparejamiento de Masterpass
El emparejamiento de Masterpass es el proceso de vincular la cuenta de la Billetera Masterpass de un pagador con la cuenta de este en el sitio o aplicación de su tienda. Para obtener más información, consulte Emparejamiento de Masterpass.
Pago avanzado
Si configuró servicios de autenticación de pagador de Pago avanzado con Masterpass, entonces la MPI de Masterpass facilitará la autenticación 3-D Secure (3DS).
Los resultados de la autenticación 3DS se agregarán a la sesión y volverán en la respuesta Update Session From Wallet. Se recomienda que su integración verifique los resultados 3DS en la sesión antes de proceder a enviar el pago al Mastercard Gateway.
Prueba de su integración
Si su ID de negocio tiene el prefijo "TEST", las solicitudes se dirigen al Sandbox de Masterpass.
Para propósitos de prueba, asegúrese de que las referencias a la biblioteca MasterPass.client.js estén configuradas en https://sandbox.masterpass.com/lightbox/Switch/integration/MasterPass.client.js.
Para realizar una prueba completa de su integración con Masterpass, incluida la interacción con 3DS, agregue las siguientes tarjetas de prueba a la billetera de su pagador en el Sandbox de Masterpass. Puede proporcionar cualquier fecha de vencimiento o CSC.
| Tarjetas de prueba | Número de tarjeta | Inscritas 3D Secure |
|---|---|---|
Mastercard |
5506900140100305 | Y |
| 5506900140100107 | Y | |
| 5506900140100503 | N | |
Visa |
4440000009900010 | Y |
| 4440000042200014 | Y | |
| 4440000042200022 | N | |
American Express |
340000099900036 | Y |
| 340000099900028 | Y | |
| 340000099900044 | Y | |
| 340000099900051 | N | |
Diners Club |
30599900026332 | Y |
| 30599900026340 | N | |
| Discover | 6011100099900534 | - |
| 6011100099900013 | - |
Preguntas frecuentes
Si la billetera Masterpass del pagador no está emparejada con su negocio, Mastercard Gateway recupera los tipos de tarjetas compatibles de su configuración de negocio y se asegura de que solo este tipo de tarjetas estén disponibles para seleccionarse en Masterpass.
Si la billetera Masterpass del pagador está emparejada con su negocio, los tipos de tarjetas se recuperan de la billetera Masterpass del pagador.