Funds reversed from connected account(s)

With this model, payments belong to the platform account solely. The platform account is responsible for Payments fees, refunds, and chargebacks. Normally the majority of funds will be split into one or many connected accounts. So when the payments finally end up being refunded or chargeback, it is likely that the platform wants to reimburse the deficit by taking back the funds.

The below chart illustrates how a standard one-off 100 GBP payment is split and reversed between the Platform and connected account in this model.

1. Platform creates payment_intent with 100 GBP with connected account id "acct_ad1KMcnQM2Wmo2PFSuvR2g"

Shell
1$ curl --request POST \
2> 'https://api-demo.airwallex.com/api/v1/pa/payment_intents/create' \
3> -H 'Content-Type: application/json' \
4> -H 'Authorization: Bearer eyJhbGciOiJIUzI1NiJ9.eyJzdWIiOiJ0b20iLCJyb2xlcyI6WyJ1c2VyIl0sImlhdCI6MTQ4ODQxNT I1NywiZXhwIjoxNDg4NDE1MjY3fQ.UHqau03y5kEk5lFbTp7J4a-U6LXsfxIVNEsux85hj-Q' \
5> -d'{
6  "request_id": "ee939540-3203-4a2c-9172-89a566485dd9",
7  "merchant_order_id": "cc9bfc13-ba30-483b-a62c-ee925fc9bfea",
8  "amount": 100,
9  "currency": "GBP"
10}'

2. After payment has been successfully captured, Platform creates two FundsSplit with 40 GBP going to one connected account and 30 GBP to the other. Funds are settled in all parties’ wallets.

Shell
1$ curl --request POST \
2> 'https://api-demo.airwallex.com/api/v1/pa/funds_splits/create' \
3> -H 'Content-Type: application/json' \
4> -H 'Authorization: Bearer eyJhbGciOiJIUzI1NiJ9.eyJzdWIiOiJ0b20iLCJyb2xlcyI6WyJ1c2VyIl0sImlhdCI6MTQ4ODQxNT I1NywiZXhwIjoxNDg4NDE1MjY3fQ.UHqau03y5kEk5lFbTp7J4a-U6LXsfxIVNEsux85hj-Q' \
5> -d'{
6   "request_id": "ee939540-3203-4a2c-9172-89a566485dd9",
7   "source_id":  "int_e65tkXCSzJrsMpTrzoFrjaau53",
8   "source_type":"PAYMENT_INTENT",
9   "amount": 40, 
10   "destination":"acct_ij2YyjhFNv-BGPsjqHuI3w",
11   "metadata": { 
12       "reason": "disbursement to seller A"
13   }
14}'

Shell
1$ curl --request POST \
2> 'https://api-demo.airwallex.com/api/v1/pa/funds_splits/create' \
3> -H 'Content-Type: application/json' \
4> -H 'Authorization: Bearer eyJhbGciOiJIUzI1NiJ9.eyJzdWIiOiJ0b20iLCJyb2xlcyI6WyJ1c2VyIl0sImlhdCI6MTQ4ODQxNT I1NywiZXhwIjoxNDg4NDE1MjY3fQ.UHqau03y5kEk5lFbTp7J4a-U6LXsfxIVNEsux85hj-Q' \
5> -d'{
6   "request_id": "ee939540-3203-4a2c-9172-89a566485dd9",
7   "source_id":  "int_e65tkXCSzJrsMpTrzoFrjaau53",
8   "source_type":"PAYMENT_INTENT",
9   "amount": 35, 
10   "destination":"acct_aD5rChdqMoCkSn3WseuKLw",
11   "metadata": { 
12       "reason": "disbursement to seller B"
13   }
14}'

3. The platform creates two FundsSplitReversal mapping with each FundsSplit to take the money back. Both connected accounts will be deducted with the amount after the settlement cycle and the platform will be settled with 70 GBP in total as the result.

Shell
1$ curl --request POST \
2> 'https://api-demo.airwallex.com/api/v1/pa/funds_split_reversals/create' \
3> -H 'Content-Type: application/json' \
4> -H 'Authorization: Bearer eyJhbGciOiJIUzI1NiJ9.eyJzdWIiOiJ0b20iLCJyb2xlcyI6WyJ1c2VyIl0sImlhdCI6MTQ4ODQxNT I1NywiZXhwIjoxNDg4NDE1MjY3fQ.UHqau03y5kEk5lFbTp7J4a-U6LXsfxIVNEsux85hj-Q' \
5> -d'{
6   "request_id": "ee939540-3203-4a2c-9172-89a566485dd9",
7   "amount": 40, 
8   "funds_split_id": "spt_hkpdlwkjcg6cx3vss1w", 
9   "metadata": { 
10       "reason": "reimburse from seller A as the item has been refunded"
11   }
12}'

Shell
1$ curl --request POST \
2> 'https://api-demo.airwallex.com/api/v1/pa/funds_split_reversals/create' \
3> -H 'Content-Type: application/json' \
4> -H 'Authorization: Bearer eyJhbGciOiJIUzI1NiJ9.eyJzdWIiOiJ0b20iLCJyb2xlcyI6WyJ1c2VyIl0sImlhdCI6MTQ4ODQxNT I1NywiZXhwIjoxNDg4NDE1MjY3fQ.UHqau03y5kEk5lFbTp7J4a-U6LXsfxIVNEsux85hj-Q' \
5> -d'{
6   "request_id": "ee939540-3203-4a2c-9172-89a566485dd9",
7   "amount": 30, 
8   "funds_split_id": "spt_hkpdp89lhg6cn6p4nhg", 
9   "metadata": { 
10       "reason": "reimburse from seller B as the item has been refunded"
11   }
12}'