Handle multiple settlement accounts

Goal

Enable routing of payments to the correct settlement account when your organization is assigned multiple accounts.

If your organization is not subject to a funds isolation requirement and will process transactions through a single settlement account, you can skip this guide.

Steps

Step 1: Receive account identifiers

What you need to do

Fetch the list of settlement accounts assigned to your organization and retain their account_id values.

How to do it

• Call the list-accounts endpoint.

Step 2: Pass account identifiers in payment requests

What you need to do

Include the correct account_id on all payment submissions when multiple settlement accounts exist.

How to do it

• Update requests to create-intent and authorize-payment to include the relevant account_id parameter

This allows Push to determine how the payment should be settled.

If you omit account_id while multiple accounts exist, the request will fail

List Accounts

curl --request GET \
  --url https://api.pushcash.com/account/list \
  --header 'Authorization: Bearer <token>'

Accounts List

{
  "data": [
    {
      "id": "account_7xvtLBSR1SKTDNjfgRRoSE",
      "type": "settlement",
      "name": "Sportsbook NJ",
      "balance": 0,
      "created_at": "2024-01-01T17:50:43Z"
    },
    {
      "id": "account_meBdiVBJc6QMVyxVwdR0QE",
      "type": "settlement",
      "name": "Sportsbook AZ",
      "balance": 0,
      "created_at": "2024-01-01T17:55:12Z"
    }
  ]
}

Integration Checklist

• Retrieve settlement accounts identifiers from the API
• Implement logic to select the appropriate settlement account for a given payment request
• Pass account_id in all /intent and /authorize requests