Create an on-chain withdrawal

curl --request POST \
  --url https://api.qbank.cl/platform/v1/crypto/withdrawals \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "chain": "tron",
  "to_address": "TVJ6njG5Fyrq6XwYok3xPQx8kR7HQx6vXk",
  "amount": "100.000000",
  "idempotency_key": "withdrawal-2026-07-07-a"
}
'

{
  "withdrawal_id": "6c5d4e3f-2a1b-0c9d-8e7f-6a5b4c3d2e1f",
  "account_id": "9b1deb4d-3b7d-4bad-9bdd-2b0d7b3dcb6d",
  "idempotency_key": "withdrawal-2026-07-07-a",
  "chain": "tron",
  "asset": "USDT",
  "to_address": "TVJ6njG5Fyrq6XwYok3xPQx8kR7HQx6vXk",
  "amount": "100.000000",
  "fee": "1.000000",
  "total_debit": "101.000000",
  "status": "processing",
  "status_code": "",
  "status_message": "broadcasted",
  "tx_id": "b1946ac92492d2347c6235b4d2611184e0f0f8c9d3a1e2b3c4d5e6f708192a3b",
  "created_at": "2026-07-07T12:00:00Z",
  "updated_at": "2026-07-07T12:00:00Z",
  "idempotency_hit": true
}

{
  "withdrawal_id": "6c5d4e3f-2a1b-0c9d-8e7f-6a5b4c3d2e1f",
  "account_id": "9b1deb4d-3b7d-4bad-9bdd-2b0d7b3dcb6d",
  "idempotency_key": "withdrawal-2026-07-07-a",
  "chain": "tron",
  "asset": "USDT",
  "to_address": "TVJ6njG5Fyrq6XwYok3xPQx8kR7HQx6vXk",
  "amount": "100.000000",
  "fee": "1.000000",
  "total_debit": "101.000000",
  "status": "processing",
  "status_code": "",
  "status_message": "broadcasted",
  "tx_id": "b1946ac92492d2347c6235b4d2611184e0f0f8c9d3a1e2b3c4d5e6f708192a3b",
  "created_at": "2026-07-07T12:00:00Z",
  "updated_at": "2026-07-07T12:00:00Z"
}

{
  "error": "invalid_json",
  "message": "request body is not valid JSON: unknown field"
}

{
  "error": "unauthorized",
  "message": "invalid or missing credentials"
}

{
  "error": "insufficient_funds",
  "message": "account balance is not enough for this operation"
}

{
  "withdrawal_id": "6c5d4e3f-2a1b-0c9d-8e7f-6a5b4c3d2e1f",
  "account_id": "9b1deb4d-3b7d-4bad-9bdd-2b0d7b3dcb6d",
  "idempotency_key": "withdrawal-2026-07-07-a",
  "chain": "tron",
  "asset": "USDT",
  "to_address": "TVJ6njG5Fyrq6XwYok3xPQx8kR7HQx6vXk",
  "amount": "100.000000",
  "fee": "1.000000",
  "total_debit": "101.000000",
  "status": "failed",
  "status_code": "core_rejected",
  "status_message": "destination address is invalid",
  "tx_id": "",
  "created_at": "2026-07-07T12:00:00Z",
  "updated_at": "2026-07-07T12:00:00Z"
}

{
  "error": "withdrawals_unavailable",
  "message": "on-chain withdrawals are not enabled for this corridor yet"
}

POST

crypto

withdrawals

curl --request POST \
  --url https://api.qbank.cl/platform/v1/crypto/withdrawals \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "chain": "tron",
  "to_address": "TVJ6njG5Fyrq6XwYok3xPQx8kR7HQx6vXk",
  "amount": "100.000000",
  "idempotency_key": "withdrawal-2026-07-07-a"
}
'

{
  "withdrawal_id": "6c5d4e3f-2a1b-0c9d-8e7f-6a5b4c3d2e1f",
  "account_id": "9b1deb4d-3b7d-4bad-9bdd-2b0d7b3dcb6d",
  "idempotency_key": "withdrawal-2026-07-07-a",
  "chain": "tron",
  "asset": "USDT",
  "to_address": "TVJ6njG5Fyrq6XwYok3xPQx8kR7HQx6vXk",
  "amount": "100.000000",
  "fee": "1.000000",
  "total_debit": "101.000000",
  "status": "processing",
  "status_code": "",
  "status_message": "broadcasted",
  "tx_id": "b1946ac92492d2347c6235b4d2611184e0f0f8c9d3a1e2b3c4d5e6f708192a3b",
  "created_at": "2026-07-07T12:00:00Z",
  "updated_at": "2026-07-07T12:00:00Z",
  "idempotency_hit": true
}

