Secure Remote Commerce

Secure Remote Commerce (SRC) es una opción de pago en línea inteligente y sin contraseña, que brinda una experiencia de pago rápida y sencilla para los pagadores. SRC proporciona un botón de pago único (también denominado "Click to Pay") y un flujo de pago estandarizado para todos los esquemas de tarjetas participantes, incluidos Mastercard, Visa, American Express, Discover y otros. SRC se basa en la especificación SRC de EMVCo y reemplaza a Masterpass, Visa Checkout y Amex Express Checkout.

Un pagador puede crear un perfil SRC usando su dirección de correo electrónico. Durante el pago, el pagador debe proporcionar esta dirección de correo electrónico y realizar un paso de verificación adicional con un código de un solo uso. También pueden elegir la opción "Recordarme" para luego omitir la verificación cuando utilice el mismo explorador.

El pagador puede almacenar varias tarjetas de crédito, débito o prepago, las direcciones de facturación asociadas y varias direcciones de envío en su perfil SRC. Los detalles de las tarjetas se almacenan de forma segura y se proporciona seguridad adicional al ofrecer tokenización de red.

SRC permite a su pagador seleccionar los detalles de pago que se utilizarán para el pago; sin embargo, el pago en sí se procesa utilizando el adquirente configurado para su perfil de negocio en el motor de pagos.

SRC es compatible con la página de pago del motor de pagos (Hosted Checkout), o a través de un SDK de JavaScript si está utilizando su propia página de pago.

Actualmente, SRC solo está disponible en un determinado número de países. Compruebe con your payment service provider si está disponible en su país. El Mastercard Payment Gateway admite SRC a partir de API versión 57 y, actualmente, admite SRC para tarjetas Mastercard, Visa y American Express.

Beneficios clave

SRC ofrece los siguientes beneficios:

  • opción de pago rápida y fácil de usar para sus pagadores con riesgo reducido de abandono del pago;
  • tasas de aprobación de autorización más altas si usa tokens de red;
  • disminución del fraude del pagador;
  • intercambio seguro de datos de pago, incluidos los detalles de las tarjetas, los detalles de la dirección de facturación y envío.

Prerrequisitos

Si desea ofrecer SRC como una opción de pago a sus pagadores:

  • Póngase en contacto con your payment service provider para asegurarse de que SRC está disponible para usted.
  • En el menú Admin de Merchant Administration, haga clic en Configuración de SRC y siga las instrucciones para incorporarse a SRC y activar SRC para su perfil del negocio. Para actualizar su configuración de SRC, debe tener los privilegios necesarios.

SRC como opción de pago en Hosted Checkout

Si utiliza la página de pago del motor de pagos (Hosted Checkout), SRC se ofrecerá automáticamente como opción de pago a sus pagadores si ha activado SRC para su perfil del negocio y está utilizando API versión 57 o superior cuando envíe la solicitud Create Checkout Session para iniciar la interacción de Hosted Checkout.

Si bien el perfil SRC de su pagador puede contener tarjetas para cualquier esquema de tarjeta admitido, para una transacción determinada, su pagador solo puede usar SRC para aquellas tarjetas donde:

  • el esquema de tarjeta se ha activado para SRC en su perfil del negocio y
  • su perfil del negocio está configurado para procesar tarjetas con este esquema y la moneda de la transacción.

Dirección de envío: los pagadores no podrán seleccionar una dirección de envío durante la interacción de SRC, ya que actualmente no se admite la recopilación de direcciones de envío por medio de Hosted Checkout.

Dirección de facturación: siempre se recopilará una dirección de facturación durante la interacción de SRC.

Autenticación 3-D Secure: si está configurado para la autenticación 3-D Secure (3DS), Hosted Checkout realizará automáticamente la autenticación 3DS después de la interacción de SRC.

Configurar SRC para Hosted Checkout

Para usar Hosted Checkout, siga los pasos que se indican en Implementación de una integración de Hosted Checkout.

Cuando realice la llamada de Checkout.configure(), incluya los siguientes detalles:

País de interacción Para una interacción de SRC, el país de interacción determina el contenido específico del país que se presenta al pagador durante la interacción de SRC, como los Términos y condiciones.
El valor que configuró con respecto a su perfil del negocio en el motor de pagos se utiliza de forma predeterminada. Agregue el campo interaction.country al método Checkout.configure(), si desea anular este valor para esta interacción.
Configuración regional de interacción Para una interacción de SRC, la configuración regional de la interacción determina el idioma de visualización.
De forma predeterminada, se utiliza el idioma configurado en el explorador del pagador. Si el idioma del pagador no se puede determinar o no es compatible, se utiliza en_US. Si desea anular este valor, agregue el campo interaction.locale al método Checkout.configure(). Actualmente, los idiomas admitidos son inglés (Reino Unido) (en_UK), español (España) (es_ES), francés (Canadá) (fr_CA), portugués (Brasil) (pt_BR) y chino (Hong Kong) (zh_HK).
Nombre del negocio Proporcione su nombre comercial, es decir, el nombre conocido por su pagador. El nombre puede aparecer durante la interacción de SRC.
URL de negocio Proporcione la URL de su sitio web que utiliza el pagador. Por ejemplo, https://example.com. La URL puede mostrarse durante la interacción de SRC.
Correo electrónico del pagador La dirección de correo electrónico del pagador siempre se recopilará durante la interacción de SRC. Si ya conoce la dirección de correo electrónico del pagador, agregue customer.email:<la dirección de correo electrónico de su pagador> al Checkout.configure() para permitir que el pagador omita ingresar su dirección de correo electrónico durante la interacción de SRC.
<html>
    <head>
      <script src="https://evopaymentsmexico.gateway.mastercard.com/static/srci/1.2.0/srci.min.js"
        data-error="errorCallback"
        data-cancel="cancelCallback"></script>
      <script type="text/javascript">
        function errorCallback(error) {
          console.log(JSON.stringify(error));
        }
        function cancelCallback() {
          console.log('Payment cancelled');
        }
   
        Checkout.configure({
          merchant: "<gateway_merchant_ID>",
          session: {
            id: "<session_ID>",
          },
          customer: {
            email: "<payer_email_address>"
          },
          order: {
            amount: "60",
            currency: "USD",
            description: "High level description of the goods contained in the order",
            id: "<your_unique_order_ID>",
          },
          interaction: {
            country: "USA",
            locale: "en_US",
            operation: "AUTHORIZE",
            merchant: {
              name: "<merchant_name>",
              url: "<website_URL>",
              address: {
                line1: "200 Sample St",
                line2: "1234 Example Town"
              }
            }
          }
        });
      </script>
    </head>
    <body>
      ...
      <input
        type="button"
        value="Pay with Lightbox"
        onclick="Checkout.showLightbox();"
      />
      <input
        type="button"
        value="Pay with Payment Page"
        onclick="Checkout.showPaymentPage();"
      />
      ...
    </body>
  </html>

SRC como opción de pago en su página de pago

Si está utilizando su propia página de pago y desea ofrecer SRC como una opción de pago a sus pagadores, use el SDK de JavaScript de SRCI (srci.js) proporcionado por el motor de pagos.

Esta es una integración de JavaScript del lado del cliente que le permite iniciar la interacción de SRC directamente desde el explorador del pagador y asegura que los detalles de pago seleccionados por el pagador durante la interacción de SRC se envíen directamente desde el explorador del pagador al motor de pagos.

Para utilizar el SDK de JavaScript de SRCI, siga los pasos a continuación.

Paso 1: Crear una sesión

Cree una sesión enviando una solicitud Create Session desde su aplicación del lado del servidor. La respuesta devuelve un ID de sesión que debe utilizar en los pasos siguientes para hacer referencia a esta sesión.

Paso 2: Actualizar la sesión con el monto y la moneda del pedido

Actualice la sesión con al menos el monto y la moneda del pedido enviando una solicitud de Update Session desde su aplicación del lado del servidor. Este paso es necesario para consultar posteriormente si SRC está disponible para pagos con esta moneda.

Solicitud de ejemplo
URL https://evopaymentsmexico.gateway.mastercard.com/api/rest/version/72/merchant/<your_merchant_ID>/session/<your_session_ID>
Método HTTP PUT
   
 {
   "order":{
      "amount":100.00,
      "currency":"USD"
   }
}

