Log inGet started
Airwallex logo
Home
Online Payments
Treasury
Transactional FX
Payouts
Issuing
Scale
Open Banking
Developer Tools
API Reference
Home
Online Payments
Overview
Starting with paymentsTransaction and settlement modelPricing model
Payment Methods
OverviewGlobalEU & UKAPAC
APAC RegionalAustraliaChina
AlipayWeChat Pay
Website QRMobile App Mobile Browser (H5)WeChat Official AccountWeChat Mini Program Customs Declaration WeChat Pay funds split
Hong KongIndonesiaJapanKoreaMalaysiaPhilippinesSingaporeThailandTaiwan
US & LATAM

WeChat Pay funds split

Enables you to split funds received from WeChat Pay payments

The WeChat Pay funds split feature targets e-commerce businesses selling goods from overseas to shoppers in Mainland China.

With such businesses, you will typically need to manage two types of payables:

  • Payables to overseas suppliers: Cost of goods and other fees
  • Payables to suppliers in Mainland China: Taxes, marketing fees, logistic fees, etc

The funds split solution enables you to manage your funds and payables more efficiently and effectively by:

  • Settling funds to your Airwallex Wallet for payouts to your overseas (offshore) suppliers when needed
  • Settling funds directly to the WeChat Pay wallets of your Chinese onshore suppliers when needed, within 180 days after the transaction.

The funds split feature can only be used for true, legal and reasonable transactions within Mainland China that directly involve cross-border payments.

How it works

The diagram depicts how Airwallex facilitates funds split for WeChat Pay payments. WeChat funds split

Supported features

Payment methodWeChat Pay
Merchant entitiesHK
Transaction currencyCNY only
Settlement currencyHKD
Merchant MCCeCommerce only
Max. no. of splits50 times per transaction, i.e., PaymentIntent (This is an API upper bound. Typically splits are completed within ~5 times)
Max. WeChat Pay wallet settlement %30% of the transaction amount Merchants can apply for higher WeChat Pay settlement % by application.
Funds split session timeoutWithin 180 days after the transaction is completed AWX settles remaining amount to merchants automatically after 180 days
Settlement scheduleWeChat Pay wallet settlement: near-real-time settlement Airwallex wallet settlement: T+2 business days (T as the day merchant requests funds split)
RefundsYes Note: WeChat Pay wallet settled amount is NOT refundable due to the Chinese_SAFE_regulation on international revenue and expenditure declaration. It's strongly recommended that merchants issue WeChat Pay funds splits after all refunds have been completed.
Integration optionAPI only

Step 1: Create a funds split destination for your onshore WeChat Pay suppliers

Funds split receivers are the onshore WeChat Pay wallets where split funds are settled. Airwallex currently supports the following receiver types: MERCHANT_ID, PERSONAL_OPENID, PERSONAL_SUB_OPENID and OFFSHORE_SETTLEMENT. OFFSHORE_SETTLEMENT should be used for offshore settlements (see Step 2) while other receiver types should be used when splitting funds to onshore receivers.

Before creating a funds split destination to these receivers, you must first obtain the application_file_id and/or partnership_file_id by uploading the documents via Upload a file API.

  • application_file_id: The document ID of the application letter for the funds split receiver.
  • partnership_file_id: The document ID of the cooperative relationship certificate between the funds split initiator and receiver. Required if the receiver type is MERCHANT_ID.
Shell
Example request
JSON
Example response

Next, you must identify the funds split receivers by creating a funds split destination for your onshore Mainland China suppliers.

You can retrieve a FundsSplitDestination object by calling Retrieve a FundsSplitDestination API with the FundsSplitDestination ID in the endpoint URL. Airwallex recommends that you set up webhook events for the FundsSplitDestination object to receive notifications on status updates. See Listen for webhook events.

You can disable a FundsSplitDestination object using Disable a FundsSplitDestination API

Shell
Example request
JSON
Example response

Step 2: Create a funds split destination for your Airwallex Wallet

Create a funds split destination to settle to your Airwallex Wallet.

Set up webhook events for the FundsSplitDestination object to receive notifications on the status updates. See Listen for webhook events.

Shell
Example request
JSON
Example response

Step 3: Create a PaymentIntent

When the checkout page loads, on your server, call Create a PaymentIntent API with an amount and currency to indicate your intent to collect payment from the shopper.

Shell
Example request
JSON
Example response

Step 4: Confirm the PaymentIntent

When a WeChat Pay transaction is initiated, confirm the PaymentIntent with enable_funds_split set to true to tag the transaction for Wechat Pay funds split. This transaction will NOT be settled according to the normal schedule, but will be withheld by Wechat Pay until it recieves instruction from you to split the funds.

Shell
Example request
JSON
Example response

Step 5: Initiate funds split to your Airwallex Wallet

When you decide to settle funds to your Airwallex Wallet, create a FundsSplit object after the payment is successfully captured.

You can repeat this step and Step 6 until the transaction is fully split for settlements. Alternatively, you can release the remaining funds using Release a FundsSplit API after the payment is successfully captured. Any remaining funds will be settled to your Airwallex Wallet after 180 days of payment creation.

To retrieve an existing FundsSplitDestination object, call Retrieve a FundsSplit API with the FundsSplit ID in the endpoint URL.

Shell
Example request
JSON
Example response

Step 6: Initiate funds split to your onshore WeChat Pay suppliers

After you complete all refunds that are required for the transaction, you can send funds to your onshore suppliers in Mainland China, by creating the FundsSplit object after the payment is captured. WeChat Pay will then settle CNY to your suppliers' Wechat Pay wallets.

You can repeat Step 5 and this step until the transaction is fully split for settlements. Alternatively, you can release the remaining funds using Release a FundsSplit API after the payment is successfully captured. Any remaining funds will be settled to your Airwallex wallet after 180 days of payment creation.

Shell
Example request
JSON
Example response
On this page