Get a bank account
Read an existing receiving account for a currency:404 response means there is no available account for that currency. To request one, call POST /v1/virtual-accounts with an Idempotency-Key:
Use
resume for the usual setup flow. Omitting intent can request another account after an earlier setup completes. If Ledig asks you to choose between existing accounts, resolve that choice before retrying.
Follow account setup
For a pending setup, save its
id and read the returned status and missing requirements. Status values are requested, manual_review, pending_provider and completed. The response includes accountId once an account exists.
Complete any requested information. If setup needs review, contact support@ledig.io with the request ID. Reuse the original key when retrying the same request.
Once the account is ready, read GET /v1/virtual-accounts/{currency} whenever you need its current account number, bank details and payment reference. These responses use Cache-Control: no-store; do not put account details in shared caches or logs.
Discover crypto deposit networks
CallGET /v1/wallets/options to see which networks and assets are available for deposits. Each option includes:
Use the returned options to populate your deposit form. An empty list means you cannot create a new address at that time; you can still read existing wallets.
Deposit networks and recipient networks serve different purposes. Use deposit options when receiving funds.
Create a network address
CallPOST /v1/wallets/network to request an address for the selected network. Replace NETWORK_FROM_OPTIONS with the exact identifier returned by deposit options:
data.requestId; keep it even if setup is still pending.
Check address setup
CallGET /v1/wallets/network/{requestId}. It returns HTTP 200 with the current setup result:
A pending result does not contain a usable address. A
404 response means the request was not found for your business. Keep the original request rather than creating a replacement after a timeout.
Read existing wallets
GET /v1/wallets lists your deposit wallets. Use GET /v1/wallets/{id} to read one wallet.
You can also create a wallet for a single asset with POST /v1/wallets. Send nickname, coin, network and an Idempotency-Key, using an asset and network from deposit options.