Transient Accounts

Use these endpoints to create transient accounts, check health, manage overfill and settlement workflows, and view associated wallets.

When to use this API

Typical flows:

• Create a transient account for a specific collection or payout use‑case.
• Monitor health and overfill status for operational safety.
• Mark accounts as overfilled or settled as part of reconciliation.
• Inspect wallets linked to transient accounts.

Core operations

• Create transient account – POST /transient-accounts
• Health check – GET /transient-accounts/health

Overfill & settlement

• Get collections account for transient account – GET /transient-accounts/{accountId}/collections-account
• Mark transient account as overfilled – PATCH /transient-accounts/{accountId}/overfill
• Get overfill info – GET /transient-accounts/{accountId}/overfill-info
• Mark transient account as settled – PATCH /transient-accounts/{accountId}/settled

Wallet views

• Get wallet by walletId – GET /transient-accounts/wallet/walletid
• Get wallet details by walletId – GET /transient-accounts/wallet/walletid/details

Environment & access

• Some transient account behaviours may differ between sandbox and production.
• Ensure your integration has the required permissions to create and settle transient accounts.

See also

• Transactions Management: /docs/transactions-management
• Accounts Management: /docs/accounts-management