Welcome to our new developer portal! Use the "Ask" button to chat with our AI Agent.
For the complete documentation index, see llms.txt. This page is also available as Markdown.

Tratamiento del esquema nacional

Utilice esta sección solo si:

  • El Servicio de Tokenización actúa como intermediario TSP para un esquema nacional o etiqueta privada.

  • Habilita una de estas billeteras xPay: Apple Pay, Google Pay o Samsung Pay.

En la provisión push, la aplicación del emisor prepara una carga útil. La aplicación del emisor la pasa al Servicio de Tokenización a través del solicitante de token (proveedor de la billetera).

Esta carga útil se llama Datos de registro App2App (CryptoOTP). Tiene dos partes:

  • Datos de la tarjeta de financiación que contienen los detalles para tokenizar (PAN, fecha de vencimiento, etc.).

  • Valor de autenticación que contiene una prueba de seguridad adicional.

Hay dos opciones de implementación para el valor de autenticación:

Opciones de validación del valor de autenticación.
  • Opción 1 (recomendada): El Servicio de Tokenización valida el valor de autenticación.

    • El valor de autenticación debe seguir el formato de Thales.

  • Opción 2: El backend del emisor valida el valor de autenticación.

    • El formato del valor de autenticación depende del emisor.

Datos de registro App2App (JWE)

Esta sección se aplica solo a Samsung Pay y Google Pay.

Los datos de registro App2App son un JWE (JSON Web Encryption), según lo definido en la RFC 7516, con estas propiedades:

  • Utilice la serialización compacta.

  • Tipo de clave: RSA de 2048 bits o 4096 bits.

  • Algoritmos:

    • Cifrado de clave: RSA1_5 (obsoleto) o RSA-OAEP-256

    • Cifrado de contenido: A256GCM

ENCABEZADO JWE
DESCRIPCIÓN
VALOR
MOC

alg

Algoritmo criptográfico usado para cifrar la Clave de Cifrado de Contenido (CEK).

'RSA1_5' (obsoleto) o 'RSA-OAEP-256'

M

enc

Algoritmo de cifrado de contenido usado para realizar cifrado autenticado sobre el texto plano para producir el texto cifrado y la etiqueta de autenticación.

'A256GCM'

M

kid

Identificador de la clave RSA usada para el cifrado de la clave. Definido durante la incorporación. Proporcionado por Thales al emisor.

cadena

O

x-gto-issuerid

Encabezado JWE personalizado que contiene el issuerId definido durante la incorporación.

cadena

M

x-gto-productid

Encabezado JWE personalizado que contiene el productId definido durante la incorporación.

Su presencia depende de la configuración de su incorporación.

cadena

O

Ejemplo de encabezado JWE:

TEXTO CLARO JWE
DESCRIPCIÓN
TIPO
MOC

fpan

FPAN de la tarjeta de financiación a tokenizar.

cadena

M

exp

Fecha de vencimiento en MMYY formato.

cadena

O

issuerCardLastDigits

Últimos dígitos de la tarjeta de financiación para mostrar en la billetera.

cadena

O

authvalue

Dos opciones:

  1. Formato Thales validado por el Servicio de Tokenización

  2. Identificador opaco pasado al backend del emisor en la requestCardDigitization operación

cadena

C (No requerido para el flujo auxiliar o formato 3 con Apple Pay)

Ejemplo de texto claro JWE:

Ejemplo completo de JWE:

Valor de autenticación (formato Thales) (JWT)

Esta sección se aplica solo a Apple Pay, Samsung Pay y Google Pay.

El valor de autenticación es un JWT (JSON Web Token), según lo definido en la RFC 7519, con estas propiedades:

  • Tipo de clave: RSA de 2048 bits o 4096 bits.

ENCABEZADO JWT
DESCRIPCIÓN
VALOR
MOC

typ

Tipo de medio del JWT completo.

'JWT'

M

alg

Algoritmo usado en el JWT.

Algoritmos compatibles:

  • 'RS256'

  • 'PS256'

  • 'PS512'

M

kid

Identificador de la clave utilizada para firmar el JWT. Definido durante la incorporación. Proporcionado por el emisor a Thales

cadena

O

Ejemplo:

RECLAMACIONES JWT
DESCRIPCIÓN
VALOR
MOC

iss

Identificador único del emisor asignado durante la incorporación.

cadena

M

sub

El issuerCardRefId definido por el emisor.

cadena

M

iat

Fecha de creación del token definida en la RFC 7519.

int

M

exp

Expiración del token definida en la RFC 7519.

int

M

productId

El identificador del producto de la tarjeta definido durante la incorporación.

cadena

O

nonce

Reclamación privada usada para Apple Pay. Es el nonce valor que la aplicación del emisor captura a través del SDK iOS PassKit.

cadena

C (aplicable solo a Apple Pay)

nonceSignature

Reclamación privada usada para Apple Pay. Es el nonceSignature valor que la aplicación del emisor captura a través del SDK iOS PassKit.

cadena

C (aplicable solo a Apple Pay)

Ejemplos:

Ejemplo completo de JWT:

Última actualización

¿Te fue útil?