Self-serve requesting via API is currently in Beta. Endpoints, fields, and webhook payloads may change while we stabilize the flow. For any issues, contact support@tazapay.com.
Before creating a collection account, call the Metadata API to discover which account types, currencies, and payment method types are available for your account.
High-level Flow
1
Onboarding and Approval
Ensure you or your entity has been onboarded on Tazapay and approved by our team before making API calls.
2
Check the Metadata API
Call the Collection Account Metadata API to discover:
- Available payment method types for your account
- Supported currencies and domicile countries
- Transfer limits and
on_behalf_ofrestrictions
3
Create the Account
Call the Collection Account Creation API with your requirements — account type, country, currencies, and payment method type.If Tazapay can fulfill the requirements, a Collection Account object is created with status
disabled and an initial enablement request.4
Track via Webhooks
Subscribe to webhook events to receive real-time status updates as the enablement request progresses. Once the request succeeds, the account status changes to
enabled and is ready to receive funds.Collection Account Status Flow
Every Collection Account has a status — eitherenabled or disabled — that tells you whether it can currently receive funds.
This status is not set directly. Instead, it is determined by the state of requests associated with the account. Each time you want to enable, disable, or re-enable an account, a request is created and goes through its own lifecycle. The account status updates automatically based on how that request progresses.
There are three types of requests:
Each request moves through its own set of states — such as Processing, Requires Action, Approval Hold — before reaching a terminal state (Succeeded, Failed, or Cancelled). The account status at any point reflects the outcome of the most recent request.
The diagram above shows the enablement request flow. For disablement and re-enablement, the account status transitions are reversed — see the table below.
What Each State Means
The states in the diagram are the states of a collection account request (enablement, disablement, or re-enablement). They are not the status of the collection account itself. The account’s status —
enabled or disabled — is what tells you whether it can receive funds at that point in time, and it is derived from how the latest request progresses (see Status by Request State below).Status by Request State
Webhook Events
Subscribe to the following events to track the full lifecycle of your collection account creation requests:Other Ways to Request
Request via Dashboard
Create collection accounts from the Tazapay dashboard. (Beta)
Request via Support Team
Reach out to Tazapay support or your account manager.