When we provision an Account Float for you, you will have at least two possible accounts to transact with

  • the Bank Account used to register your Split account (Primary account)
  • and your new Account Float.

We refer to both types of accounts as Funds Accounts.

Selecting Funds Account on a per-transaction basis via the Split API

You can choose which Funds account to use for a particular transaction by passing in the your_bank_account_id field. You must provide this field if you would like to transact with an Account Float.

If you haven't retrieved an ID already, you'll need to know the ID of the funds account that you wish to use for a particular transaction. Find out how to get this information in this article.

Next, set the your_bank_account_id field to your preferred funds account ID when creating a Payment (Payout), Payment Request or Refund.

Example payload for a Payment Request using the your_bank_account_id field

payload = {
"description": "Visible to both initiator and authoriser",
"matures_at": str(datetime.datetime.utcnow()),
"amount": 1000,
"authoriser_contact_id": {contact_id},
"your_bank_account_id": "01b01b35-08d1-4ef9-a82c-040a0070fb2e",
"metadata": {
"custom_key": "Custom string",
"another_custom_key": "Maybe a URL",
"remitter": "Your remitter"

This endpoint is described in more detail in our documentation.

Default Funds Account:

Within Split, the Bank Account that you used to register with us is marked as the Primary account. If you do not provide us with the your_bank_account_id the field in a transaction payload, this Primary account which may result in slower settlement.

Did this answer your question?