创建链上提现

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"
}

授权

Authorization

string

header

必填

会话 JWT(来自注册/登录)或 API key(pk_...)。也接受 X-API-Key: <token> 作为替代请求头。

请求头

Idempotency-Key

string

idempotency_key 请求体字段的替代方式。

请求体

application/json

amount

string

必填

正数十进制字符串,最多 6 位小数(BTC 为 8 位)。

chain

enum<string>

默认值:tron

可用选项:

tron,

eth,

btc

asset

enum<string>

默认值:USDT

要发送的资产(USDC 仅支持 eth;在 btc 上资产默认为 BTC)。

可用选项:

USDT,

USDC,

BTC

to_address

string

to_contact_id

string<uuid>

使用联系人为该链保存的地址代替 to_address(显式 to_address 始终优先)。

idempotency_key

string

contact_name

string

为保存此地址的自动联系人指定名称。

save_contact

boolean

默认值:true

地址会自动保存为联系人;传 false 可跳过。

travel_address

string

Travel Rule(FATF R.16)— 超过组织阈值且转往其他机构时,收款机构的 travel address(ta… 代码)。付款地址由收款机构提供,因此可省略 to_address。

wallet_type

enum<string>

Travel Rule — 目的地为账户持有人自己的钱包时声明 self_hosted(需要 beneficiary_name)。

可用选项:

self_hosted

beneficiary_name

string

Travel Rule — 目的持有人的姓名。超过阈值时必填(配合 travel_address 或 wallet_type=self_hosted)。

响应

幂等重放。

withdrawal_id

string<uuid>

account_id

string<uuid>

idempotency_key

string

chain

enum<string>

可用选项:

tron,

eth,

btc

asset

string

示例:

"USDT"

to_address

string

amount

string

fee

string

total_debit

string

status

enum<string>

可用选项:

pending,

processing,

completed,

failed

status_code

string

status_message

string

tx_id

string

travel_rule_status

enum<string>

提现按 Travel Rule(FATF R.16)政策评估时返回。

可用选项:

not_required,

self_hosted_attested,

approved

beneficiary_name

string

声明的受益人姓名(Travel Rule 提现)。

created_at

string<date-time>

updated_at

string<date-time>

idempotency_hit

boolean

最后修改于 2026年7月18日

获取转账获取提现

凭证

Payins

账户

身份认证

Authentication

社交登录

余额

付款(Payouts)

收款(Payins)

转账

加密货币

AML screening

AML 筛查

KYC / KYB

钱包筛查

联系人

兑换(Swaps)

QR Crypto POS

Webhooks

状态

隔离钱包

银行服务

卡片

安全(OTP)

分析

通行密钥

API Reference

创建链上提现

授权

请求头

请求体

响应