Integration Types
Otras características
Card Payments
Mobile Wallets
Alternative Payment Methods
Resources
Un token de red (también conocido como token de esquema de tarjeta) es un token generado por proveedores de servicios de tokenización de red, como Mastercard Digital Enablement Service (MDES), a cambio del número de cuenta principal (PAN) del pagador. Usted o su proveedor de servicios de pago (en su nombre) pueden solicitar que los PAN de cuentas existentes en el archivo se tokenicen y que cada PAN se sustituya por un token de red único. Tenga en cuenta que esto está sujeto a la participación del emisor en el servicio de tokenización de red y los rangos de cuentas de tarjeta habilitados. Estos tokens se pueden usar luego para el comercio electrónico y las transacciones en la aplicación similares a los PAN de cuentas.
El Mastercard Gateway actualmente admite el procesamiento de tokens de red obtenidos de los siguientes proveedores de servicios de tokenización de red:
Puede utilizar tokens de red por medio de Mastercard Gateway de dos maneras:
Cuando usted se integra directamente con el proveedor de servicios de token de red, debe obtener los detalles del token del proveedor y proporcionar estos detalles al motor de pagos en una solicitud de Authorization/Pay para procesar pagos.
Además de los campos estándar, proporcione los campos siguientes en la solicitud de Authorization/Pay para procesar pagos utilizando los tokens de red emitidos por los proveedores de servicios de tokenización de red.
sourceOfFunds.type=SCHEME_TOKEN
: permite al motor de pagos identificar la fuente de fondos proporcionada en la solicitud como token de red. MDES, VTS y AETS son compatibles a partir de API v51, v53, v57, respectivamente.sourceOfFunds.provided.card.number
: el token de red. Proporcione el valor para el "PAN de token" de MDES, el "Token" de VTS o el "Token" de AETS.
sourceOfFunds.provided.card.storedOnFile
=STORED
en la solicitud. Para obtener más información, consulte transacciones iniciadas por el titular de la tarjeta y el negocio. sourceOfFunds.provided.card.expiry
: el vencimiento del token de red. sourceOfFunds.provided.card.devicePayment.onlinePaymentCryptogram
: utilice el valor directamente de las credenciales de transacción descifradas. Proporcione el criptograma MDES UCAF (de48se43Data) o el criptograma VTS TAVV.sourceOfFunds.provided.card.devicePayment.eciIndicator
: el indicador de comercio electrónico emitido por el servicio de tokenización. Este campo es obligatorio para los tokens de red obtenidos de VTS. sourceOfFunds.provided.card.securityCode
: el código de verificación del token si lo emite el servicio de tokenización. Proporcione el código de verificación de token dinámico de MDES (DTVC) o el valor de verificación de token dinámico de VTS (DTVV) o la credencial de pago dinámico de AETS (DCSC).transaction.source
: para transacción iniciada por el titular de la tarjeta, establezca este campo en MOTO, CALL_CENTRE, MAIL_ORDER, TELEPHONE_ORDER y VOICE_RESPONSE. Para transacción iniciada por el negocio, establezca este campo en "INTERNET" o "MERCHANT".
Cuando se proporciona un token de red en la solicitud Authorization/Pay, la respuesta de Retrieve Transaction devolverá lo siguiente:
Si el adquirente devuelve un FPAN:
Si el adquirente no devuelve un FPAN:
El motor de pagos brinda soporte para actuar como solicitante de tokens en su nombre. Si usted está habilitado para la tokenización del motor de pagos, entonces su proveedor de servicios de pago también puede habilitar y configurar la tokenización de red en su perfil de negocio. Si está habilitado, cualquier solicitud al motor de pagos de un token de motor de pagos también intentará generar un token de red correspondiente para los esquemas habilitados, cuando con el emisor de la tarjeta lo admita. La solicitud Authorization/Pay utilizará el token de red si está disponible; de lo contrario, se utilizará el PAN de financiamiento (FPAN) almacenado en el token del motor de pagos.
También se intentará la tokenización de red para cualquier tarjeta aplicable que ya esté almacenada en el depósito de tokens del motor de pagos.
Cuando elimina un token del motor de pagos, el token de red correspondiente se elimina automáticamente en el servicio de tokenización.
Es importante tener en cuenta que si el emisor actualiza la tarjeta, por ejemplo, en el caso de tarjetas vencidas, perdidas o robadas, los detalles de FPAN existentes almacenados en el token del motor de pagos se marcan como no válidos. Si resulta necesario utilizar un FPAN en la solicitud de pago porque el token de red no está disponible, el motor de pagos rechaza la solicitud. Se recibe el error "El token proporcionado en la solicitud está marcado como inutilizable. Los detalles de la tarjeta almacenados con respecto al token deben actualizarse antes de ser utilizados, debido a que se ha informado al motor de pagos de que los detalles de la tarjeta ya no son válidos".
Para mantener sus registros actualizados, puede recuperar los detalles de FPAN enmascarados del FPAN actualizado de la respuesta a la transacción donde se usó el token de red en el pago.
Cuando se utiliza un token de red en la solicitud Authorization/Pay, la respuesta de Retrieve Transaction devolverá lo siguiente:
La tokenización de red no se aplica a los pagos con dispositivo mediante DPAN o FPAN.
El motor de pagos puede procesar tokens de red en la solicitud Initiate Authentication. Para obtener más información, consulte Initiate Authentication.
Si ha autenticado al pagador externamente utilizando un token de red, puede transmitir la información sobre la autenticación en el grupo de parámetros de authentication
de la operación Pay o Authorize. Para obtener más información, consulte Enviar una operación de pago con autenticación previa.
El motor de pagos le permite utilizar tokens de red almacenados en un archivo para realizar transacciones iniciadas por el titular de la tarjeta y por el negocio.
Para un pedido o transacción en la que se haya utilizado un token de red, el campo se muestra "Proveedor de token externo" en la página de detalles del pedido y la transacción en Merchant Administration. Este campo puede mostrar Mastercard (MDES) o Visa (VTS).
Puede probar su integración con el motor de pagos en producción usando su perfil de pruebas del negocio y un token de red compatible (consulte la tabla siguiente).
Proveedor de token | Token | Vencimiento del token |
Criptograma | Indicador ECI |
---|---|---|---|---|
MDES | 5204 2477 5000 1497 | 11/22 | <any> | - |
VTS | 4111 1111 1111 1111 | 06/29 | <any> | 05 |
AETS | 3456 7890 1234 564 | 05/21 | <any> | - |
Si las transacciones tienen el estado APPROVED o DECLINED, entonces el motor de pagos fue capaz de procesar sus transacciones de prueba con éxito.