- Pautas de integración
- Métodos de pago
- Secure Remote Commerce
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.
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 DirectAPI 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.
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 ignore ingresar su dirección de correo electrónico durante la interacción de SRC. |
<html>
<head>
<script src="https://ap-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.
| URL | https://ap-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://ap-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://ap-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 DirectAPI que utilizó para enviar la solicitud de Payment Options Inquiry.
<html>
<head>
<script type="text/javascript" src="https://ap-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 ignore 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
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.
|
|||||||||||||||||||||
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
correlationIdy el esquema como se devuelve en lapayloadCallback.
| URL | https://ap-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 3-D 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 3-D 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.
| URL | https://ap-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>"
} "..."
}
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 comandossrci.min.jsse cargue en la página. Un intento de llamada deSRCi.configure()dentro de su controlador de clic del botón, hará que algunos navegadores 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://ap-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 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) |
|
| Token de red con CSC dinámico (El CSC no se devuelve en las respuestas de transacción) |
|
| Número de tarjeta y vencimiento |
|
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 true.
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 un número de pagos. 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.
| 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 |
|
|
| Visa | xxx0003 | 12345671-visaTAVV-expiry0822-colShiptrue |
|
|
| 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 |
|
|
| Visa | xxx0002 | 12345671-visaDTVV-expiry0822-colShiptrue |
|
|
| American Express | xxx0017 | cf3de1e0-55a2-44cf-9563-5ef9e648c492 |
|
|
| 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 |
|
|
| Visa | xxx0001 | 12345671-visa1-expiry0822 |
|
|
| American Express | xxx4564 | bb978084-42b7-4985-af9d-2e41ee0a370c |
|
|
Prueba de SRC con autenticación 3-D Secure
Si su perfil del negocio está habilitado para Autenticación EMV 3-D Secure (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.
| Esquema | Últimos 4 dígitos de FPAN | ID de correlación de SRC | Respuesta de API resultante |
|---|---|---|---|
| Mastercard | xxx0009 | 1049624e-cc67-45f6-bd5f-c625eb4c6cc1 |
|
| Visa | xxx4222 | 12345671-SRC3DSChallenge-expiry0822-colShiptrue |
|
| American Express | xxx0017 | 16e051bc-bd25-46db-a7d3-d2944fbb05cf |
|
| Esquema | Últimos 4 dígitos de FPAN | ID de correlación de SRC | Respuesta de API resultante |
|---|---|---|---|
| Mastercard | xxx0010 | 16e051bc-bd25-46db-a7d3-d2944fbb05cf |
|
| Visa | xxx4180 | 12345671-SRC3DSFrictionless-expiry0822-colShiptrue |
|
| American Express | xxx4564 | 17e051bc-bd25-46db-a7d3-d2944fbb05cf |
|