How can I prepare for token migration? [Import]

To migrate card details from another payment service provider to the Adyen payments platform, you need to provide us with a CSV file containing the recurring payment details. We will then import this file. After importing, we will send you an output file with the migration results.

Steps you need to take into account:

  1. You need to have a Data Processing Agreement or Data Transfer Agreement with Adyen. If you don't have one or aren't sure whether you have one, please reach out to your point of contact or Adyen support.
  2. Request the export of the card details from your current provider and send them to Adyen for import. Ensure you format the CSV as described in Import payment details for recurring payments
  3. We insist on receiving the card details in a secure manner. Therefore the import file needs to be PGP encrypted. We recommend you always contact Adyen Support to request a PGP key to encrypt these files.
  4. We prefer card details distribution over SFTP (Secure File Transfer Protocol). It is common practice that the party receiving the card data facilitates the SFTP share. To create a merchant specific SFTP for migrations we need the following information:
    • SSH key (2048 or 4096 bits)
    • IP address from which the connection will be made, to be whitelisted by us.
    • Contact information (name, email) of the person connecting to the SFTP.
  5. Decide on an internal shopper reference to use as the Adyen `shopperReference`. Please indicate which column(or value) you would like to use as the `shopperReference`.

 

More information can be found in our documentation.

 

Once the import is finished it will create a result file. We will create a line in the export file for each line in the import file (1 to 1 mapping). The result file contains the following columns:

status, paymentMethodVariant, shopperReference, recurringDetailReference, alias, expiryMonth, expiryYear, bin, cardSummary, issuerCountryCode, echodata, statusMessage, fundingSource.

Learn more

Find more details on this topic.

Go to Adyen Docs
Stylized illustration of a customer support representative with headset.

Do you need additional help?

Contact our support team

Send us the details of your issue by adding images or screenshots.

Submit a request