Multiple Settlement Accounts

This guide will help you understand how to support multi-account settlement routing when required by our banking partner’s compliance policies. As a prerequisite, you should have completed your sandbox integration and are preparing for production readiness.

Overview

In certain cases, your organization will be assigned multiple settlement accounts to isolate the flow of funds across different administrative regions, most typically US States. When this applies, you must ensure that each payment is assigned to the appropriate account, depending on the geolocation of the user performing the payment.

To support this, you will need to:

1. List settlement accounts
2. Assign payment to account

List settlement accounts

Call list-accounts to fetch all available settlement accounts.

This call must be made to the production domain (i.e. api.pushcash.com) and cannot be performed in sandbox.

curl --request GET \
  --url https://api.pushcash.com/accounts/list?type=settlement \
  --header 'Authorization: Bearer $PUSH_API_KEY'

example response

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

If only a single account is returned, no additional action is required — all payments will default to this account.

Assign payment to account

Explicitly tag each intent with the correct account_id based on the geolocation of the user. This allows Push to route funds through the appropriate settlement account to comply with bank-required funds isolation.

• Pass the account_id parameter in requests to create-intent.