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 Copied to Clipboard

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 Copied to Clipboard

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.

Flujo de Masterpass Standard Checkout

En el siguiente diagrama aparece una muestra del flujo de pago para el sitio de su tienda y Masterpass.

  1. 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.
  2. 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.
  3. 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 Copied to Clipboard

Masterpass mediante Hosted 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 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.
Masterpass mediante Direct Payment

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.

El modelo Masterpass Standard Checkout es compatible con API en versiones 31 y posteriores. Si usted usa API versión 18-30, debe usar la integración de redirección de Masterpass.
Código JavaScript de muestra para invocar el Masterpass Lightbox

<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>
No invoque ninguna operación de API directamente desde el explorador.
En su Servidor web: Cree una sesión e inicie una interacción de billetera
  1. Realice una operación de Create Session para obtener un ID de sesión.

    Referencia de API de Create Session[REST][NVP]

  2. Use el ID de sesión de la respuesta de 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.

    Referencia de API de Open Wallet [REST][NVP]

En su página de pago: inicialice e invoque el Masterpass Lightbox.
  1. Consulte la biblioteca de cliente JavaScript de MasterPass.client.js en su página de pago.
  2. 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.

  3. 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
En su Servidor web: recopile detalles de pago en una sesión
  1. Realice una operación de 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.

    • 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 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.

    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 respuesta Update Session From Wallet. Consulte Pago avanzado.

    Referencia de la API de Actualizar sesión desde billetera [REST][NVP]

  2. 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 Copied to Clipboard

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 Copied to Clipboard

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 Copied to Clipboard

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.

Se puede optar por 3DS únicamente para Mastercard, Maestro y Visa.

Prueba de su integración Copied to Clipboard

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.

Detalles
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 Copied to Clipboard

¿Cómo me aseguro de que los pagadores puedan seleccionar solo entre los tipos de tarjetas que mi perfil del negocio admite?

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.