How can I prepare for token migration? [Export]
Migrating card details to another payment service provider contains sensitive payment card information from the Adyen platform. As you are the owner of this data, Adyen will of course comply with this request. We prefer to carefully plan this process in advance, in case you have a date in mind please share it with us.
The following steps outline the card data migration process:
- 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.
- Provide valid PCI Attestation of Compliance (AoC) of the new Service Provider
- Provide a publicly listed PGP key for encryption. We will review if the key belongs to a PCI-DSS certified processor who is allowed to manage payment card information, therefore the key must be referenced on the new service provider's website.
- Adyen prefers distribution over SFTP (Secure File Transfer Protocol). It is common practice that the party receiving the card data facilitates a SFTP share. Can you please confirm if the new service provider can provide an SFTP server, and indicate if there is any information you need from our side to create it?
- Can you please indicate the scope of the migration. E.g. include all card data stored under a company/merchant account or a specific list of shopperReferences. If you want to specify the exact shopper references you want to export, you can share a specific file. The format of a specific file should be: "MerchantAccount,ShopperReference".
Once you gathered the required information above, please send a ticket to our support team so we can take it from there.Â
Once we have received all the required information, an export will be executed with a limited scope (1000 shopper references). The new vault can use this sample file to verify they can properly decrypt and ingest the file. When the new vault confirmed they received and can use the file format, we proceed with the full export.
Adyen exports card data in the following CSV format. Please see below:
account,shopperReference,shopperEmail,recurringdetailreference,txvariantCode,cardNumber,expiryMonth,expiryYear,ownerName,countryCode,iban,bic,bankLocation,bankName,bankLocationId,bankAccountNumber,BillingAgreementId,PayerId,PayPalBuyerEmailId,billingStreet,billingHouseNumberOrName,billingCity,billingPostalCode,billingStateOrProvince,billingCountry,issuerCountryCode,cardAlias,cardBin,cardSummary,networkTxReference,merchantAccountShopperCreation,klarnaTokenId,klarnaVariant,klarnaCountry,billDeskVariant,billDeskMandateId,billDeskMandateMaxAmount,billDeskMandateFrequency,billDeskSubscriptionRefId,mandateTxVariant,mandateProviderId,mandateId,mandateStatus,mandateFrequency,mandateAmount,mandateAmountRule,mandateBillingAttemptsRule,mandateBillingDay,mandateCurrency,mandateStartsAt,mandateEndsAt,mandateAccountId,mandateRemarks
Note: Customisation of this format is currently not possible.
Note: The field recurringDetailReference is Adyen's unique reference to a card.