Welcome to our new developer portal! Use the "Ask" button to chat with our AI Agent.

Agregar datos de transacciones de la cartera

Descripción general

Puede adjuntar datos de transacciones de wallet a un pago sin contacto.

El backend del emisor puede usar estos datos durante el procesamiento de la autorización.

Los datos de transacción de wallet se definen por tarjeta digital.

La aplicación de cartera digital puede proporcionarlos en dos modos:

  • Persistente: El SDK de NFC Wallet almacena los datos en almacenamiento seguro. Persiste entre reinicios de la aplicación.

  • Efímero: La aplicación de cartera digital proporciona el valor solo para una transacción.

La aplicación de cartera digital decide si incluir los datos de transacción de wallet en cada pago.

El SDK de NFC Wallet admite datos de transacción de wallet solo para los perfiles sin contacto Mastercard y PURE.

Especificación Mastercard (MCBP 2.3)

El SDK de NFC Wallet admite la especificación Mastercard MCBP 2.3.

Si los datos de transacción de wallet están disponibles antes de una transacción sin contacto, el SDK de NFC Wallet actualiza el IAD (tag EMV 9F10, Datos de la aplicación del emisor):

  • Desplazamiento inicial: byte 19

  • Longitud máxima del IAD: 32 bytes

  • Longitud máxima de los datos de transacción de wallet: 14 bytes

En MCBP 2.3, esta función se denomina información propietaria de wallet.

Especificación PURE

El SDK de NFC Wallet también admite datos de transacción de wallet para perfiles sin contacto PURE.

Si los datos de transacción de wallet están disponibles antes de una transacción sin contacto, el SDK de NFC Wallet actualiza el IAD (tag EMV 9F10, Datos de la aplicación del emisor):

  • Desplazamiento inicial: byte 18

  • Longitud máxima del IAD: 32 bytes

  • Longitud máxima de los datos de transacción de wallet: 15 bytes

Integración del SDK

Establecer datos persistentes de transacción de wallet para Mastercard

Use DigitalCard.setWalletTransactionData para establecer datos persistentes de transacción de wallet:

  • Pasar un valor de Data de 14 bytes para almacenar los datos de transacción de wallet de esta tarjeta digital.

  • Pasar nil para borrar el valor almacenado de esta tarjeta digital.

Establecer datos persistentes de transacción de wallet para PURE

Use DigitalCard.setWalletTransactionData para establecer datos persistentes de transacción de wallet:

  • Pasar un valor de 15 bytes Data de 14 bytes para almacenar los datos de transacción de wallet de esta tarjeta digital.

  • Pasar nil para borrar el valor almacenado de esta tarjeta digital.

Manejar errores

Los datos de transacción de wallet deben cumplir los siguientes requisitos:

  • Longitud para Mastercard: exactamente 14 bytes

  • Longitud para PURE: exactamente 15 bytes

  • Compatibilidad con el esquema: solo se admiten los perfiles sin contacto Mastercard y PURE. Si establece datos de transacción de wallet para otro esquema, el SDK devuelve .schemeNotSupported.

Proporcionar datos de transacción de wallet para un pago

Use startPayment() con ContactlessPaymentInputData para proporcionar datos de transacción de wallet durante un pago sin contacto.

ContactlessPaymentInputData admite dos modos de datos de transacción de wallet:

  • .storage: Usa el valor almacenado en el almacenamiento seguro (si está configurado).

  • .ephemeral: Proporciona un valor solo para esta transacción.

Modo de almacenamiento

Modo efímero

Iniciar un pago

Última actualización

¿Te fue útil?