Paso 3: Incluir el SDK de JavaScript SRCI en su página de pago

Incluya el SDK de JavaScript de SRCI (srci.js) proporcionado por el motor de pagos en su página de pago agregando un elemento de script dentro del elemento head. Al hacerlo se coloca un objeto SRCi en el espacio de nombres de la ventana.

<script type="text/javascript" src="https://evopaymentsmexico.gateway.mastercard.com/static/srci/1.2.0/srci.min.js"></script>

Paso 4: Configurar la interacción de SRC

Al cargar su página de pago, inicie la interacción de SRC invocando el método SRCi.configure().

<html>
    <head>
        <script type="text/javascript" src="https://evopaymentsmexico.gateway.mastercard.com/static/srci/1.2.0/srci.min.js"></script>
        <script type="text/javascript">
          var callback = function (response) {
            if(response.result === "SUCCESS") {
              console.log("Response from SDK: %s", response.restApiResponse);
            } else if(response.result === "ERROR") {
              console.log("An error occurred");
            }
          } 
 
          SRCi.configure(
            "<your_gateway_merchant_ID>",
            "<your_merchant_name>",
            "<your_merchant_URL>",
            "<your_session_ID>", 
            { wsVersion: 57 },
            callback     
          );
        </script>
    </head>
    <body>
     ...
    </body>
</html>

Detalles de negocio

El merchantId es necesario para que el motor de pagos pueda determinar correctamente sus opciones de pago.

Los campos merchantName y merchantUrl se envían al servidor SRC. Estos detalles puede que se muestren al pagador durante la interacción de SRC.

Proporcione su nombre comercial, es decir, el nombre conocido por su pagador y la URL de su sitio web que utiliza el pagador.

Versión

Establezca este valor en 57. Esta es la versión que utilizó al enviar la solicitud Create Session.

Devolución de llamada

Utilice el parámetro callback para definir las acciones que se invocarán después de que SRCi.configure() se haya completado. Por ejemplo, es posible que desee registrar si el método tuvo éxito:

var srciConfigCallback = function (resp) {
	var response = resp.restApiResponse;
	if (response.result === "ERROR") {
		console.error("SRC could not successfully be configured");
	} else if (response.result === "SUCCESS") {
		console.log("SRC was successfully configured");
	}
}

  

La llamada SRCi.configure() puede devolver las siguientes respuestas de error:

response.cause resp.explanation Acción requerida
Error Falta un argumento: Merchant ID, Merchant Name, Merchant URL, Hosted Session ID y una función de devolución de llamada son todos argumentos necesarios para el método configure(). Corrija su integración. Debe proporcionar todos los campos de solicitud obligatorios.
Error Falta un argumento: URL del negocio es un argumento obligatorio para el método configure() Corrija su integración. Debe proporcionar el campo URL del negocio.
Error Devolución de llamada debe ser una función. Corrija su integración.
Error La versión de API debe ser <MIN_VERSION> o superior. Corrija su integración. Configure wsVersion en 57.

Cuando se devuelva un error, no continúe con el siguiente paso. Ofrezca al pagador otro método de pago.

Configuración avanzada

El SDK recupera detalles sobre la configuración de su perfil del negocio para SRC (incluida, por ejemplo, la lista de todos los esquemas para los que SRC está disponible) mediante la operación Payment Options Inquiry. Sin embargo, si previamente ya envió una solicitud de Payment Options Inquiry durante la sesión del pagador, puede pasar estos detalles agregando el elemento configuration a la solicitud.

En este caso, el SDK no vuelve a realizar la solicitud de Payment Options Inquiry. El parámetro wsVersion indica la versión de API que utilizó para enviar la solicitud de Payment Options Inquiry.

Código HTML de ejemplo
<html>
    <head>
        <script type="text/javascript" src="https://evopaymentsmexico.gateway.mastercard.com/static/srci/1.2.0/srci.min.js"></script>
            // Response from the Payment Options Inquiry call. This value to SRCi.configure() is optional. If it is not passed in, a call will be made from the SDK to the API to retrieve it.
          var paymentOptionsInquiryResponse = {
            merchant: "<gateway_merchant_ID>",
            paymentTypes: {
              card: {
                cardTypes: [{
                  cardType: "MASTERCARD",
                  schemeTokenTypes: "CRYPTOGRAM_3DSECURE"
                }, {
                  cardType: "VISA",
                  schemeTokenTypes: "CRYPTOGRAM_3DSECURE"
                }, {
                  cardType: "AMEX",
                  schemeTokenTypes: "DYNAMIC_CSC_AND_EXPIRY"
                }],
                walletProviders: [{
                  secureRemoteCommerce: {
                    defaultPayerCountry: "USA",
                    shippingAddressCountries : "USA,CAN"
                    scheme: [{
                      dpaId: "<DPA_ID>", // As configured for this scheme on your merchant profile.
                      name: "MASTERCARD"
                    }, {
                      dpaId: "<DPA_ID>", // As configured for this scheme on your merchant profile.
                      name: "VISA"
                    }, {
                      name: "AMERICAN_EXPRESS"
                    }]
                  },
                  walletProvider: "SECURE_REMOTE_COMMERCE"
                }]
              }
            },
            result: "SUCCESS"
          }
 
          SRCi.configure({
              "<gateway_merchant_ID>",
               "<merchant_name>",
               "<merchant_URL>",
               "<session_ID>",
               configuration: {
                 wsVersion: 57,
                 paymentOptions: paymentOptionsInquiryResponse
               }, 
               callback: function (response) {
                 if(response.result === "SUCCESS") {
                   console.log("Response from SDK: %s", response.restApiResponse);
                 } else if(response.result === "ERROR") {
                   console.log("An error occurred");
                 }
               }      
            });
        </script>
    </head>
    <body>
     ...
    </body>
</html>

Respuesta de SRCi.configure() de ejemplo

El siguiente ejemplo muestra una llamada de SRCi.configure() con éxito.

{
    result: "SUCCESS"
    restApiResponse: <Payments Options Inquiry response>
   }  

La respuesta contiene la respuesta de Payments Options Inquiry en el campo restApiResponse, que es solo informativo. Sin embargo, es posible que desee utilizar esta información más adelante durante la sesión del pagador, en lugar de utilizar la solicitud de PAYMENT_OPTIONS_INQUIRY para recuperarla.

El siguiente ejemplo muestra una llamada de SRCi.configure() sin éxito.

{
    result: "ERROR"
    cause: <cause>
    explanation: <explanation>
   }  

En este caso, solicite al pagador que seleccione otra opción de pago.

Paso 5: Mostrar SRC como opción de pago

Si SRCi.configure() tuvo éxito, muestre SRC como una opción de pago en su página de pago. Para conocer los requisitos de marca, consulte Pautas de la interfaz de usuario de SRC.

Utilice los detalles de configuración de SRC devueltos en la respuesta de Payment Options Inquiry para determinar qué logotipos de esquema se van a mostrar en el botón. Para cada esquema admitido, la respuesta de Payment Options Inquiry contiene el nombre del esquema en el campo paymentTypes.card.walletProviders[n].secureRemoteCommerce.scheme[n].name.

Paso 6: Iniciar la interfaz de usuario de SRC

Cuando el pagador selecciona SRC como una opción de pago, inicie la interfaz de usuario de SRC invocando el método SRCi.launchUI().

var payloadCallback = function (correlationId, scheme) {
      console.log("Payload callback complete with correlation id %s and scheme %s", correlationId, scheme);
    };
     
    var errorCallback = function (error) {
      console.log("Error callback triggered with error: %s", error);
    };
     
    var cancelCallback = function () {
      console.log("Cancel callback triggered");
    };
     
    SRCi.launchUI({
        orderAmount: "100.00",
        orderCurrency: "USD"
      },
      payloadCallback,
      errorCallback,
      cancelCallback
    );

Además de los campos obligatorios, también puede proporcionar varios campos opcionales:

SRCi.launchUI(
   {
      "orderAmount":"60"
	  "orderCurrency":"USD",
      "customerEmail":"<payer_email_address>",
      "collectShippingAddress":true,
      "interactionCountry":"CAN"
      "interactionLocale":"fr"
   }
);    

