Last updated
A reusable deposit address for repeat top-ups from the same customer.
Address provision reserves a reusable deposit pool address for a specific customer, currency, and merchant account. The customer can send multiple top-ups to the same on-chain address until the provision expires.
Provisions can be created through the API (POST /address-provision) or the merchant admin panel. The response matches a deposit create response: id (provision id), address, minimumAmount, expiresAt, and qrCode.
Default address validity is 30 minutes. You can set expiresInMinutes between 15 and 90 when creating a provision through the API. If an active provision already exists for the same (account, currency, customer) and its expiresAt is still in the future, Cryptonly returns the existing one instead of allocating a new address. Once expiresAt has passed, a new POST creates a fresh provision with a new pool address; the previous pool address stays reserved during the grace period for late payments.
Each qualifying inbound transaction creates a separate child deposit. These child deposits are not listed in GET /deposit/list.
There is no address-provision-specific webhook. Listen for deposit.statusChanged on each payment instead.
Processing lifecycle — full step-by-step flow
Statuses — session status table
Deposit statuses — per-payment outcomes
Last updated