Crear un retiro on-chain

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

Autorizaciones

Authorization

string

header

requerido

JWT de sesión (de register/login) o llave de API (pk_...). X-API-Key: <token> se acepta como header alternativo.

Encabezados

Idempotency-Key

string

Alternativa al campo idempotency_key del body.

Cuerpo

application/json

amount

string

requerido

String decimal positivo, hasta 6 decimales (8 para BTC).

chain

enum<string>

predeterminado:tron

Opciones disponibles:

tron,

eth,

btc

asset

enum<string>

predeterminado:USDT

Activo a enviar (USDC solo por eth; en btc el activo por defecto es BTC).

Opciones disponibles:

USDT,

USDC,

BTC

to_address

string

to_contact_id

string<uuid>

Usa la dirección guardada del contacto para esta chain en vez de to_address (un to_address explícito siempre gana).

idempotency_key

string

contact_name

string

Nombre del contacto que se auto-guarda con esta dirección.

save_contact

boolean

predeterminado:true

La dirección se guarda como contacto automáticamente; envía false para no guardarla.

travel_address

string

Travel Rule (FATF R.16) — la travel address de la institución beneficiaria (código ta…) para retiros sobre el umbral de la org hacia otra institución. La dirección de pago la entrega la institución receptora, por lo que to_address puede omitirse.

wallet_type

enum<string>

Travel Rule — declara self_hosted cuando el destino es una wallet del propio titular (exige beneficiary_name).

Opciones disponibles:

self_hosted

beneficiary_name

string

Travel Rule — nombre del titular del destino. Obligatorio sobre el umbral (con travel_address o wallet_type=self_hosted).

Respuesta

Respuesta idempotente.

withdrawal_id

string<uuid>

account_id

string<uuid>

idempotency_key

string

chain

enum<string>

Opciones disponibles:

tron,

eth,

btc

asset

string

Ejemplo:

"USDT"

to_address

string

amount

string

fee

string

total_debit

string

status

enum<string>

Opciones disponibles:

pending,

processing,

completed,

failed

status_code

string

status_message

string

tx_id

string

travel_rule_status

enum<string>

Presente cuando el retiro fue evaluado contra la política Travel Rule (FATF R.16).

Opciones disponibles:

not_required,

self_hosted_attested,

approved

beneficiary_name

string

Nombre del beneficiario declarado (retiros con Travel Rule).

created_at

string<date-time>

updated_at

string<date-time>

idempotency_hit

boolean

Última modificación el 18 de julio de 2026

Consultar una transferencia Obtener un retiro

Comprobantes

Payins

Account

Autenticación

Authentication

Login social

Cuenta

Saldos

Payouts

Transferencias

Crypto

AML screening

KYC / KYB

Screening de wallets

Contacts

Swaps

QR Crypto POS

Webhooks

Estado

Wallets segregadas

Banking

Cards

Seguridad (OTP)

Analytics

Passkeys

API Reference

Crear un retiro on-chain

Autorizaciones

Encabezados

Cuerpo

Respuesta