Recopilación de la dirección de correo electrónico del pagador

La dirección de correo electrónico del pagador siempre se recopilará durante la interacción de SRC. Si ya conoce la dirección de correo electrónico del pagador, agregue el campo customerEmail al método SRCi.launchUI() para permitir que el pagador omita ingresar su dirección de correo electrónico durante la interacción de SRC.

Recopilación de la dirección de facturación

Siempre se recopilará una dirección de facturación durante la interacción de SRC.

Recopilación de la dirección de envío

De forma predeterminada, SRC no recopilará la dirección de envío del pagador. Si desea que SRC recopile la dirección de envío del pagador, agregue collectShippingAddress:true al método SRCi.launchUI().

De forma predeterminada, el pagador puede seleccionar cualquier país para la dirección de envío. Para restringir la lista de países a los que envía mercancías, debe configurar su perfil del negocio para SRC por medio de Merchant Administration con una lista de países permitidos o una lista de países excluidos. Cuando haya definido alguna restricción, el pagador solo podrá seleccionar un país de dirección de envío permitido.

No puede anular los países de dirección de envío admitidos para una solicitud específica.

País de interacción

El país de interacción determina el contenido específico del país que se presenta al pagador durante la interacción del SRC, como los Términos y condiciones. El valor que configuró con respecto a su perfil del negocio en el motor de pagos se utiliza de forma predeterminada. Agregue el campo interactionCountry al método SRCi.launchUI(), si desea anular este valor para esta interacción.

Configuración regional de interacción

La configuración regional de la interacción determina el idioma que se utiliza durante la interacción de SRC. De forma predeterminada, se utiliza el idioma configurado en el explorador del pagador. Si el idioma del pagador no se puede determinar o no es compatible, se utiliza en_US. Agregue el campo interactionLocale al método SRCi.launchUI(), si desea anular este valor. Actualmente, los idiomas admitidos son inglés (Reino Unido) (en_UK), español (España) (es_ES), francés (Canadá) (fr_CA), portugués (Brasil) (pt_BR) y chino (Hong Kong) (zh_HK).

Devolución de llamada

Debe definir las acciones que se invocarán después de que SRCi.launchUI() se haya completado de la siguiente forma:

payloadCallback La función de devolución de llamada que se activará cuando el pagador haya completado la interacción en la interfaz de usuario de SRC.

Esta función usa dos argumentos, correlationId y scheme
  • El scheme identifica el esquema de tarjeta.
  • El correlationId es un identificador único para la interacción de SRC (para este esquema).

  • Estos detalles deben usarse posteriormente para recuperar los detalles de pago para esta interacción de SRC (consulte el paso 7).
errorCallback La función de devolución de llamada que se activará si se encuentra un error al cargar la interfaz de usuario de SRC. Esta función utiliza un argumento que se completará con un objeto de error que contiene los detalles del error.

Tipo Mensaje de error Acción requerida
Error Falta un argumento: orderAmount o bien orderCurrency Corrija su integración. Debe agregar el monto y la moneda del pedido a la sesión, consulte el paso 2.
Error No hay ningún método de pago de Secure Remote Commerce disponible para la identificación del negocio Corrija su integración. Solo debe mostrar SRC como una opción de pago a su pagador, si SRCi.configure() tuvo éxito.
Error No se completan los datos de respuesta de Payment Options Inquiry Ofrezca otro método de pago al pagador.
Error Formato de correo electrónico no válido Corrija su integración. El campo customerEmail debe contener una dirección de correo electrónico válida.
Advertencia transactionAmount y transactionCurrency cambiaron de nombre y quedarán obsoletos en la próxima versión principal. Considere usar los nuevos nombres orderAmount y orderCurrency en su lugar. Corrija su integración. Utilice los nuevos nombres de campo, es decir orderAmount y orderCurrency.
Advertencia dpaShippingPreference cambió de nombre y quedará obsoleto en la próxima versión principal. Considere usar el nuevo nombre collectShippingAddress en su lugar. Corrija su integración. Utilice el nuevo nombre de campo, es decir collectShippingAddress.
cancelCallback La función de devolución de llamada que se activará cuando el pagador cancele la interacción de SRC o se cierre la interfaz de usuario de SRC. No utiliza ningún argumento.

Paso 7: Actualizar la sesión con los datos de pago de SRC

Una vez que su pagador haya completado con éxito la interacción de SRC, debe solicitar al motor de pagos que recupere los detalles de pago para la interacción de SRC y los almacene en la sesión.

Envíe una solicitud de Update Session From Wallet con:

  • el ID de sesión en la URL de la solicitud; y
  • el correlationId y el esquema como se devuelve en la payloadCallback.
Solicitud de ejemplo
URL https://evopaymentsmexico.gateway.mastercard.com/api/rest/version/72/merchant/<your_merchant_ID>/session/<your_session_ID>
Método HTTP POST
{
   "apiOperation":"UPDATE_SESSION_FROM_WALLET",
   "order":{
      "walletProvider":"SECURE_REMOTE_COMMERCE"
   },
   "wallet":{
      "secureRemoteCommerce":{
         "srcCorrelationId":"<correlationId_provided_in_payloadCallback>",
         "scheme":"<scheme_provided_in_payloadCallback>"
      }
   }
}    

Si la sesión se actualizó correctamente con los detalles de pago de la interacción de SRC, puede continuar. Si la sesión no se actualizó correctamente, pídale a su pagador que seleccione otra opción de pago.

Paso 8: Realizar la autenticación 3-D Secure (opcional)

Si desea autenticar al pagador, ejecute la Autenticación 3D-Secure mediante la sesión. Consulte Implementación de una integración 3DS utilizando la API JavaScript de 3DS para conocer los detalles.

Paso 9: Realizar la operación de pago

Si la sesión se actualizó correctamente con los detalles de pago de la interacción de SRC (y la autenticación 3D-Secure, si se ejecutó en el paso 8), use la sesión para enviar el pago para su procesamiento desde su aplicación del lado del servidor. Por ejemplo, puede enviar una solicitud Authorize. Los detalles de pago almacenados en la sesión de la interacción de SRC se utilizan para procesar el pago. Puede usar la sesión para varias operaciones de API; consulte Usar una sesión para obtener más información.

Solicitud de ejemplo
URL https://evopaymentsmexico.gateway.mastercard.com/api/rest/version/72/merchant/<your_merchant_ID>/order/<your_order_ID>/transaction/<your_transaction_ID>
Método HTTP PUT
          
{
   "session":{
      "id":"<session_ID>"
   }   "..."
}
Código HTML de ejemplo

El siguiente código HTML de ejemplo muestra cómo integrar SRCi.js en su página de pago. Tenga en cuenta lo siguiente:

  • SRCi.configure() se debe llamar inmediatamente después de que la secuencia de comandos srci.min.js se cargue en la página. Un intento de llamada de SRCi.configure() dentro de su controlador de clic del botón, hará que algunos exploradores bloqueen la apertura de la ventana de pago de SRC.
  • El controlador de eventos del botón 'Pay' primero debe verificar que el SDK de JavaScript esté completamente configurado. Un intento de llamada de SRCi.launchUI() antes de una configuración con éxito arrojará errores y afectará negativamente la experiencia del pagador.
  • El botón 'Pay' debe deshabilitarse justo antes de llamar a SRCi.launchUI () y volver a habilitarse en cada una de las devoluciones de llamada. Intentar llamar a SRCi.launchUI() varias veces puede causar un comportamiento inesperado.
