Skip to content

A withdrawal pays funds out of a merchant balance to an external wallet. You create it through the API or the Cryptonly Merchant Dashboard.

Through the API, request a quote (POST /withdrawal/quote), then commit it (POST /withdrawal/commit). Commit debits your balance and Cryptonly sends the transfer on-chain.

Withdrawal amounts are set by you in crypto, along with the destination wallet address. The network fee from the quote is debited together with the amount.

In the dashboard, go to Accounts and click Withdraw.

Withdraw Funds dialog: 500 USDT on Tron to a destination address, the estimated network fee and the Allow auto-convert option.Withdraw Funds dialog: 500 USDT on Tron to a destination address, the estimated network fee and the Allow auto-convert option.
  • Quote returns a fee estimate and a short-lived quoteId. Set allowAutoConvert: true to cover a shortfall from other balances — see Auto-converting.
  • Commit creates the withdrawal in created and debits the amount plus the network fee.
  • orderId on the quote is the idempotency key. Reuse it when retrying the quote, then commit once you have a quoteId.

Cryptonly sends a signed withdrawal.statusChanged webhook on every status change after commit:

  • The commit response returns created, with the balance already debited. The first webhook usually arrives when the withdrawal moves to processing.
  • From processing, the withdrawal finishes as completed or failed. On failed, the debited balance is returned.

See Withdrawal statuses for the full status table.