{
  "withdrawal_id": "6c5d4e3f-2a1b-0c9d-8e7f-6a5b4c3d2e1f",
  "account_id": "9b1deb4d-3b7d-4bad-9bdd-2b0d7b3dcb6d",
  "idempotency_key": "withdrawal-2026-07-07-a",
  "chain": "tron",
  "asset": "USDT",
  "to_address": "TVJ6njG5Fyrq6XwYok3xPQx8kR7HQx6vXk",
  "amount": "100.000000",
  "fee": "1.000000",
  "total_debit": "101.000000",
  "status": "processing",
  "status_code": "",
  "status_message": "broadcasted",
  "tx_id": "b1946ac92492d2347c6235b4d2611184e0f0f8c9d3a1e2b3c4d5e6f708192a3b",
  "created_at": "2026-07-07T12:00:00Z",
  "updated_at": "2026-07-07T12:00:00Z"
}

{
  "error": "invalid_json",
  "message": "request body is not valid JSON: unknown field"
}

{
  "error": "unauthorized",
  "message": "invalid or missing credentials"
}

{
  "error": "insufficient_funds",
  "message": "account balance is not enough for this operation"
}

{
  "withdrawal_id": "6c5d4e3f-2a1b-0c9d-8e7f-6a5b4c3d2e1f",
  "account_id": "9b1deb4d-3b7d-4bad-9bdd-2b0d7b3dcb6d",
  "idempotency_key": "withdrawal-2026-07-07-a",
  "chain": "tron",
  "asset": "USDT",
  "to_address": "TVJ6njG5Fyrq6XwYok3xPQx8kR7HQx6vXk",
  "amount": "100.000000",
  "fee": "1.000000",
  "total_debit": "101.000000",
  "status": "failed",
  "status_code": "core_rejected",
  "status_message": "destination address is invalid",
  "tx_id": "",
  "created_at": "2026-07-07T12:00:00Z",
  "updated_at": "2026-07-07T12:00:00Z"
}

{
  "error": "withdrawals_unavailable",
  "message": "on-chain withdrawals are not enabled for this corridor yet"
}

Authorizations

Authorization

string

header

required

Session JWT (from register/login) or API key (pk_...). X-API-Key: <token> is accepted as an alternative header.

Headers

Idempotency-Key

string

Alternative to the idempotency_key body field.

Body

application/json

amount

string

required

Positive decimal string, up to 6 decimal places (8 for BTC).

chain

enum<string>

default:tron

Available options:

tron,

eth,

btc

asset

enum<string>

default:USDT

Asset to send (USDC only over eth; on btc the asset defaults to BTC).

Available options:

USDT,

USDC,

BTC

to_address

string

to_contact_id

string<uuid>

Use the contact's saved address for this chain instead of to_address (an explicit to_address always wins).

idempotency_key

string

contact_name

string

Name for the auto-saved contact holding this address.

save_contact

boolean

default:true

The address is saved as a contact automatically; send false to skip it.

travel_address

string

Travel Rule (FATF R.16) — the beneficiary institution's travel address (ta… code) for withdrawals above the org threshold towards another institution. The payment address is provided by the receiving institution, so to_address can be omitted.

wallet_type

enum<string>

Travel Rule — declare self_hosted when the destination is the account holder's own wallet (requires beneficiary_name).

Available options:

self_hosted

beneficiary_name

string

Travel Rule — name of the destination holder. Required above the threshold (with travel_address or wallet_type=self_hosted).

Response

Idempotency replay.

withdrawal_id

string<uuid>

account_id

string<uuid>

idempotency_key

string

chain

enum<string>

Available options:

tron,

eth,

btc

asset

string

Example:

"USDT"

to_address

string

amount

string

fee

string

total_debit

string

status

enum<string>

Available options:

pending,

processing,

completed,

failed

status_code

string

status_message

string

tx_id

string

travel_rule_status

enum<string>

Present when the withdrawal was evaluated against the Travel Rule (FATF R.16) policy.

Available options:

not_required,

self_hosted_attested,

approved

beneficiary_name

string

Declared beneficiary name (Travel Rule withdrawals).

created_at

string<date-time>

updated_at

string<date-time>

idempotency_hit

boolean