Requesting via API

Create Collection Accounts (Virtual Accounts and Stablecoin Wallets) programmatically using the Tazapay API

You can create Collection Accounts (Virtual Accounts and Stablecoin Wallets) for yourself or your customers programmatically via the Tazapay API. Before creating, make sure you meet the prerequisites.

---

High-level Flow

1. Onboarding and Approval

   Ensure you or your entity meets the prerequisites 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 other features

   This is an optional step and can be skipped if you already have the capabilities and coverage.

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 — either enabled or disabled — which tells you whether it can currently receive funds.

The status 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:

Request Type	What it does
Enablement	Activates the account so it can start receiving funds. Created automatically when the account is first set up. Also created when a previously disabled account is re-enabled.
Disablement	Deactivates the account so it stops accepting incoming payments.

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, 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).

Request State	Meaning
Processing	The request has been accepted and Tazapay is working through it.
Requires Action	Tazapay needs additional input or action from you before the request can continue.
Approval Hold	The entity on behalf of which the collection account is created requires approval before the request can proceed.
Succeeded	(Terminal) The request completed successfully. For an enablement request, the account status becomes enabled; for a disablement request, it becomes disabled.
Failed	(Terminal) The request could not be completed. The account status is unchanged from before the request.
Cancelled	(Terminal) The request was cancelled before completing. The account status is unchanged from before the request.

Status by Request State

Request State	Account Status — Enablement	Account Status — Disablement
Processing	Disabled	Enabled
Requires Action	Disabled	Enabled
Approval Hold	Disabled	Enabled
Succeeded	Enabled	Disabled
Failed	Disabled	Enabled
Cancelled	Disabled	Enabled

---

Webhook Events

Subscribe to the collection_account.* webhook events to track the full lifecycle of your creation and disablement requests — every event name and sample payload is documented in the Collection Account Webhooks reference.

---

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.