<html>
    <head>
        <script type="text/javascript" src="https://evopaymentsmexico.gateway.mastercard.com/static/srci/1.2.0/srci.min.js"></script>
         
        <script type="text/javascript">
            var configured = false;
 
            //SRCi global object is initialized by srci script
            SRCi.configure(
                "<gateway_merchant_ID>",
                "<merchant_name>",
                "<merchant_URL>",
                "<session_ID>", 
                { wsVersion: 57 },
              function (response) {
                if(response.result === "SUCCESS") {
                  configured = true;
                  console.log("Response from SDK: %s", response.restApiResponse);
                } else if(response.result === "ERROR") {
                  console.log("An error occurred");
                }
              }      
            );
 
            var payloadCallback = function (correlationId, scheme) {
              console.log("Payload callback complete with correlation id %s and scheme %s", correlationId, scheme);
              enablePayButton();
            };
  
            var errorCallback = function (error) {
              console.log("Error callback triggered with error %s",  error);
              enablePayButton();
            };
  
            var cancelCallback = function () {
              console.log("Cancel callback triggered");
              enablePayButton();
            };
  
            function enablePayButton() {
              document.getElementById("payButton").disabled = false;
            }
 
            function disablePayButton() {
              document.getElementById("payButton").disabled = true;
            }
 
            function pay() {
              if (configured) {
                // ensure only one payment window is launched
                disablePayButton();
 
                SRCi.launchUI({
                    orderAmount: "100.00",
                    orderCurrency: "USD"
                  },
                  payloadCallback,
                  errorCallback,
                  cancelCallback
                );
              } else {
                console.error("SRCi is not configured");
              }
            }
            </script>
    </head>
    <body>
        <button id="payButton" type="button" onclick="pay();">Pay</button>
    </body>
</html>    

Detalles de pago de SRC

Esta sección describe los detalles de pago devueltos para las interacciones de SRC.

Tipo de detalles de pago devueltos para interacciones con SRC

SRC admite la devolución de diferentes tipos de detalles de pago para su procesamiento. Los detalles de pago devueltos por el sistema SRC dependen del tipo solicitado por el motor de pagos, su configuración en el sistema SRC y el esquema de tarjeta. Por lo general, SRC devuelve un token de red, el vencimiento del token y el criptograma completo (cuando lo admita el esquema de la tarjeta).

Sin embargo, cuando el motor de pagos no puede enviar un token de red con el criptograma completo a su adquirente, SRC debe proporcionar un token de red, el vencimiento del token y el código de seguridad de tarjeta (CSC) dinámico. El motor de pagos se asegurará automáticamente de que se solicite el tipo correcto de detalle de pago.

Si una tarjeta no admite la tokenización de red (por ejemplo, cuando el emisor no participa), SRC devuelve los detalles de la tarjeta (número de tarjeta y vencimiento de la tarjeta) en lugar de los detalles del token de red (token de red, vencimiento del token y criptograma o CSC dinámico).

Si el suyo es un negocio de EE. UU. e indicó que desea hacer uso de sus derechos según la enmienda de Durbin, SRC proporciona los detalles de la tarjeta (número de tarjeta y vencimiento de la tarjeta) para las tarjetas de débito.

Detalles de pago de SRC en la respuesta de transacción de API

Los detalles de pago seleccionados por el pagador durante la interacción de SRC se almacenan en la sesión y se devuelven en la respuesta de transacción para las solicitudes de API realizadas mediante la sesión. Cuando SRC proporciona los detalles del token de red, se proporcionan tanto los detalles del token de red como los detalles de la tarjeta (enmascarada).

Dependiendo del tipo de detalles de pago devueltos por el sistema SRC, usted recibirá los siguientes detalles en la respuesta de la API.

Token de red con criptograma completo
(American Express no admite este tipo de token de red)
(El criptograma no se devuelve en las respuestas de transacción)
  • La respuesta contiene sourceOfFunds.type=SCHEME_TOKEN
  • Los detalles de la tarjeta (enmascarada) se devuelven en los siguientes campos:
    • sourceOfFunds.provided.card.number
    • sourceOfFunds.provided.card.expiry.year
    • sourceOfFunds.provided.card.expiry.month
  • Los detalles del token de red se devuelven en los siguientes campos:
    • sourceOfFunds.provided.card.deviceSpecificNumber
    • sourceOfFunds.provided.card.deviceSpecificExpiry.month
    • sourceOfFunds.provided.card.deviceSpecificExpiry.year
Token de red con CSC dinámico
(El CSC no se devuelve en las respuestas de transacción)
  • La respuesta contiene sourceOfFunds.type=SCHEME_TOKEN
  • Los detalles de la tarjeta (enmascarada) se devuelven en los siguientes campos:
    • sourceOfFunds.provided.card.number
    • sourceOfFunds.provided.card.expiry.year
    • sourceOfFunds.provided.card.expiry.month
  • Los detalles del token de red se devuelven en los siguientes campos:
    • sourceOfFunds.provided.card.deviceSpecificNumber
    • sourceOfFunds.provided.card.deviceSpecificExpiry.month
    • sourceOfFunds.provided.card.deviceSpecificExpiry.year
Número de tarjeta y vencimiento
  • La respuesta contiene sourceOfFunds.type=CARD
  • Los detalles de la tarjeta (enmascarada) se devuelven en los siguientes campos:
    • sourceOfFunds.provided.card.number
    • sourceOfFunds.provided.card.expiry.year
    • sourceOfFunds.provided.card.expiry.month

Detalles del pagador

El nombre y el número de teléfono del pagador se proporcionan en la respuesta de transacción en el grupo de parámetros de customer.

La dirección de correo electrónico del pagador se proporciona en la respuesta de transacción en el campo customer.email, si configuró consumerEmailAddressRequested como verdadero.

Detalles de la dirección de facturación

Los detalles de la dirección de facturación asociados con la tarjeta se proporcionan en la respuesta de transacción en el grupo de parámetros de billing.address.

Detalles de la dirección de envío

Si estableció collectShippingAddress en true, los detalles de la dirección de envío se proporcionan en la respuesta de transacción en el grupo de parámetros de shipping.address.

Transacciones iniciadas por el negocio

No debe ofrecer SRC como una opción de pago a sus pagadores si desea utilizar posteriormente esos detalles de pago para iniciar pagos en una serie, como pagos recurrentes o a plazos. Esto se admitirá en una versión futura.

Prueba de su integración

Cuando haya completado su integración con el motor de pagos para SRC, puede probarla utilizando su perfil de pruebas del negocio (su ID de negocio con el prefijo TEST). Al utilizar el perfil de pruebas del negocio, el motor de pagos proporciona un simulador para la interacción SRC. El simulador de SRC utiliza un conjunto de datos de pago predefinidos que no se pueden modificar. Según los datos de pago predefinidos, puede activar y probar diferentes escenarios, como se describe a continuación.

La segunda columna en las tablas a continuación indica los últimos 4 dígitos del FPAN que seleccionó el pagador durante la interacción de SRC. Para activar un escenario, seleccione el FPAN correspondiente en el simulador durante la interacción de SRC del pagador.

Escenario: SRC devuelve un token de red y un criptograma completo
Esquema Últimos 4 dígitos de FPAN ID de correlación de SRC Respuesta de UPDATE_SESSION_FROM_WALLET de API resultante Respuesta de AUTHORIZE o PAY de API resultante
Mastercard xxx0007 783a935d-c6a9-4289-b19d-c3336f998b57
  • order.walletProvider=MASTERPASS_ONLINE
  • sourceOfFunds.type=SCHEME_TOKEN
  • sourceOfFunds.provided.card.scheme=MASTERCARD
  • sourceOfFunds.provided.card.brand=MASTERCARD
  • sourceOfFunds.provided.card.fundingMethod=DEBIT
  • sourceOfFunds.provided.card.number=511111xxxxxx1118-Token
  • sourceOfFunds.provided.card.expiry.month=10-Vencimiento del token
  • sourceOfFunds.provided.card.expiry.year=25-Vencimiento del token
  • sourceOfFunds.provided.card.devicePayment.3DSecure.
    onlinePaymentCryptogram=1234-Criptograma
  • sourceOfFunds.provided.card.maskedFpan=222300xxxxxx0007-FPAN
  • sourceOfFunds.provided.card.maskedFpanExpiry.month=5-Vencimiento del FPAN
  • sourceOfFunds.provided.card.maskedFpanExpiry.year=21-Vencimiento del FPAN
Dirección de envío
  • shipping.address.contact.firstName=Iggy
  • shipping.address.contact.lastName=Peck
  • shipping.address.street=2200 Mastercard Blvd
  • shipping.address.street2=O'Fallon, dirección extendida
  • shipping.address.city=St. Louis
  • shipping.address.stateProvince=MO
  • shipping.address.postcode=63368-7263
  • shipping.address.country=USA
