Log inGet started
Airwallex logo
Core API
Transactional FX
Back to home
OverviewChoose your payments solutionGet started with payments
Online payments
Invoice integrations
Test and go live
Integration checklistTest card numbersCard data migration

Card data migration

If you are a merchant collecting payments with stored credentials then it is possible that these details are stored with your previous processor. Merchants can easily continue to collect payments following these steps with Airwallex as their new processor:

  • Notify current processor
  • Receive encrypted file from current processor and share with Airwallex to start migration
  • Receive output report from Airwallex (post completion of Migration)
  • Continue with subsequent payments collection

Card migration service 1X representation

Support Matrix

Card brandsSupportedRegion
AMEXComing soonGlobal
UnionPayComing soonGlobal
JCBComing soonGlobal

Detailed migration steps

  1. Notify current processor

As a merchant you need to initiate the migration process with your current processor. It is recommended to get in touch with your Account manager directly to ensure that your request is promptly acted upon.

Your current processor will need the details of the new processor to be able to encrypt the export file and validate PCI certifications as per standards, Please share this link with your current Acquirer.

This process can take some time to complete, please ensure to plan your steps to avoid any problems with payments collection during a billing period (Merchant initiated transactions) or with payment processing for consumer initiated transactions.

Refer this link to understand how Stripe enables merchants to migrate their payment information to other processors.

  1. Receive encrypted file and start with migration

Your current processor will encrypt the payment information using the PGP public key published by Airwallex, export this information into a file format and share it with you. Forward this file to Airwallex for further processing.

Airwallex will decrypt the payment information in the provided file, register payment consent information against the merchant account (merchant should complete KYB process with Airwallex) and verify the card details to complete the migration process.

Airwallex will validate the file for key fields which are required to process subsequent payments without any problems. Below is the list of fields, please ensure that your current processor can provide this information in the export file.

  • Customer Identifier : Identified by merchant, will be used as link with Airwallex generated payment consent ID
  • Transaction triggered by : Merchant (MIT) / Consumer (CIT)
  • Parent Transaction ID : Initial / previous transaction identifier to establish relationship
  • Merchant trigger reason : Scheduled / Unscheduled (Only when MIT)
  1. Receive output report from Airwallex

Airwallex will share the output report detailing the status of each payment record post completion of the migration process. Merchant should use this file to update your billing systems to be able to invoke subsequent payments using Payment consent ID & customer ID generated by Airwallex and provided in this file.

Format of this output file along with a sample record

Airwallex consent IDAirwallex customer IDAirwallex payment method IDExternal Card IDExternal customer IDMigration failure reasonMigration finish timeIs verified

Any errors or exceptions in the payment details should be managed by the merchant. Example: Account verification failed during the migration process due to expiry of the card. Merchant in this case will find the payment record with status : Verification failed in the output report. Merchant should then reach out to the consumer for updated payment details to be able to continue billing.

  1. Initiate subsequent payment collection

You can now initiate subsequent payments collection using the key identifiers provided in the output report : Customer ID & Payment Consent ID.

You can find more details on steps to be followed here based on your integration with Airwallex.


  1. Are there any additional charges for this service? Airwallex doesn’t charge merchants using this service.
  2. How does this migration impact 3DS processing? If you are using Airwallex to process 3DS authentication then there is no impact. 3DS authentication can be triggered based on transaction type (CIT) + Risk assessment result or due to PSD2 SCA mandate (when applicable)
  3. As a merchant, can we use an external 3DS service provider or an external risk service provider? Yes, this is possible. Please discuss this with your account manager.
On this page
  • Support Matrix
  • Detailed migration steps
  • FAQs