Funds Split - WeChat Pay
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.
Supported features
| Payment method | WeChat Pay |
|---|---|
| Merchant entities | HK |
| Transaction currency | CNY only |
| Settlement currency | HKD |
| Merchant MCC | eCommerce only |
| Max. no. of splits | 50 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 timeout | Within 180 days after the transaction is completed AWX settles remaining amount to merchants automatically after 180 days |
| Settlement schedule | WeChat Pay wallet settlement: near-real-time settlement Airwallex wallet settlement: T+2 business days (T as the day merchant requests funds split) |
| Refunds | Yes 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 option | API only |
Before you begin
- Contact your Airwallex Account Manager to enable API for your Airwallex account.
- Obtain your access token API by authenticating to Airwallex using your unique Client ID and API key. You will need the access token to make API calls.
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 isMERCHANT_ID.
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
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.
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.
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.
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.
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.