Last updated
Standalone crypto top-ups to a merchant account balance.
A deposit is a standalone crypto top-up to a merchant account balance. The customer can send any amount at or above the currency minimum — there is no fixed invoice amount.
Deposits can be created through the API (POST /deposit) or the merchant admin panel. The response includes a pool deposit address, QR code, payment link, and expiresAt (default link validity is 20 minutes). Use a merchant-supplied orderId as the idempotency key when creating deposits through the API.
Deposits have statuses and each time a standalone deposit changes its status, Cryptonly sends deposit.statusChanged webhooks to the configured webhook URL.
This is not the same as an invoice checkout payment. Invoice-linked deposits are internal to the invoice flow - for those, listen for invoice.statusChanged webhooks instead. For repeat top-ups to the same address, see Address provision.
Processing lifecycle — full step-by-step flow
Statuses — status table and integration notes
Address provision — reusable address for repeat top-ups
Last updated