Transfer sub-entity funds

Last updated: July 26, 2023

While managing the sub-entities on your platform, those on the full account type may need to transfer money to recoup funds from a seller, return money from a refund or to make up the difference when running a promotion.

Information

Funds from all customer chargebacks will be deducted from your currency account (the platform). Use this transfer functionality to return sub-entity funds as appropriate.

To start making transfers, you must be on the Full account type.
Onboard your sub-entities to our Integrated Platforms solution.
Make the first payment on behalf of your sub-entity.
Sign up to receive a webhook notification for transfer_status_changed.

Information

Transfers can only be requested between different entity levels — transfers between two sub-entities will not be accepted. Transfers must also be performed between currency accounts which hold the same currency.

From the Dashboard home page, go to Sub-entities, then select a sub-entity from the list. This will open the Sub-entity details page.

The Sub-entity details page displays the sub-entity balance and a list of recent transfers.

To request a new transfer:

Select Transfer. This will take you to a full screen
Select whether you would like to transfer funds to or from the sub-entity
Select either the source or destination of the transfer from the drop-down
Specify the amount to transfer
Select a reason for the transfer, and enter an optional reference
Select Transfer funds

To get a detailed view of all required and optional fields, see our API reference.

Note

The transfers.checkout.com sub-domain is slightly different to Checkout.com's other endpoints.

post

https://transfers.checkout.com/transfers


1{
2  "reference": "superhero1234",
3  "transfer_type": "commission",
4  "source": {
5    "id": "ent_azsiyswl7bwe2ynjzujy7lcjca",
6    "amount": 100
7  },
8  "destination": {
9    "id": "ent_w4jelhppmfiufdnatam37wrfc4"
10  }
11}


1{
2  "id": "tra_y3oqhf46pyzuxjbcn2giaqnb4",
3  "status": "pending",
4  "_links": {
5    "self": "https://transfers.checkout.com/transfers/tra_y3oqhf46pyzuxjbcn2giaqnb4"
6  }
7}

The state of the payment is pending until the transfer is confirmed. Use the Balances API to check the funds have gone to the requested entity.

To get a detailed view of all required and optional fields, see our API reference.

get

https://transfers.checkout.com/transfers/{id}


1{
2  "id": "tra_y3oqhf46pyzuxjbcn2giaqnb4",
3  "reference": "superhero1234",
4  "status": "pending",
5  "transfer_type": "commission",
6  "requested_on": "2021-12-15T09:15:02.3845763Z",
7  "source": {
8    "entity_id": "ent_azsiyswl7bwe2ynjzujy7lcjca",
9    "amount": 100,
10    "currency": "GBP"
11  },
12  "destination": {
13    "entity_id": "ent_bqik7gxoavwhmy3ot6kvmbx6py"
14  },
15  "_links": {
16    "self": "https://transfers.checkout.com/transfers/tra_y3oqhf46pyzuxjbcn2giaqnb4"
17  }
18}

For visibility on what's going on with your transfers, we have created a webhook event called transfer_status_changed. It triggers every time the status of a transfer has changed.

There are 3 statuses:

Pending: Triggered when you create the transfer request
Completed: Triggered when the transfer has been completed successfully
Rejected: Triggered when the transfer was unsuccessful

To view the status of the transfer, view the data object, where you will be able to see the status field. See the following example webhook payloads.


1{
2  "id": "evt_htielsmgcwgejgqaunl4yb2pou",
3  "type": "transfer_status_changed",
4  "version": "1.0.0",
5  "created_on": "2020-08-20T15:24:13.8431084Z",
6  "data": {
7    "transfer_id": "tra_6u262tenielmkj4cb5swqna6sy",
8    "status": "Pending",
9    "reference": "This is a reference"
10  },
11  "_links": {
12    "self": {
13      "href": "https://api.sandbox.checkout.com/workflows/events/evt_htielsmgcwgejgqaunl4yb2pou"
14    }
15  }
16}


1{
2  "id": "evt_htielsmgcwgejgqaunl4yb2pou",
3  "type": "transfer_status_changed",
4  "version": "1.0.0",
5  "created_on": "2020-08-20T15:24:13.8431084Z",
6  "data": {
7    "transfer_id": "tra_6u262tenielmkj4cb5swqna6sy",
8    "status": "Completed",
9    "reference": "This is a reference"
10  },
11  "_links": {
12    "self": {
13      "href": "https://api.sandbox.checkout.com/workflows/events/evt_htielsmgcwgejgqaunl4yb2pou"
14    }
15  }
16}


1{
2  "id": "evt_htielsmgcwgejgqaunl4yb2pou",
3  "type": "transfer_status_changed",
4  "version": "1.0.0",
5  "created_on": "2020-08-20T15:24:13.8431084Z",
6  "data": {
7    "transfer_id": "tra_6u262tenielmkj4cb5swqna6sy",
8    "status": "Rejected",
9    "reference": "This is a reference"
10  },
11  "_links": {
12    "self": {
13      "href": "https://api.sandbox.checkout.com/workflows/events/evt_htielsmgcwgejgqaunl4yb2pou"
14    }
15  }
16}

Information

Understand why a transfer was rejected by either:

Signing in to the Dashboard and going to the sub-entity details page
Using the retrieve a transfer endpoint

Transfer sub-entity funds

Information

Before you begin

Information

Request a transfer through the Dashboard

Request a transfer using the API

Note

Request example

Response example

Retrieve a transfer

Response example

Transfer statuses

Examples

Information