Skip to main content
The Crypto Payout endpoint lets a partner spend the VND balance accumulated on their merchant (MID) account to send a stablecoin (e.g. USDT, USDC) to any recipient wallet. Orders are created in a pending state awaiting Holdstation Pay operator approval — no VND is debited at create time. Once approved, Holdstation Pay debits the VND from your MID balance and broadcasts the on-chain stablecoin transfer to the recipient.
The target token_address must reference a stablecoin (token with token_type=STABLECOIN). Use the List Tokens endpoint to discover supported stablecoins per chain.

​
Workflow

  1. Check VND balance — confirm the MID has enough VND via Get MID Balance.
  2. Pick the destination — choose the target chain and stablecoin contract.
  3. Create the payout order — call Create Crypto Payout with the spend amount (in VND or token), the recipient wallet address, and a callback URL. Use a unique idempotency_key for every distinct payout to avoid duplicates.
  4. Wait for operator approval — the order starts in a pending state. Holdstation Pay operators review and approve.
  5. Receive status webhooks — the configured callback receives Orders Webhook events as the order moves through approval, on-chain submission, confirmation, or failure.

​
Processing States

Crypto payout orders move through a dedicated processing-state set. State updates are delivered to your configured callback as Orders Webhook events.

​
Currency Modes

The currency field controls how amount is interpreted:

​
Idempotency

Always send a unique idempotency_key for each distinct payout. You can pass it either in the request body or via the X-Idempotency-Key header. Replaying the same key returns the original order instead of creating a new one.

​
Authentication

All requests require Ed25519 request signing. See Request Signing.