Stablecoin Payouts

Stablecoin Payouts let clients send stablecoins from a Cobre Balance to a verified Global counterparty's wallet. Two Money Movement types are available depending on the source balance.

Sending a Stablecoin Payout

MM `type`	Source balance	Destination
`stable_payout`	`usd_stable` balance (`pr_stable_omnibus_cobre`)	Global counterparty (`global_deposit_le` / `global_deposit_np`)
`global`	`usd` Global fiat balance (`pr_global_cobre`)	Global counterparty (`global_deposit_le` / `global_deposit_np`) — funded via automatic on-ramp

Both types are created through the same Create a Money Movement API — Cobre infers the type from the source_id account's provider. For the global variant (payout funded from a fiat balance), see the existing Global payouts in stable guide, which covers supported chains, tokens, and counterparty types in detail.

stable_payout is only available for usd_stable balances. copco balances do not support payouts — they are closed loop.

Key Terms

Stable Payout: A payout sent directly from a usd_stable balance (stable_payout type).

Global Payout: A payout sent from a Global fiat balance, funded via automatic on-ramp into stablecoins (global type).

Global Counterparty: The verified beneficiary wallet that receives the payout — see Managing Counterparties.

Payout lifecycle

A stablecoin Payout follows a simple lifecycle:

1. Create a counterparty (beneficiary)
Create a counterparty of type global_deposit_le or global_deposit_np with the beneficiary's wallet information and wait for verified status.

See 🔗 Create a Counterparty and Managing Counterparties.

2. Create a Money Movement
Create a Money Movement using:

The account_id (usd_stable or Global fiat balance) from which the funds will be debited, used as the source_id.

The counterparty_id from the previous step as the destination_id.

The amount provided in the smallest unit of the currency.

See 🔗 Create a Money Movement.

3. The Money Movement is processed
Once created, the Money Movement starts in the initiated status. If all validations pass, the status changes to processing and the transaction is broadcast on-chain.

4. Wait for the final outcome of the Money Movement

If completed, the beneficiary has received the funds and tracking_key contains the on-chain hash.

If failed or rejected, the funds are automatically credited back to the source balance.

Track the resulting transactions via 🔗 Obtain one Transaction or 🔗 Obtain all Transactions.

5. Receive status updates
Money Movement status changes are communicated via Webhooks.

Allowed Actions on Stablecoin Payouts

🔑 Create

🔍 Retrieval

Description: Creates a Money Movement of type stable_payout or global.
What to expect after the action: A Money Movement in initiated status, progressing through processing to completed, failed, or rejected.
📘 Learn more:

🔗 Create a Money Movement

How to Get Started

Create a global_deposit_le or global_deposit_np counterparty and wait for verified status before attempting a payout. See Managing Counterparties.

Fund the source balance

Ensure the source balance (usd_stable or Global fiat) has sufficient funds before creating the payout.

Implement Webhooks to track payout status

Subscribe to Money Movement status events to track the payout through its lifecycle instead of polling.

See Notifications & Subscriptions for more details.

What to expect after using this API

Money Movement is initiated

The Money Movement starts in initiated status while Cobre validates funds and the counterparty.

Funds are debited and sent on-chain

Once processing, the source balance is debited and the transaction is executed on-chain.

Money Movement reaches a final status

On completed, the transaction's tracking_key contains the on-chain hash. On failed, funds are automatically returned to the source balance.

Stablecoin Payouts

Sending a Stablecoin Payout#

Key Terms#

Payout lifecycle#

Allowed Actions on Stablecoin Payouts#

How to Get Started#

What to expect after using this API#

Sending a Stablecoin Payout

Key Terms

Payout lifecycle

Allowed Actions on Stablecoin Payouts

How to Get Started

What to expect after using this API