> For the complete documentation index, see [llms.txt](https://docs.payments.thalescloud.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.payments.thalescloud.io/nfc-wallet/es/backend-de-nfc-wallet/registro-de-tarjeta/capturar-credenciales-de-la-tarjeta.md). # Capturar credenciales de la tarjeta ## Descripción general Para admitir la inscripción de tarjetas, la aplicación de billetera digital debe primero capturar las credenciales de la tarjeta. Puede proporcionar las credenciales de la tarjeta desde: * **Backend de la billetera digital**. Por ejemplo, cuando la aplicación de billetera digital es una aplicación del emisor. * **Entrada del usuario final**. Por ejemplo, entrada manual o escaneo con cámara en una billetera abierta que admite tarjetas de varios emisores. Las credenciales de la tarjeta son sensibles. Encríptelas antes de iniciar la inscripción de la tarjeta con el SDK de NFC Wallet. Siguiente: * Revisar [Requisitos de cifrado](/nfc-wallet/es/backend-de-nfc-wallet/registro-de-tarjeta/capturar-credenciales-de-la-tarjeta.md#encryption-requirements) para confirmar el formato de cifrado compatible. * Consulte [carga útil de información de la tarjeta](/nfc-wallet/es/backend-de-nfc-wallet/registro-de-tarjeta/capturar-credenciales-de-la-tarjeta.md#card-information-payload) para dar formato a la carga útil de las credenciales de la tarjeta antes del cifrado. {% hint style="info" %} Consulte [carga útil de información del token](/nfc-wallet/es/backend-de-nfc-wallet/registro-de-tarjeta/capturar-credenciales-de-la-tarjeta.md#token-information-payload) si admite la inscripción de token por token. {% endhint %} ## Requisitos ### Requisitos de cifrado La información de la tarjeta usa el formato de cifrado PKCS#7 definido en RFC 2315 y RFC 5652. Use estos criterios de cifrado: * Algoritmo de cifrado de contenido: `AES256/CBC/PKCS7Padding` * Algoritmo de cifrado de clave: `RSA` con una longitud de clave pública del emisor de 2048 bits La carga útil de la tarjeta debe ser JSON válido y contener los campos descritos a continuación. Codifique el resultado del cifrado en Base64. ### carga útil de información de la tarjeta Para admitir la inscripción de tarjetas, proporcione la siguiente carga útil cifrada. | Campo JSON | Descripción | Requisito | Longitud | | ---------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------- | -------- | | `fpan` | PAN de financiación que se va a digitalizar. | Obligatorio | 16-20 | | `exp` | Fecha de vencimiento de la tarjeta en `MMAA` formato. | Obligatorio | 4 | | `cvv` | Código de seguridad de la tarjeta. Proporciónelo solo si el emisor lo requiere. | Condicional | 3-4 | | `name` | Nombre en la tarjeta. Para Mastercard (MDES), use `APELLIDO/NOMBRE` o `NOMBRE APELLIDO`. Para Visa (VTS), use el nombre completo impreso en la tarjeta. | Opcional | 27 | | `billingAddress` | Dirección de facturación del usuario final. Consulte la definición a continuación. | Opcional | - | | `nonce` | Valor efímero usado solo para la inscripción en verde. Si lo proporciona, también proporcione el hash SHA-256 del `nonce` en el token de autenticación. Caracteres permitidos: `0-9`, `A-Z`, `a-z`, `-`, `_`. | Opcional | 1-50 | #### Carga útil de dirección de facturación La siguiente tabla describe los campos JSON compatibles cuando proporciona la dirección de facturación. | Campo JSON | Descripción | Requisito | Longitud | | ------------ | ----------------------------------------------------------- | --------- | -------- | | `line1` | Primera línea de la dirección del usuario final. | Opcional | 1-64 | | `line2` | Segunda línea de la dirección del usuario final. | Opcional | 1-64 | | `city` | Ciudad de la dirección del usuario final. | Opcional | 1-34 | | `state` | Código de estado o provincia en formato ISO 3166-2. | Opcional | 1-6 | | `country` | Código de país en formato ISO 3166-1 alfa-2. Ejemplo: `FR`. | Opcional | 2 | | `postalCode` | Código postal. | Opcional | 1-16 | ### carga útil de información del token Para admitir la inscripción de token por token, proporcione la siguiente carga útil cifrada. | Campo JSON | Descripción | Requisito | Longitud | | ------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------- | -------- | | `scheme` | Sistema de tarjeta. Valores compatibles: `VISA`, `MASTERCARD`. | Obligatorio | - | | `issuerId` | Identificador único del emisor. | Obligatorio | 10 | | `cardProductId` | ID del producto de la tarjeta. Obligatorio si el emisor admite varios productos de tarjeta para el mismo sistema. | Condicional | 1-48 | | `dpan` | DPAN del token original que se va a digitalizar para la inscripción de token por token de Visa. | Opcional | 16-20 | | `cvv` | CVV de la tarjeta de financiación asociada con el token original. Proporciónelo para Visa. Su uso depende del proyecto y debe definirse con su representante de Visa. | Opcional | 3-4 | | `digitalCardId` | ID de tarjeta digital del token original, según lo definido por el TSP. Para Mastercard, este campo es obligatorio. Para Visa, este campo es opcional. En las API de MDES, corresponde a `tokenUniqueReference`. En las API de VTS, corresponde a `vProvisionedTokenID`. Para Visa, el solicitante del token puede proporcionar `digitalCardId`, `dpan`, o ambos. | Condicional | 1-64 | | `digitalCardRequestorId` | ID del solicitante de tarjeta digital del token original. El TSP define este valor. | Opcional | 1-11 | | `nonce` | Valor efímero usado solo cuando se proporciona un token de autenticación para definir la puntuación de la billetera. Si lo proporciona, también proporcione el hash SHA-256 del `nonce` en el token de autenticación. Caracteres permitidos: `0-9`, `A-Z`, `a-z`, `-`, `_`. | Opcional | 1-50 | --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://docs.payments.thalescloud.io/nfc-wallet/es/backend-de-nfc-wallet/registro-de-tarjeta/capturar-credenciales-de-la-tarjeta.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.