How Airwallex payments work

Reserve plan

Fees and pricing models

Settle into your Airwallex balance

Set up your merchant account

Get started with payments

A quick introduction to building with Airwallex APIs

Quickstart

Explore our comprehensive reference to integrate with Airwallex API endpoints

API Reference

Learn how to receive push notifications via webhooks

Webhooks

At Airwallex we have challenged ourselves to create a transaction model that suits your needs and focuses on what you, our merchant, cares about.

The main concepts:

 - A __Payment Intent__ represents the intent of your Customer to complete the checkout (and of course pay for your services). In it, you find represented Payment transactions, Refunds and if things go bad also Chargebacks.

 - A __Payment Attempt__ represents an actual trial to perform a financial transaction. It can be a payment transaction, it can be a refund or even a chargeback. When the customer performs several payment trials before completing the purchase you will have one Payment Attempt for each of the attempts, this way you know what happened and can optimize your checkout. The Payment Attempt tracks each and every individual stage through which the transaction goes.

 - A __Financial Transaction__ represents actual and real money. For each Payment Attempt that reaches completion, our platform will generate one or several Financial Transactions. They represent not only the principal amount of your transaction but also the fees associated with it (including gateway fees, interchange fees, markup, etc.), you will have one financial transaction for each of the financial components that are part of a Payment Attempt. Ultimately, only financial transactions will make it to your Airwallex Balance in form or real money.

Since there will be many Financial Transactions, a __Batch__ groups all the financial transactions that are paid to you (or you have to pay to Airwallex). A Batch will be adjusted for your eventual rolling reserve and will appear as one line in your Airwallex Balance.

