Collect payments on behalf of connected accounts
With this model, payments belong to your connected account instead of you as the platform. The connected account is responsible for Payments fees, refunds, and chargebacks. The fund will be split from a connected account to a platform account. It is recommended for the case where the connected account directly interacts with end customers and manages daily transactions, while the platform has limited engagement in every transaction. Typical case includes SaaS platforms.
In this model, the platform will submit all the payments on behalf of the connected account to Airwallex. In order to indicate this relation, you need to specify the account ID of the connected account with the x-on-behalf-of
header.
The below chart illustrates the process of a standard one-off 100 GBP payment in this model.
In the case of Hosted Payment Page/Embedded Fields/Drop-in/Mobile Integration, platform can bypass step 2&3 but needs to create the FundsSplit
request after receiving notifications that the payment is successfully captured.
- Platform creates
payment_intent
with 100 GBP on behalf of connected account with id"acct_ad1KMcnQM2Wmo2PFSuvR2g"
- Platform confirms
payment_intent
on behalf of connected account
- Platform captures
payment_intent
with 100 GBP on behalf of connected account (you can also skip this process by choosing auto capture)
- Platform creates
FundsSplit
with 10 GBP on behalf of connected account, where thesource_id
equals topayment_intent_id
, anddestination
equals to platform account’s ownaccount_id
. Platform can usemetadata
to record values that help better recognition of each split
- Funds will be settled to both parties’ wallets based on split portion, where platform receives 10 GBP as commission and connected account receives 85 GBP (5 GBP Airwallex fees being netted)
If you want to create recurring payments in this model you also need to create and verify a PaymentConsent
on behalf of connected account.