Detalles del cliente
  • customer.email=john.smith@example.com
  • customer.firstName=John
  • customer.lastName=Smith
  • customer.mobilePhone=+1 2128881234
Dirección de facturación
  • billing.address.city = Brisbane
  • billing.address.country = AUS
  • billing.address.postcodeZip = 4000
  • billing.address.stateProvince = QLD
  • billing.address.street = 333 Ann Street
  • billing.address.street2 = Floor 14, CBD
  • order.walletProvider=MASTERPASS_ONLINE
  • sourceOfFunds.type=SCHEME_TOKEN
  • sourceOfFunds.provided.card.scheme=MASTERCARD
  • sourceOfFunds.provided.card.brand=MASTERCARD
  • sourceOfFunds.provided.card.fundingMethod=DEBIT
  • sourceOfFunds.provided.card.number=222300xxxxxx0007-FPAN
  • sourceOfFunds.provided.card.expiry.month=5-Vencimiento del FPAN
  • sourceOfFunds.provided.card.expiry.year=21-Vencimiento del FPAN
  • sourceOfFunds.provided.card.deviceSpecificNumber=
    511111xxxxxx1118-Token
  • sourceOfFunds.provided.card.deviceSpecificExpiry.month=
    10-Vencimiento del token
  • sourceOfFunds.provided.card.deviceSpecificExpiry.year=
    25-Vencimiento del token
Dirección de envío
  • shipping.address.contact.firstName=Iggy
  • shipping.address.contact.lastName=Peck
  • shipping.address.street=2200 Mastercard Blvd, O'Fallon, dirección extendida
  • shipping.address.city=St. Louis
  • shipping.address.stateProvince=MO
  • shipping.address.postcode=63368-7263
  • shipping.address.country=USA
Detalles del cliente
  • customer.email=john.smith@example.com
  • customer.firstName=John
  • customer.lastName=Smith
  • customer.mobilePhone=+1 2128881234
Dirección de facturación
  • billing.address.city = Brisbane
  • billing.address.country = AUS
  • billing.address.postcodeZip = 4000
  • billing.address.stateProvince = QLD
  • billing.address.street = 300 Adelaide Street, Floor 21
Visa xxx0003 12345671-visaTAVV-expiry0822-colShiptrue
  • order.walletProvider=VISA_CHECKOUT
  • sourceOfFunds.type=SCHEME_TOKEN
  • sourceOfFunds.provided.card.scheme=VISA
  • sourceOfFunds.provided.card.brand=VISA
  • sourceOfFunds.provided.card.fundingMethod=CREDIT
  • sourceOfFunds.provided.card.number=453224xxxxxx4198-Token
  • sourceOfFunds.provided.card.expiry.month=8-Vencimiento del token
  • sourceOfFunds.provided.card.expiry.year=22-Vencimiento del token
  • sourceOfFunds.provided.card.nameOnCard=Mr. John Smith 
  • sourceOfFunds.provided.card.devicePayment.3DSecure.eciIndicator.
    onlinePaymentCryptogram=AgAAAAAABkwdwbyAkpPMQAAAAAA=-Criptograma
  • sourceOfFunds.provided.card.devicePayment.3DSecure.
    eciIndicator=07
  • sourceOfFunds.card.maskedFpan=444411xxxxxx3333-FPAN
  • sourceOfFunds.card.maskedFpanExpiry.month=8-Vencimiento del FPAN  
  • sourceOfFunds.card.maskedFpanExpiry.year=22-Vencimiento del FPAN
Dirección de envío
  • shipping.address.contact.firstName=Tony
  • shipping.address.contact.lastName=Tyre
  • shipping.address.street=Level 42, 700 Somewhere Street
  • shipping.address.city=Brisbane
  • shipping.address.stateProvince=QLD
  • shipping.address.postcodeZip=4000
  • shipping.address.country=AUS
Detalles del cliente
  • customer.email=emulator@tnsi.com
  • customer.firstName= Mr. John Smith 
  • customer.lastName=John 
  • customer.mobilePhone=+61 0444111222
  • customer.phone=+61 0444111222
Dirección de facturación
  • billing.address.city=Brisbane
  • billing.address.country=AUS
  • billing.address.postcodeZip = 4000
  • billing.address.stateProvince=QLD
  • billing.address.street=300 Adelaide Street
  • billing.address.street2=Floor 21
  • order.walletProvider=VISA_CHECKOUT
  • sourceOfFunds.type=SCHEME_TOKEN
  • sourceOfFunds.provided.card.scheme=VISA
  • sourceOfFunds.provided.card.brand=VISA
  • sourceOfFunds.provided.card.fundingMethod=CREDIT
  • sourceOfFunds.provided.card.number=444411xxxxxx3333-FPAN
  • sourceOfFunds.provided.card.expiry.month=8-Vencimiento del FPAN
  • sourceOfFunds.provided.card.expiry.year=22-Vencimiento del FPAN
  • sourceOfFunds.provided.card.nameOnCard=Mr. John Smith 
  • sourceOfFunds.provided.card.deviceSpecificNumber=
    453224xxxxxx4198-Token
  • sourceOfFunds.provided.card.deviceSpecificExpiry.month=
    8-Vencimiento del token
  • sourceOfFunds.provided.card.deviceSpecificExpiry.year=
    22-Vencimiento del token
Dirección de envío
  • shipping.address.contact.firstName=Tony
  • shipping.address.contact.lastName=Tyre
  • shipping.address.street=Level 42, 700 Somewhere Street
  • shipping.address.city=Brisbane
  • shipping.address.stateProvince=QLD
  • shipping.address.postcodeZip=4000
  • shipping.address.country=AUS
Detalles del cliente
  • customer.email=emulator@tnsi.com
  • customer.firstName= Mr. John Smith 
  • customer.lastName=John 
  • customer.mobilePhone=+61 0444111222
  • customer.phone=+61 0444111222
Dirección de facturación
  • billing.address.city=Brisbane
  • billing.address.country=AUS
  • billing.address.postcodeZip = 4000
  • billing.address.stateProvince = QLD
  • billing.address.street=300 Adelaide Street, Floor 21
Escenario: SRC devuelve un token de red y un código de seguridad de tarjeta dinámico
Esquema Últimos 4 dígitos de FPAN ID de correlación de SRC Respuesta de UPDATE_SESSION_FROM_WALLET de API resultante Respuesta de AUTHORIZE o PAY de API resultante
Mastercard xxx0008 261af700-e576-43bf-af92-bd0f6810e8fb
  • order.walletProvider=MASTERPASS_ONLINE
  • sourceOfFunds.type=SCHEME_TOKEN
  • sourceOfFunds.provided.card.scheme=MASTERCARD
  • sourceOfFunds.provided.card.brand=MASTERCARD
  • sourceOfFunds.provided.card.fundingMethod=CREDIT 
  • sourceOfFunds.provided.card.number=520424xxxxxx5996-Token
  • sourceOfFunds.provided.card.expiry.month=11-Vencimiento del token 
  • sourceOfFunds.provided.card.expiry.year=22-Vencimiento del token 
  • sourceOfFunds.provided.card.securityCode=xxx-Dynamic CSC
  • sourceOfFunds.provided.card.maskedFpan=512345xxxxxx0008-FPAN
  • sourceOfFunds.provided.card.maskedFpanExpiry.month=5-Vencimiento del FPAN 
  • sourceOfFunds.provided.card.maskedFpanExpiry.year=21-Vencimiento del FPAN
Dirección de envío
  • shipping.address.contact.firstName=Iggy
  • shipping.address.contact.lastName=Peck
  • shipping.address.street=2200 Mastercard Blvd
  • shipping.address.street2=O'Fallon, dirección extendida
  • shipping.address.city=St. Louis
  • shipping.address.stateProvince=MO
  • shipping.address.postcode=63368-7263
  • shipping.address.country=USA
Detalles del cliente
  • customer.email=john.smith@example.com
  • customer.firstName=John
  • customer.lastName=Smith
  • customer.mobilePhone=+1 2128881234
