Integration Types
Otras características
Card Payments
Mobile Wallets
Alternative Payment Methods
Resources
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.
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 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.
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>
Create Session
para obtener un ID de sesión.
Create Session
en una operación de Open Wallet
para obtener los datos necesarios para invocar el Masterpass Lightbox. Deberá proporcionarle lo siguiente en la operación Open Wallet
:order.walletProvider
: configure esto en MASTERPASS_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.MasterPass.client.js
en su página de pago.
https://sandbox.masterpass.com/lightbox/Switch/integration/MasterPass.client.js
.https://masterpass.com/lightbox/Switch/integration/MasterPass.client.js
.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.requestToken
wallet.masterpass.merchantCheckoutId
wallet.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_token
oauth_verifier
checkout_resource_url
Update Session From Wallet
para obtener los detalles de pago y envío del pagador desde Masterpass. Deberá proporcionar los siguientes parámetros en esta operación. Create Session
.order.walletProvider
: configure esto en MASTERPASS_ONLINE
.wallet.masterpass.oauthToken
: el oauth_token
recuperado de la devolución de llamada.wallet.masterpass.oauthVerifier
: el oauth_verifier
recuperado de la devolución de llamada.wallet.masterpass.checkoutUrl
: el checkout_resource_url
recuperado 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.
Update Session From Wallet
. Consulte Pago avanzado.Referencia de la API de Actualizar sesión desde billetera [REST][NVP]
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.
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.
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.
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 | - |
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.