- Pautas de integración
- Características soportadas (métodos de pago)
- Emparejamiento de 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. Una vez que un pagador consiente el emparejamiento, usted puede recuperar datos de pago no confidenciales previos a la finalización del pago almacenados en la billetera del pagador y presentarlos al pagador durante dicha finalización. Los datos incluyen:
- Tarjetas en la billetera (sin el número de tarjeta real).
- Direcciones de envío.
- Información del cliente.
- Datos de recompensas (actualmente no se admite en Mastercard Gateway)
El emparejamiento se facilita por medio de un Long Access Token (LAT), un token de uso único, que proporciona el motor de pagos para las cuentas emparejadas de Masterpass. Cada vez que se realiza una llamada mediante LAT, se le enviará de vuelta un nuevo LAT. Este nuevo LAT, entonces, se debe almacenar para usarse la próxima vez.
Puede ofrecer Masterpass Connected Checkout al pagador en su sitio o aplicación durante el pago o fuera de un pago.
Puede solicitar el consentimiento de emparejamiento del pagador fuera de una experiencia de pago (por ejemplo, durante el registro o la administración de cuenta). El proceso de emparejamiento se inicia cuando un pagador hace clic en el botón 'Conectarse con Masterpass' en su sitio o aplicación.
<script src="https://masterpass.com/lightbox/Switch/integration/MasterPass.client.js"></script>
<script type="text/javascript">
// INITIALIZE and INVOKE THE MASTERPASS LIGHTBOX FOR STANDALONE PAIRING
MasterPass.client.connect({
"requestedDataTypes": "[ADDRESS, PROFILE,CARD]",
"requestPairing: "true",
"version":"v6",
"successCallback": onSuccessfulCheckout,
"cancelCallback": onCancel,
"failureCallback": onFailure,
// USE PARAMETERS FROM THE OPEN WALLET RESPONSE
"requestToken": "<wallet.masterpass.requestToken>",
"pairingToken": "<wallet.masterpass.pairingRequestToken>",
"merchantCheckoutId": "<wallet.masterpass.merchantCheckoutId>"
});
// 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;
document.getElementById('pairingToken').value=data.pairing_token;
document.getElementById('pairingVerifier').value=data.pairing_verifier;
}
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
Pair With Walletmedianteorder.walletProvider=MASTERPASS_ONLINE - Proporcione el
wallet.masterpass.pairingRequestTokendevuelto en la respuesta dePair With Walletpara invocar el Masterpass Lightbox (usando el métodoMasterPass.client.connect( )).
El Masterpass Lightbox presentará la oferta de emparejamiento al pagador. Si el pagador consiente, se establece el emparejamiento y se pueden recuperar los datos previos al pago del pagador cuando este vuelve a su sitio o aplicación para un pago.
Puede solicitar el consentimiento para emparejar desde el pagador durante una interacción de pago con Masterpass. El proceso de emparejamiento se inicia cuando un pagador hace clic en el botón "Buy with Masterpass" en su sitio o aplicación.
<script src="https://masterpass.com/lightbox/Switch/integration/MasterPass.client.js"></script>
<script type="text/javascript">
// INITIALIZE AND INVOKE THE MASTERPASS LIGHTBOX FOR CHECKOUT AND PAIRING
MasterPass.client.checkout({
"requestedDataTypes": "[ADDRESS, PROFILE,CARD]",
"requestPairing: "true",
"version":"v6",
"successCallback": onSuccessfulCheckout,
"cancelCallback": onCancel,
"failureCallback": onFailure,
// USE PARAMETERS FROM THE OPEN WALLET RESPONSE
"requestToken": "<wallet.masterpass.requestToken>",
"pairingToken": "<wallet.masterpass.pairingRequestToken>",
"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;
document.getElementById('pairingToken').value=data.pairing_token;
document.getElementById('pairingVerifier').value=data.pairing_verifier;
}
function onCancel() {
// do something to tell you the cardholder cancelled
}
function onFailure() {
// do something to tell you things have gone wrong
}
</script>
- Realice operaciones
Pair With WalletyOpen Walletmedianteorder.walletProvider=MASTERPASS_ONLINE - Use los parámetros de sus respuestas (específicamente
wallet.masterpass.pairingRequestTokendePair With Wallet) para invocar el Masterpass Lightbox.
Se mostrará la interacción Masterpass Standard Checkout al pagador. Después de que el pagador ha seleccionado los detalles de pago, se le presentará la oferta de emparejamiento. Si el pagador consiente, se establece el emparejamiento y se pueden recuperar los datos previos al pago del pagador cuando este vuelve a su sitio o aplicación para un pago.
Referencia de API de Pair With Wallet [REST][NVP]
requestExpressCheckout en true al invocar el Masterpass Lightbox.Cuando el Masterpass Lightbox se cierra y devuelve el control al sitio de su tienda, puede obtener el resultado de su solicitud de emparejamiento usando los datos de la devolución de llamada. Para obtener más información sobre cómo administrar las devoluciones de llamada, consulte Documentación de Masterpass.
- Recupere los siguientes parámetros de la URL de retorno de llamada o del método de devolución de llamada exitoso (se devuelve únicamente si el emparejamiento fue satisfactorio):
wallet.masterpass.pairingTokenwallet.masterpass.pairingVerifier
- Realice una operación
Retrieve Wallet Pairing Resultmediante los parámetros recuperados de la URL de retorno de llamada. Esto devolverá un Long Access Token (LAT) enwallet.masterpass.longAccessToken.
Usted debe guardar esto para la próxima interacción de Masterpass Connected Checkout con este pagador. El LAT se consume después de cada interacción y usted debe guardar el nuevo antes de cada interacción posterior.
Referencia de API de Retrieve Wallet Pairing Result [REST][NVP]
Un pagador puede desemparejar su billetera Masterpass de su cuenta en el sitio o aplicación de su tienda en cualquier momento, mediante la administración de cuenta Masterpass. Esto evitará que usted obtenga acceso a la información de la billetera del pagador; sin embargo, puede solicitar el emparejamiento nuevamente.
Experiencia de pago de Masterpass mediante emparejamiento
Masterpass ofrece dos experiencias de pago a los pagadores mediante una billetera emparejada.
Masterpass Connected Checkout le permite proporcionar una experiencia de pago personalizada y sin problemas a su pagador. Los pagadores que han emparejado su billetera con usted tienen datos de pago no confidenciales previos a la finalización del pago disponibles para selección antes del pago sin que el pagador tenga que iniciar sesión en su billetera Masterpass. El pagador puede completar su pago con solo ingresar la contraseña de billetera en Masterpass.
<script src="https://masterpass.com/lightbox/Switch/integration/MasterPass.client.js"></script>
<script type="text/javascript">
// INITIALIZE AND INVOKE THE MASTERPASS LIGHTBOX DURING CONNECTED CHECKOUT
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>",
"cardId": "<wallet.masterpass.precheckoutData.card.masterpassCardId>",
"shippingId": "<wallet.masterpass.precheckoutData.shippingAddress[<index of selected shipping address>].address.masterpassShippingId>",
"precheckoutTransactionId": "<wallet.masterpass.precheckoutData.precheckoutTransactionId>",
"walletName": "<wallet.masterpass.precheckoutData.walletName>",
"consumerWalletId": "<wallet.masterpass.precheckoutData.consumerWalletId>"
});
// 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:
wallet.masterpass.originUrl: La URL de la página que invocó Masterpass Lightbox.order.amount: el monto del pedido.order.currency: la moneda en la que se está pagando el pedido.
- Un pagador con una billetera emparejada inicia sesión en el sitio/aplicación de su tienda. Antes de presentar la interfaz de pago, realice una operación
Retrieve Wallet Optionspara obtener los datos de la billetera del pagador para mostrarlos en su página de pago. Use el Long Access Token (LAT) más reciente que proporciona el motor de pagos para la cuenta emparejada de Masterpass en la operación.
La respuesta de
Retrieve Wallet Optionsincluye un nuevo LAT enwallet.masterpass.longAccessToken. Usted debe guardar esto para la próxima interacción.
- Consulte la biblioteca de cliente JavaScript de
MasterPass.client.jsen su página de pago.- Para las pruebas:
https://sandbox.masterpass.com/lightbox/Switch/integration/MasterPass.client.js. - Para transacciones en vivo:
https://masterpass.com/lightbox/Switch/integration/MasterPass.client.js.
- Para las pruebas:
-
Después de la experiencia de compra, presente al pagador una interfaz que le permita seleccionar sus opciones de pago y de envío recuperadas de la billetera. Cuando el pagador haga clic en BUY WITH Masterpass, invoque el Masterpass Lightbox mediante los siguientes parámetros desde la respuesta de
Open Wallet.wallet.masterpass.requestTokenwallet.masterpass.merchantCheckoutIdwallet.masterpass.precheckoutData.card.masterpassCardIdwallet.masterpass.precheckoutData.shippingAddress[<index of selected shipping address>].address.masterpassShippingIdwallet.masterpass.precheckoutData.precheckoutTransactionIdwallet.masterpass.precheckoutData.walletNamewallet.masterpass.precheckoutData.consumerWalletId
Debe proporcionar una URL de retorno de llamada o métodos de devolución de llamada para administrar la respuesta de la interacción del 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 retorno 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. - 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.
Masterpass Express Checkout ofrece la misma experiencia de pago que Masterpass Connnected Checkout, pero más rápida. Los pagadores que han emparejado su billetera con usted pueden completar su pago sin iniciar sesión en su billetera Masterpass.
- Realice una operación de
Create Sessionpara obtener un ID de sesión. - Realice una operación
Retrieve Wallet Optionspara obtener los datos de billetera del pagador que aparecerán en su página de pago. Use el Long Access Token (LAT) más reciente que proporciona el motor de pagos para la cuenta emparejada de Masterpass en la operación.
La respuesta de
Retrieve Wallet Optionsincluye:
- Un nuevo LAT en
wallet.masterpass.longAccessToken. Usted debe guardar esto para la próxima interacción. - Un ID de transacción previo al pago en
wallet.masterpass.precheckoutData.precheckoutTransactionId. Esto identifica los datos de pago recuperados desde la billetera del pagador.
- Un nuevo LAT en
- Un pagador con una billetera emparejada inicia sesión en el sitio/aplicación de su tienda.
- Después de la experiencia de compra, presente al pagador una interfaz que le permita seleccionar sus opciones de pago y de envío recuperadas de la billetera.
- Cuando el pagador haga clic en BUY WITH Masterpass, realice una operación
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(configurado enMASTERPASS_ONLINE)wallet.masterpassExpressCheckout.longAccessTokenwallet.masterpassExpressCheckout.masterpassCardIdwallet.masterpassExpressCheckout.masterpassShippingIdwallet.masterpassExpressCheckout.originUrlwallet.masterpassExpressCheckout.precheckoutTransactionIdwallet.masterpassExpressCheckout.secondaryOriginUrl
Si la interacción se realiza correctamente, la sesión devuelta contendrá los detalles de pago del pagador desde la interacción de Masterpass.
- ID de sesión: el identificador para la sesión de pago según lo ha devuelto la operación
- Si la solicitud de
Update Session From Walletdevuelvewallet.masterpass.payerAuthentication=REQUIRED, deberá invocar la UI de seguridad de tarjeta para realizar una autenticación avanzada (por ejemplo, 3DS) para la transacción. Para obtener información, consulte la sección UI de seguridad de tarjeta.
Una vez completada la autenticación avanzada, realice
Update Session From Walletnuevamente. - 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.