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
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_duVsX6CRTjZah9eKWCKRak" \
  -H "Finix-Version: 2022-02-01" \
  -u USfdccsr1Z5iVbXDyYt7hjZZ:313636f3-fac2-45a7-bff7-a334b93e7bda
Response samples
application/json
{
  • "id": "split_transfer_duVsX6CRTjZah9eKWCKRak",
  • "created_at": "2024-12-20T08:42:50.21Z",
  • "updated_at": "2024-12-20T08:42:50.21Z",
  • "amount": 400,
  • "application_id": "APc9vhYcPsRuTSpKD9KpMtPe",
  • "currency": "USD",
  • "fee": 100,
  • "fee_profile_id": "FPmtT4MYmiAs1qjLjneQmk4d",
  • "identity_id": "IDjvxGeXBLKH1V9YnWm1CS4n",
  • "merchant_id": "MU7noQ1wdgdAeAfymw2rfBMq",
  • "parent_transfer_id": "TRduovg23noL72QBjpDNiiK8",
  • "ready_to_settle_at": "2024-12-23T08:43:03.05Z",
  • "tags": { },
  • "type": "DEBIT",
  • "_links": {}
}

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
Responses
200

List of fees belonging to a Split Transfer.

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_duVsX6CRTjZah9eKWCKRak/fees" \
  -H "Finix-Version: 2022-02-01" \
  -u USfdccsr1Z5iVbXDyYt7hjZZ:313636f3-fac2-45a7-bff7-a334b93e7bda
Response samples
application/json
{}