Dirección de facturación
  • billing.address.city = Brisbane
  • billing.address.country = AUS
  • billing.address.postcodeZip = 4000
  • billing.address.stateProvince = QLD
  • billing.address.street = 333 Ann Street
  • billing.address.street2 = Floor 14, CBD
  • order.walletProvider=MASTERPASS_ONLINE
  • sourceOfFunds.type=SCHEME_TOKEN
  • sourceOfFunds.provided.card.scheme=MASTERCARD
  • sourceOfFunds.provided.card.brand=MASTERCARD
  • sourceOfFunds.provided.card.fundingMethod=CREDIT 
  • sourceOfFunds.provided.card.number=512345xxxxxx0008-FPAN
  • sourceOfFunds.provided.card.expiry.month=05-Vencimiento del FPAN
  • sourceOfFunds.provided.card.expiry.year=11-Vencimiento del FPAN
  • sourceOfFunds.provided.card.deviceSpecificNumber=
    520424xxxxxx5996-Token 
  • sourceOfFunds.provided.card.deviceSpecificExpiry.month=
    11-Vencimiento del token 
  • sourceOfFunds.provided.card.deviceSpecificExpiry.year=
    22-Vencimiento del token 
Dirección de envío
  • shipping.address.contact.firstName=Iggy
  • shipping.address.contact.lastName=Peck
  • shipping.address.street=2200 Mastercard Blvd, O'Fallon, dirección extendida
  • shipping.address.city=St. Louis
  • shipping.address.stateProvince=MO
  • shipping.address.postcode=63368-7263
  • shipping.address.country=USA
Detalles del cliente
  • customer.email=john.smith@example.com
  • customer.firstName=John
  • customer.lastName=Smith
  • customer.mobilePhone=+1 2128881234
Dirección de facturación
  • billing.address.city = Brisbane
  • billing.address.country = AUS
  • billing.address.postcodeZip = 4000
  • billing.address.stateProvince = QLD
  • billing.address.street = 333 Ann Street, Floor 14, CBD
Visa xxx0002 12345671-visaDTVV-expiry0822-colShiptrue
  • order.walletProvider=VISA_CHECKOUT
  • sourceOfFunds.type=SCHEME_TOKEN
  • sourceOfFunds.provided.card.scheme=VISA
  • sourceOfFunds.provided.card.brand=VISA
  • sourceOfFunds.provided.card.fundingMethod=CREDIT
  • sourceOfFunds.provided.card.number=453224xxxxxx4198-Token
  • sourceOfFunds.provided.card.expiry.month=8-Vencimiento del token 
  • sourceOfFunds.provided.card.expiry.year=22-Vencimiento del token 
  • sourceOfFunds.provided.card.nameOnCard=Mr. John Smith
  • sourceOfFunds.provided.card.securityCode=xxx-Dynamic CSC
  • sourceOfFunds.provided.card.devicePayment.3DSecure.
    eciIndicator=07 
  • sourceOfFunds.card.maskedFpan=444411xxxxxx3333-FPAN
  • sourceOfFunds.card.maskedFpanExpiry.month=8-Vencimiento del FPAN  
  • sourceOfFunds.card.maskedFpanExpiry.year=22-Vencimiento del FPAN
Dirección de envío
  • shipping.address.contact.firstName=Tony
  • shipping.address.contact.lastName=Tyre
  • shipping.address.street=Level 42
  • shipping.address.street2=700 Somewhere Street
  • shipping.address.city=Brisbane
  • shipping.address.stateProvince=QLD
  • shipping.address.postcodeZip=4000
  • shipping.address.country=AUS
Detalles del cliente
  • customer.email=emulator@tnsi.com
  • customer.firstName=Mr.John Smith 
  • customer.lastName=John 
  • customer.mobilePhone=+61 0444111222
  • customer.phone=+61 0444111222
Dirección de facturación
  • billing.address.city=Brisbane
  • billing.address.country=AUS
  • billing.address.postcodeZip = 4000
  • billing.address.stateProvince=QLD
  • billing.address.street=300 Adelaide Street
  • billing.address.street2=Floor 21
  • order.walletProvider=VISA_CHECKOUT
  • sourceOfFunds.type=SCHEME_TOKEN
  • sourceOfFunds.provided.card.scheme=VISA
  • sourceOfFunds.provided.card.brand=VISA
  • sourceOfFunds.provided.card.fundingMethod=CREDIT
  • sourceOfFunds.provided.card.number=444411xxxxxx3333-Vencimiento del FPAN
  • sourceOfFunds.provided.card.expiry.month=8-Vencimiento del FPAN
  • sourceOfFunds.provided.card.expiry.year=22-Vencimiento del FPAN
  • sourceOfFunds.provoded.card.nameOnCard=Mr. John Smith 
  • sourceOfFunds.provided.card.deviceSpecificNumber=
    453224xxxxxx4198-Token
  • sourceOfFunds.provided.card.deviceSpecificExpiry.month=
    8-Vencimiento del token
  • sourceOfFunds.provided.card.deviceSpecificExpiry.year=
    22-Vencimiento del token
Dirección de envío
  • shipping.address.contact.firstName=Tony
  • shipping.address.contact.lastName=Tyre
  • shipping.address.street=Level 42, 700 Somewhere Street
  • shipping.address.city=Brisbane
  • shipping.address.stateProvince=QLD
  • shipping.address.postcodeZip=4000
  • shipping.address.country=AUS
Detalles del cliente
  • customer.email=emulator@tnsi.com
  • customer.firstName=Mr. John Smith 
  • customer.lastName=John 
  • customer.mobilePhone=+61 0444111222
  • customer.phone=+61 0444111222
Dirección de facturación
  • billing.address.city=Brisbane
  • billing.address.country=AUS
  • billing.address.postcodeZip = 4000
  • billing.address.stateProvince = QLD
  • billing.address.street=300 Adelaide Street, Floor 21
American Express xxx0017 cf3de1e0-55a2-44cf-9563-5ef9e648c492
  • order.walletProvider=AMEX_EXPRESS_CHECKOUT
  • sourceOfFunds.type=SCHEME_TOKEN
  • sourceOfFunds.provided.card.scheme=AMEX
  • sourceOfFunds.provided.card.brand=AMEX
  • sourceOfFunds.provided.card.fundingMethod=CREDIT 
  • sourceOfFunds.provided.card.number=370295xxxxx0017-Token 
  • sourceOfFunds.provided.card.expiry.month=12-Vencimiento del token
  • sourceOfFunds.provided.card.expiry.year=22-Vencimiento del token
  • sourceOfFunds.provided.card.securityCode=xxxx-Dynamic CSC
  • sourceOfFunds.provided.card.maskedFpan=349956xxxxxx6071-FPAN 
  • sourceOfFunds.provided.card.maskedFpanExpiry.month=5-Vencimiento del FPAN
  • sourceOfFunds.provided.card.maskedFpanExpiry.year=21-Vencimiento del FPAN
Dirección de envío
  • shipping.address.contact.firstName=Iggy
  • shipping.address.contact.lastName=Peck
  • shipping.address.street=2200 Mastercard Blvd
  • shipping.address.street2=O'Fallon, dirección extendida
  • shipping.address.city=St. Louis
  • shipping.address.stateProvince=MO
  • shipping.address.postcode=63368-7263
  • shipping.address.country=USA
Detalles del cliente
  • customer.email=john.smith@example.com
  • customer.firstName=John
  • customer.lastName=Smith
  • customer.mobilePhone=+1 2128881234
Dirección de facturación
  • billing.address.city=Brisbane
  • billing.address.country=AUS
  • billing.address.postcodeZip = 4000
  • billing.address.stateProvince=QLD
  • billing.address.street = 333 Ann Street
  • billing.address.street2 = Floor 14, CBD
  • order.walletProvider=AMEX_EXPRESS_CHECKOUT
  • sourceOfFunds.type=SCHEME_TOKEN
  • sourceOfFunds.provided.card.scheme=AMEX
  • sourceOfFunds.provided.card.brand=AMEX
  • sourceOfFunds.provided.card.fundingMethod=CREDIT 
  • sourceOfFunds.provided.card.number=349956xxxxxx6071-FPAN 
  • sourceOfFunds.provided.card.expiry.month=5-Vencimiento del FPAN
  • sourceOfFunds.provided.card.expiry.year=21-Vencimiento del FPAN
  • sourceOfFunds.provided.card.deviceSpecificNumber=
    370295xxxxx0017-Token 
  • sourceOfFunds.provided.card.deviceSpecificExpiry.month=
    12-Vencimiento del token
  • sourceOfFunds.provided.card.deviceSpecificExpiry.year=
    22-Vencimiento del token
