Token Migration Process

Token migration is the process of transferring card numbers from an existing provider to Yuno's secure vault. During this process, a new token is generated for each card, ensuring seamless continuity and security for payment processing. The token migration process consists of three main steps:

  1. The merchant requests the token migration process from their current payment processor.
  2. Yuno and the payment provider collaborate to securely import all card data into the Yuno token vault.
  3. The merchant uses Yuno's token migration API to map the tokens from the payment provider to the vaulted_tokens of Yuno.
📘

First step

To initiate the token migration process, contact your business advisor at Yuno to assess the viability and schedule of the procedure.

Importing cards from a gateway account (steps 1 and 2)

Importing card data from a gateway account involves handling sensitive information, so strict security protocols must be followed. To import card data into Yuno from an existing gateway, complete the following steps:

  1. Coordinate with the current gateway: Contact your current third-party vault or gateway and request an export of the payment method data. Ensure you follow their specified protocols.
  2. Complete the formal request: Submit a formal request to Yuno, ensuring all required details and processes are documented. The gateway's response time and procedures will determine the data transfer process.
🚧

Your responsibilities when migrating tokens

You are responsible for managing communication with your gateway provider throughout the migration process. The Yuno team will support and collaborate directly with the third-party vault/gateway to facilitate the importing process. Additionally, the customer subscription information, including amounts, dates, etc., must be obtained directly from the exporting entity, as Yuno will not extract this data from encrypted files.

📘

Data transfer security

All data throughout the migration process is encrypted using PGP keys and transferred using SFTP (Secure File Transfer Protocol).

Client-side requirements (step 3)

To successfully complete the token migration process, it is essential to fulfill the client-side requirements outlined in step 3. This involves providing the necessary user data, including the buyers and their existing payment methods.

You can execute the token migration process using the Yuno API, which is specifically designed for merchants. As a merchant, you will use this API to:

  1. Add customers: Register customers in the Yuno system.
  2. Enroll payment methods: Register payment methods obtained from payment processors for each customer in the Yuno system.
📘

API migration option

The API migration option allows merchants to manage their customers and their respective payment data. Learn more

For a detailed guide on performing token migration using the API, click the button below:

Data format

Yuno specifies the required parameters for each customer and credit card to proceed with the migration process. The required parameters are listed below:

  • Account ID
  • Merchant customer ID
  • First name
  • Last name
  • Email
  • Country
  • Document number
  • Document type
  • Payment method type
  • Payment method ID
  • Payment method token

Refer to the Customer Object and Payment Method Object to explore all possible parameters for importing/creating customers or enrolling payment objects.

Technical limitations associated with alternative payment methods may make them ineligible for migration between service providers. If you are considering migrating alternative payment method tokens, such as Mercado Pago Wallet Connect or Bancolombia Tokenbox, to the Yuno vault, please contact the Yuno support team.

Data validation

To ensure efficient processing and prevent delays during the token migration process, please provide the following information when communicating with Yuno Support:

  • The external identifier name that will be used for the import.
  • An approximate count of the expected number of payment methods to be included (a rough estimate is acceptable).
  • Any known data gaps, such as missing names or expiration dates.
🚧

Important notice

Yuno does not validate expiration dates during credit card import.

Data protection

When processing payments through Yuno, the platform connects to payment processors. Yuno tokenizes and encrypts the data to ensure security, simplifying the PCI compliance process. However, you are responsible for managing and protecting your customer's data. Additionally, you must communicate any additional fees or issues to your customer.

Gateway and payment provider requirements

To proceed with the migration process, you will need to provide the following:

  • A public SSH key (you can provide one for production and another for testing). Use the following command to generate it: ssh-keygen -t rsa -b 4096 -C [email protected]
  • The outbound IPs that will be used during the migration.
  • A template file of the data to be migrated to understand its structure. It must include the following mandatory data:
    • Cardholder name: The full name of the cardholder as stored by the current provider.
    • Expiration date: The expiry date of the card.
    • Card number: The complete card number (PAN) that will be tokenized by Yuno.
    • Card ID: A unique identifier assigned to each card by the current provider, used by the client for referencing that card during transactions.

PGP public key

Use our public key to encrypt the PCI-sensitive files you send to Yuno.

Email: [email protected]

Comment: For encrypting sensitive data. Environment: sandbox

Created: 22 Nov 2024

Expires: 22 Nov 2026

Key ID: B342E3D3

Length: 4096

Algorithm: RSA

Fingerprint: 2B37 55FA 426A B1D0 2061 4C6C 919C 4D81 B342 E3D3


Sandbox Key
-----BEGIN PGP PUBLIC KEY BLOCK-----

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
JiRYUpjGug==
=LuK0
-----END PGP PUBLIC KEY BLOCK-----