![How Airwallex payments work](//images.ctfassets.net/c3n7jozh84hr/3UC3XsIxlDwHZMEQoIbQRw/83b840d57dd6fe4ba40afd7d4447a198/image.png)


What is a reserve plan?

What are the different types of reserves Airwallex offers?

How do I choose my reserve plan?

Where do I view the details of my reserve?

The price for each transaction is composed by three different components that are cumulative to each other:

 - __Gateway fee__, for every transaction Airwallex receives a routing and gateway service is provided to identify the most suitable provider, and provide the added value services we have created.

 - __Payment method fee__, for every transaction Airwallex receives a specific fee will be charged depending on the payment method associated with it.

 - __Fraud Management__ and __3D Secure__, our fraud service leverages large volumes of data and uses 3D Secure services when applicable. A fee will be levied where any of these services is used.

Further to these costs, the following items may also trigger a fee based on the service Airwallex provides you:

 - FX fee, when the processing and settlement currency of your transaction differ, this fee will cover the FX associated costs.

 - Multi-currency Pricing (MCP) and Dynamic Currency Conversion (DCC) fee, wherever you use these additional services a fee is levied to cope for the FX risk that Airwallex offsets on our behalf. The MCP fee is paid by the Merchant, the DCC fee is paid by the Customer.

 - Exception handling fee, for each exception we receive from the card schemes or acquirer (i.e. request for information, disputes, etc.) a fee will be levied to compensate all the parties involved in the handling of the exception.


Understanding Interchange ++ pricing

Understanding Blended pricing

When you set up your account to use Airwallex's payment acceptance solution, consider the following key configuration details. If you need to update your account configuration, contact Airwallex Support. 


PCI DSS certification

Payment methods

Settlement currencies

Follow these steps to get started with Airwallex payments.

1. [Choose the payment solution](/payments__choose-your-payments-solution) that best fits your operating model and business needs.
2. Learn more about payments with Airwallex. 
     - [How Airwallex payments work](/payments__get-started-with-payments__how-airwallex-payments-work)
     - [Reserve plan](/payments__get-started-with-payments__reserve-plan)
     - [Fees and pricing models](/payments__get-started-with-payments__fees-and-pricing-models)
3. (Optional) Get a demo account to explore our product and test your integration. Contact [support](https://help.airwallex.com/hc/en-gb/requests/new) to submit a request for a demo account. When you submit the request, please select the following:
    - *Issue* category: __Payments__
    - *Sub-issue* category: __I want to get started with Payments__
    - *Subject*: __Apply for a demo account__
4. [Set up your Airwallex account](/payments__get-started-with-payments__set-up-your-merchant-account) and activate payments capabilities.
5. Start building your integration for your chosen payment solution using our integration guides for online payments, payment links, and invoices. 


docsLogo

 Desktop/Mobile Website Browser

 Save bank details for future payments

 Micro-deposit verification

 EFT Pre-Authorized Debit - BETA

Embedded KYC RFI component

Hosted KYC RFI flow

Native KYC RFI API

Handle KYC RFI

Handle KYC Request for Information (RFI)

Hosted Transaction RFI flow

Embedded Transaction RFI component

Native Transaction RFI API

Handle Transaction RFI

Handle Transaction Request for Information (RFI)

RFI (Request for Information)

Native Cardholder RFI API

Handle Cardholder RFI

Handle Cardholder Request for Information (RFI)

Cardholder types

Cardholder statuses

Create cardholders

Desktop/Mobile Website Browser - Klarna

Dispute Management - Klarna

Extra Merchant Data (EMD) - Klarna

Klarna

Dispute Flow

Handling Disputes

Dispute Notifications

Pay with QR Code (Desktop Website Browser) - WeChat Pay

Mobile App - WeChat Pay 

WeChat Official Account - WeChat Pay

WeChat Mini Program - WeChat Pay

Mobile Browser (H5) - WeChat Pay

Customs Declaration - WeChat Pay

Funds Split - WeChat Pay

WeChat Pay

Refunds

Funds reconciliation

Pay with QR Code (Desktop Website Browser) - Touch 'n Go

Mobile Website Browser - Touch 'n Go

Mobile App - Touch 'n Go

Touch 'n Go

Pay with QR Code (Desktop Website Browser) - Rabbit LINE Pay

Mobile Website Browser - Rabbit LINE Pay

Mobile App - Rabbit Line Pay

Rabbit LINE Pay

Pay with QR Code (Desktop Website Browser) - GCash

Mobile Website Browser - GCash

Mobile App - GCash

GCash

Pay with QR Code (Desktop Website Browser) - DANA

Mobile Website Browser - DANA

Mobile App - DANA

DANA

Pay with QR Code (Desktop Website Browser) - TrueMoney

Mobile Website Browser - TrueMoney

Mobile App - TrueMoney

TrueMoney

Pay with QR Code (Desktop Website Browser) - Kakao Pay

Mobile Website Browser - Kakao Pay

Mobile App - Kakao Pay

Kakao Pay

Mobile App - Alipay CN

Mobile Website Browser - Alipay CN

Mini Program - Alipay CN

Customs Declaration - Alipay CN

Pay with QR Code (Desktop Website Browser) - Alipay CN

Alipay CN

Mobile App - Alipay HK

Mobile Website Browser - Alipay HK

Pay with QR Code (Desktop Website Browser) - Alipay HK

Alipay HK

Transaction failure reasons

Physical and digital cards (older API versions)

Create individual cards (older API versions)

Card statuses

Create a card (older API versions)

Physical and digital cards

Create commercial cards

Create consumer cards

Whitelabel card offering

Create cards

Choose your issuing solution

Supported card programs

3D Secure authentication

Fund your issuing balance (older API versions)

Choose your issuing solution (older API versions)

Supported card types (older API versions)

Secure iframes

Retrieve sensitive card details

Fund your issuing balance

Platform issuing infrastructure for businesses

Consumer payouts via cards

Batch transfers

Payout statuses

Generate a confirmation letter

Simulate payout status transition

Create a payout

 Payout error codes

Batch transfer error codes

Manage approvals for batch transfers

Manage batch transfers

Retrieve batch transfers

Batch transfer statuses

Create a batch transfer

Issuing

Powerful and flexible APIs to programmatically manage your money

Core API

APIs and components to build your own global financial products

Embedded Finance

Accept one-time and recurring payments, with like-for-like settlement for multiple currencies

PaymentsActive

PaymentsNormal

Accept payments from your customers around the world with cards and 160+ alternative payment methods. 

Overview

Payments

Choose your payments solution

Online payments

Payment Links

Invoice integrations

Manage payments

Test and go live

Troubleshooting

Access interbank FX rates and intelligently manage currency risk

FXActive

FXNormal

Access interbank FX rates and programmatically manage currency risk.

Transactional FX

How Transactional FX works

Supported regions and currencies

Funding and settlement models

Use Cases

Get started

Amendments

Programmatically make cost effective, fast and secure global payouts 

PayoutsActive

PayoutsNormal

Programmatically make cost-effective, fast and secure payouts across the globe.

Payouts

How Airwallex Payouts work

Payout network

Use cases

Beneficiaries

Payers

Errors

Older API versions

Issue and manage multi-currency cards at scale, while reducing international transaction and FX fees

IssuingActive

IssuingNormal

Issue and manage multi-currency cards at scale, while reducing international transaction and FX fees.

How Airwallex Issuing works

Manage cards

Card controls

Transactions

Older Issuing APIs

Enable your customers to collect, store, and disburse funds globally

GTActive

GTNormal

Enable your customers to collect, store, and disburse funds worldwide using Airwallex's powerful global treasury infrastructure.

Global Treasury

Understanding Global Treasury

Market & infrastructure coverage

Global Treasury: Market & infrastructure coverage

Receive funds

Hold & convert funds

Process payouts

Connected accounts

Platform operations

Risk

Offer a full-featured fintech solution including accounts and card issuing

Banking as a service icon for an active state

BaaSActive

Banking as a Service icon for a normal state

BaaSNormal

Unlock new lines of revenue by natively embedding global banking capabilities into your platform.

Banking as a Service