Dirección de envío
  • shipping.address.contact.firstName=Iggy
  • shipping.address.contact.lastName=Peck
  • shipping.address.street=2200 Mastercard Blvd
  • shipping.address.street2=O'Fallon, dirección extendida
  • shipping.address.city=St. Louis
  • shipping.address.stateProvince=MO
  • shipping.address.postcode=63368-7263
  • shipping.address.country=USA
Detalles del cliente
  • customer.email=john.smith@example.com
  • customer.firstName=John
  • customer.lastName=Smith
  • customer.mobilePhone=+1 2128881234
Dirección de facturación
  • billing.address.city=Brisbane
  • billing.address.country=AUS
  • billing.address.postcodeZip = 4000
  • billing.address.stateProvince=QLD
  • billing.address.street = 333 Ann Street, Floor 14, CBD
Escenario: SRC devuelve el número de tarjeta y la fecha de vencimiento de la tarjeta (la tarjeta no admite la tokenización de red)
Esquema Últimos 4 dígitos de FPAN ID de correlación de SRC Respuesta de UPDATE_SESSION_FROM_WALLET de API resultante Respuesta de AUTHORIZE o PAY de API resultante
Mastercard xxx0305 8e455e8b-4e52-46cf-a3da-83aa3cf9a76e
  • order.walletProvider=MASTERPASS_ONLINE
  • sourceOfFunds.type=CARD
  • sourceOfFunds.provided.card.scheme=MASTERCARD
  • sourceOfFunds.provided.card.brand=MASTERCARD
  • sourceOfFunds.provided.card.fundingMethod=CREDIT 
  • sourceOfFunds.provided.card.number =550690xxxxxx0305-FPAN  
  • sourceOfFunds.provided.card.expiry.month=5-Vencimiento del FPAN
  • sourceOfFunds.provided.card.expiry.year=21-Vencimiento del FPAN
  • sourceOfFunds.provided.card.nameOnCard=John Smith
  • sourceOfFunds.provided.card.maskedFpan=550690xxxxxx0305-FPAN 
  • sourceOfFunds.provided.card.maskedFpanExpiry.month=5-Vencimiento del FPAN  
  • sourceOfFunds.provided.card.maskedFpanExpiry.year=21-Vencimiento del FPAN
Dirección de envío
  • shipping.address.contact.firstName=Iggy
  • shipping.address.contact.lastName=Peck
  • shipping.address.street=2200 Mastercard Blvd
  • shipping.address.street2=O'Fallon, dirección extendida
  • shipping.address.city=St. Louis
  • shipping.address.stateProvince=MO
  • shipping.address.postcode=63368-7263
  • shipping.address.country=USA
Detalles del cliente
  • customer.email=john.smith@example.com
  • customer.firstName=John
  • customer.lastName=Smith
  • customer.mobilePhone=+1 2128881234
Dirección de facturación
  • billing.address.city=Brisbane
  • billing.address.country=AUS
  • billing.address.postcodeZip = 4000
  • billing.address.stateProvince=QLD
  • billing.address.street=300 Adelaide Street
  • Floor 21
  • order.walletProvider=MASTERPASS_ONLINE
  • sourceOfFunds.type=CARD
  • sourceOfFunds.provided.card.scheme=MASTERCARD
  • sourceOfFunds.provided.card.brand=MASTERCARD
  • sourceOfFunds.provided.card.fundingMethod=CREDIT 
  • sourceOfFunds.provided.card.number =550690xxxxxx0305-FPAN 
  • sourceOfFunds.provided.card.expiry.month=5-Vencimiento del FPAN
  • sourceOfFunds.provided.card.expiry.year=21-Vencimiento del FPAN
  • sourceOfFunds.provided.card.nameOnCard=John Smith
Dirección de envío
  • shipping.address.contact.firstName=Iggy
  • shipping.address.contact.lastName=Peck
  • shipping.address.street=2200 Mastercard Blvd
  • shipping.address.street2=O'Fallon, dirección extendida
  • shipping.address.city=St. Louis
  • shipping.address.stateProvince=MO
  • shipping.address.postcode=63368-7263
  • shipping.address.country=USA
Detalles del cliente
  • customer.email=john.smith@example.com
  • customer.firstName=John
  • customer.lastName=Smith
  • customer.mobilePhone=+1 2128881234
Dirección de facturación
  • billing.address.city=Brisbane
  • billing.address.country=AUS
  • billing.address.postcodeZip = 4000
  • billing.address.stateProvince=QLD
  • billing.address.street = 333 Ann Street, Floor 14, CBD
Visa xxx0001 12345671-visa1-expiry0822
  • order.walletProvider=VISA_CHECKOUT
  • sourceOfFunds.type=CARD
  • sourceOfFunds.provided.card.scheme=VISA
  • sourceOfFunds.provided.card.brand=VISA
  • sourceOfFunds.provided.card.fundingMethod=CREDIT
  • sourceOfFunds.provided.card.number=400552xxxxxx4821-FPAN
  • sourceOfFunds.provided.card.expiry.month=8-Vencimiento del FPAN
  • sourceOfFunds.provided.card.expiry.year=22-Vencimiento del FPAN
  • sourceOfFunds.provided.card.nameOnCard=Mr. John Smith
  • sourceOfFunds.card.maskedFpan=400552xxxxxx4821-FPAN
  • sourceOfFunds.card.maskedFpanExpiry.month=8-Vencimiento del FPAN 
  • sourceOfFunds.card.maskedFpanExpiry.year=22-Vencimiento del FPAN
Detalles del cliente
  • customer.email=emulator@tnsi.com
  • customer.firstName=Mr. John Smith 
  • customer.lastName=John 
  • customer.mobilePhone=+61 0444111222
  • customer.phone=+61 0444111222
Dirección de facturación
  • billing.address.city=Brisbane
  • billing.address.country=AUS
  • billing.address.postcodeZip = 4000
  • billing.address.stateProvince=QLD
  • billing.address.street=300 Adelaide Street
  • billing.address.street2=Floor 21
  • order.walletProvider=VISA_CHECKOUT
  • sourceOfFunds.type=CARD
  • sourceOfFunds.provided.card.scheme=VISA
  • sourceOfFunds.provided.card.brand=VISA
  • sourceOfFunds.provided.card.fundingMethod=CREDIT
  • sourceOfFunds.provided.card.number=400552xxxxxx4821-FPAN
  • sourceOfFunds.provided.card.expiry.month=8-Vencimiento del FPAN
  • sourceOfFunds.provided.card.expiry.year=22-Vencimiento del FPAN
  • sourceOfFunds.provided.card.nameOnCard=Mr. John Smith 
Detalles del cliente
  • customer.email=emulator@tnsi.com
  • customer.firstName=Mr. John Smith 
  • customer.lastName =John 
  • customer.mobilePhone=+61 0444111222
  • customer.phone=+61 0444111222
Dirección de facturación
  • billing.address.city=Brisbane
  • billing.address.country=AUS
  • billing.address.postcodeZip = 4000
  • billing.address.stateProvince = QLD
  • billing.address.street=300 Adelaide Street, Floor 21
American Express xxx4564 bb978084-42b7-4985-af9d-2e41ee0a370c
  • order.walletProvider=AMEX_EXPRESS_CHECKOUT
  • sourceOfFunds.type=CARD
  • sourceOfFunds.provided.card.scheme=AMEX
  • sourceOfFunds.provided.card.brand=AMEX
  • sourceOfFunds.provided.card.fundingMethod=CREDIT 
  • sourceOfFunds.provided.card.number=345678xxxxx4564-FPAN
  • sourceOfFunds.provided.card.expiry.month=5-Vencimiento del FPAN
  • sourceOfFunds.provided.card.expiry.year=21-Vencimiento del FPAN
  • sourceOfFunds.provided.card.nameOnCard=Mr. John Smith 
  • sourceOfFunds.provided.card.maskedFpan=345678xxxxx4564-FPAN
  • sourceOfFunds.provided.card.maskedFpanExpiry.month=5-Vencimiento del FPAN 
  • sourceOfFunds.provided.card.maskedFpanExpiry.year=21-Vencimiento del FPAN
