Split Transfers

Transfers can be split among several different Merchants. A split_transfer represents how the funds from a split Transfer were distributed into a Merchants Settlement.

Related Guides: Making a Payment, Split a Transaction

Fetch a Split Transfer

Fetch a split_transfer that was created from a split transaction.

For more information, see Split a Transaction.

Request
path Parameters
split_transfer_id
required
string
header Parameters
Accept
string
Default: application/hal+json
Responses
200

The split_transfer resource that was created from a split transacion.

401

Authentication information is missing or invalid

403

Forbidden

404

Object does not exist

406

Not Acceptable

get/split_transfers/{split_transfer_id}
Request samples 
curl "https://finix.sandbox-payments-api.com/split_transfers/split_transfer_7i2gxncPcfkN5rJwuhrb3q" \
-H "Finix-Version: 2022-02-01" \
-u USsRhsHYZGBPnQw8CByJyEQW:8a14c2f9-d94b-4c72-8f5c-a62908e5b30e
Response samples
application/json
{
  • "id": "split_transfer_7i2gxncPcfkN5rJwuhrb3q",
  • "created_at": "2023-07-19T02:30:17.10Z",
  • "updated_at": "2023-07-19T02:30:17.10Z",
  • "amount": 600,
  • "fee": 0,
  • "currency": "USD",
  • "parent_transfer_id": "TR7h8NxhCDHunLFdJ1HCLp4r",
  • "ready_to_settle_at": "2023-07-19T02:30:18.04Z",
  • "type": "DEBIT",
  • "merchant_id": "MU4jpoNGRkAyjBxumZhGa6Hc",
  • "identity_id": "IDhCtMvcteDx37eD9m4rmdKd",
  • "fee_profile_id": "FPbDSnEPtaT8Nttxj9NJk7eC",
  • "application_id": "APgPDQrLD52TYvqazjHJJchM",
  • "tags": {
    • "key": "value"
    }
}

Fetch Split Transfer Fees

Fetch the fees associated with a split_transfer.

For more information, see Split a Transaction.

Request
path Parameters
split_transfer_id
required
string
header Parameters
Accept
string
Default: application/hal+json
Responses
200

List of Transfer objects

401

Authentication information is missing or invalid

403

Forbidden

404

Object does not exist

406

Not Acceptable

get/split_transfers/{split_transfer_id}/fees
Request samples 
curl "https://finix.sandbox-payments-api.com/split_transfers/split_transfer_7i2gxncPcfkN5rJwuhrb3q/fees" \
-H "Finix-Version: 2022-02-01" \
-u USsRhsHYZGBPnQw8CByJyEQW:8a14c2f9-d94b-4c72-8f5c-a62908e5b30e
Response samples
application/json
{}