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.
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:
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.
example response
If only a single account is returned, no additional action is required — all payments will default to this 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.
account_id
parameter in requests to create-intent
.