Dirección de envío
  • shipping.address.contact.firstName=Iggy
  • shipping.address.contact.lastName=Peck
  • shipping.address.street=2200 Mastercard Blvd
  • shipping.address.street2=O'Fallon, dirección extendida
  • shipping.address.city=St. Louis
  • shipping.address.stateProvince=MO
  • shipping.address.postcode=63368-7263
  • shipping.address.country=USA
Detalles del cliente
  • customer.email=john.smith@example.com
  • customer.firstName=John
  • customer.lastName=Smith
  • customer.mobilePhone=+1 2128881234
Dirección de facturación
  • billing.address.city=Brisbane
  • billing.address.country=AUS
  • billing.address.postcodeZip = 4000
  • billing.address.stateProvince=QLD
  • billing.address.street = 333 Ann Street
  • billing.address.street2=Floor 21
  • order.walletProvider=AMEX_EXPRESS_CHECKOUT
  • sourceOfFunds.type=CARD
  • sourceOfFunds.provided.card.scheme=AMEX
  • sourceOfFunds.provided.card.brand=AMEX
  • sourceOfFunds.provided.card.fundingMethod=CREDIT 
  • sourceOfFunds.provided.card.number=345678xxxxx4564-FPAN
  • sourceOfFunds.provided.card.expiry.month=5-Vencimiento del FPAN
  • sourceOfFunds.provided.card.expiry.year=21-Vencimiento del FPAN
  • sourceOfFunds.provided.card.nameOnCard=Mr. John Smith 
Dirección de envío
  • shipping.address.contact.firstName=Iggy
  • shipping.address.contact.lastName=Peck
  • shipping.address.street=2200 Mastercard Blvd
  • shipping.address.street2=O'Fallon, dirección extendida
  • shipping.address.city=St. Louis
  • shipping.address.stateProvince=MO
  • shipping.address.postcode=63368-7263
  • shipping.address.country=USA
Detalles del cliente
  • customer.email=john.smith@example.com
  • customer.firstName=John
  • customer.lastName=Smith
  • customer.mobilePhone=+1 2128881234
Dirección de facturación
  • billing.address.city=Brisbane
  • billing.address.country=AUS
  • billing.address.postcodeZip = 4000
  • billing.address.stateProvince=QLD
  • billing.address.street = 333 Ann Street, Floor 14, CBD

Prueba de SRC con autenticación 3D-Secure

Si su perfil del negocio está habilitado para Autenticación 3D-Secure EMV (3DS2) puede utilizar los detalles de la prueba de SRC que se muestran en la tabla a continuación para activar un flujo fluido o un flujo de desafío.

Escenario: Flujo de desafío 3DS2
Esquema Últimos 4 dígitos de FPAN ID de correlación de SRC Respuesta de API resultante
Mastercard xxx0009 1049624e-cc67-45f6-bd5f-c625eb4c6cc1
  • order.walletProvider=MASTERPASS_ONLINE
  • sourceOfFunds.type=SCHEME_TOKEN
  • sourceOfFunds.provided.card.scheme=MASTERCARD
  • sourceOfFunds.provided.card.brand=MASTERCARD
  • sourceOfFunds.provided.card.deviceSpecificNumber = 512345xxxxxx8212
  • sourceOfFunds.provided.card.deviceSpecificExpiry.month = 5
  • sourceOfFunds.provided.card.deviceSpecificExpiry.year = 21
  • sourceOfFunds.provided.card.number = 512345xxxxxx0009
  • sourceOfFunds.provided.card.expiry.month = 9
  • sourceOfFunds.provided.card.expiry.year = 55
Visa xxx4222 12345671-SRC3DSChallenge-expiry0822-colShiptrue
  • order.walletProvider=VISA_CHECKOUT
  • sourceOfFunds.type = SCHEME_TOKEN
  • sourceOfFunds.provided.card.scheme=VISA
  • sourceOfFunds.provided.card.brand=VISA
  • sourceOfFunds.provided.card.devicePayment.3DSecure.eciIndicator=07
  • sourceOfFunds.provided.card.devicePayment.3DSecure.onlinePaymentCryptogram=AgAAAAAABkwdwbyAkpPMQAAAAAA=
  • sourceOfFunds.provided.card.number = 453224xxxxxx4222
  • sourceOfFunds.provided.card.expiry.month = 8
  • sourceOfFunds.provided.card.expiry.year = 22
American Express xxx0017 16e051bc-bd25-46db-a7d3-d2944fbb05cf
  • order.walletProvider=AMEX_EXPRESS_CHECKOUT
  • sourceOfFunds.type = SCHEME_TOKEN
  • sourceOfFunds.provided.card.scheme=AMEX
  • sourceOfFunds.provided.card.brand=AMEX
  • sourceOfFunds.provided.card.deviceSpecificNumber = 373224xxxxx9117
  • sourceOfFunds.provided.card.deviceSpecificExpiry.month = 5
  • sourceOfFunds.provided.card.deviceSpecificExpiry.year = 21
  • sourceOfFunds.provided.card.number = 373224xxxxxx4570
  • sourceOfFunds.provided.card.expiry.month = 5
  • sourceOfFunds.provided.card.expiry.year = 21
Escenario: Flujo fluido 3DS2
Esquema Últimos 4 dígitos de FPAN ID de correlación de SRC Respuesta de API resultante
Mastercard xxx0010 16e051bc-bd25-46db-a7d3-d2944fbb05cf
  • order.walletProvider=MASTERPASS_ONLINE
  • sourceOfFunds.type=SCHEME_TOKEN
  • sourceOfFunds.provided.card.scheme=MASTERCARD
  • sourceOfFunds.provided.card.brand=MASTERCARD
  • sourceOfFunds.provided.card.deviceSpecificNumber = 512345xxxxxx8170
  • sourceOfFunds.provided.card.deviceSpecificExpiry.month = 5
  • sourceOfFunds.provided.card.deviceSpecificExpiry.year = 21
  • sourceOfFunds.provided.card.number = 512345xxxxxx0010
  • sourceOfFunds.provided.card.expiry.month = 8
  • sourceOfFunds.provided.card.expiry.year = 55
Visa xxx4180 12345671-SRC3DSFrictionless-expiry0822-colShiptrue
  • order.walletProvider=VISA_CHECKOUT
  • sourceOfFunds.type = SCHEME_TOKEN
  • sourceOfFunds.provided.card.scheme=VISA
  • sourceOfFunds.provided.card.brand=VISA
  • sourceOfFunds.provided.card.devicePayment.3DSecure.eciIndicator=07
  • sourceOfFunds.provided.card.devicePayment.3DSecure.onlinePaymentCryptogram=AgAAAAAABkwdwbyAkpPMQAAAAAA=
  • sourceOfFunds.provided.card.number = 453224xxxxxx4180
  • sourceOfFunds.provided.card.expiry.month = 8
  • sourceOfFunds.provided.card.expiry.year = 22
American Express xxx4564 17e051bc-bd25-46db-a7d3-d2944fbb05cf
  • order.walletProvider=AMEX_EXPRESS_CHECKOUT
  • sourceOfFunds.type = SCHEME_TOKEN
  • sourceOfFunds.provided.card.scheme=AMEX
  • sourceOfFunds.provided.card.brand=AMEX
  • sourceOfFunds.provided.card.maskedFpan = 373224xxxxx9299
  • sourceOfFunds.provided.card.maskedFpanExpiry.month = 5
  • sourceOfFunds.provided.card.maskedFpanExpiry.year = 21
  • sourceOfFunds.provided.card.securityCode = xxx
  • sourceOfFunds.provided.card.number =373224xxxxx4571
  • sourceOfFunds.provided.card.expiry.month = 5
  • sourceOfFunds.provided.card.expiry.year = 21

Derechos de autor © 2023 Mastercard