Log inGet started
Airwallex logo
Core API
Transactional FX
Back to home
OverviewChoose your payments solutionGet started with payments
Online payments
Online payments overviewGet started with online paymentsHosted Payment Page
Drop-in Element
Embedded Elements
Mobile SDK
Native API
Guest user checkoutRegistered user checkoutPlace a hold on a payment methodCancellationsRefundsManage payment credentials
3D Secure authentication
Network TokenizationDevice fingerprintingError response codes
Invoice integrations

Manage payment credentials

When you manage recurring transactions, Airwallex takes care of safely storing your buyer's payment credentials in our secure card vault on your behalf. For security reasons, you cannot retrieve the data in clear and you cannot store the data by yourself unless you have a PCI-DSS AOC.

Retrieve stored credentials

Whenever you need to manage your buyer's credentials or wish to propose the selection of a default one to improve a later checkout experience you can retrieve and list a token associated with each of the stored credentials.

Use GET /api/v1/pa/payment_methods?customer_id=your_customer_id you may also wish to include the type to indicate a specific payment method (i.e. wechatpay, card, etc.)


Update saved card details

Over time, changes in the credentials of your buyer may occur (i.e. a payment card is renewed and the expiry date changes, etc.). You have the possibility to provide those changes to Airwallex and we will update your buyer's payment credentials accordingly.

NOTE: You will only be able to change the cardholder name, and expiry details. In case you wish to create a new set of payment credentials including a new card number a new token will be provided to you.


Delete stored credentials

In case you wish to delete the payment credentials stored in our platform use the endpoint POST /api/v1/pa/payment_methods/{id}/disable to make them not usable anymore.

Those credentials cannot be used to create any new Payment Intent. Existing Payment Intents stay unmodified.