curl --request POST \
  --url https://api.qbank.cl/platform/v1/crypto/wallets \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "chain": "tron"
}
'

{
  "wallet_id": "b7e3a940-6f1d-4c2b-9a8e-5d4c3b2a1f0e",
  "chain": "tron",
  "asset": "USDT",
  "address": "TQmZ1kfWzcmRDYkqLnybXnbWzPMYNvbYqT",
  "label": "Main treasury",
  "type": "deposit",
  "receive_only": true,
  "created_at": "2026-07-07T12:00:00Z",
  "creation_fee": "1.000000"
}

{
  "error": "invalid_chain",
  "message": "unsupported chain \"doge\" (tron, eth, btc)"
}

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

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

{
  "error": "wallet_limit_reached",
  "message": "accounts hold one deposit wallet per network/asset pair (created automatically with the account); use segregated wallets for additional wallets"
}

Reponer una wallet de depósito faltante

Toda cuenta — persona y empresa — tiene exactamente una wallet de depósito por par soportado (tron/usdt, eth/usdt, eth/usdc, btc/btc), aprovisionadas automáticamente y gratis al registrarse. Las wallets de depósito solo reciben crypto que se abona al saldo virtual de la cuenta: no envían, y no se exportan ni importan (para eso están las wallets segregadas). Este endpoint existe solo para reponer un par faltante (caso excepcional): con el par ya aprovisionado responde 422 wallet_limit_reached para todo tipo de cuenta.

Una reposición manual cobra la comisión wallet_creation cuando CBPay la tiene configurada (fija por wallet; 0 = gratis, el valor por defecto); las wallets de nacimiento son siempre gratis. El cargo se reembolsa automáticamente si la creación falla.

POST

crypto

wallets

curl --request POST \
  --url https://api.qbank.cl/platform/v1/crypto/wallets \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "chain": "tron"
}
'

{
  "wallet_id": "b7e3a940-6f1d-4c2b-9a8e-5d4c3b2a1f0e",
  "chain": "tron",
  "asset": "USDT",
  "address": "TQmZ1kfWzcmRDYkqLnybXnbWzPMYNvbYqT",
  "label": "Main treasury",
  "type": "deposit",
  "receive_only": true,
  "created_at": "2026-07-07T12:00:00Z",
  "creation_fee": "1.000000"
}

{
  "error": "invalid_chain",
  "message": "unsupported chain \"doge\" (tron, eth, btc)"
}

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

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

{
  "error": "wallet_limit_reached",
  "message": "accounts hold one deposit wallet per network/asset pair (created automatically with the account); use segregated wallets for additional wallets"
}

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.

Cuerpo

application/json

chain

enum<string>

requerido

Opciones disponibles:

tron,

eth,

btc

asset

enum<string>

predeterminado:usdt

Activo de la wallet (usdc solo por eth; en btc el activo por defecto es btc).

Opciones disponibles:

usdt,

usdc,

btc

label

string

Etiqueta descriptiva opcional.

Respuesta

Wallet creada.

wallet_id

string<uuid>

type

enum<string>

Discriminador de producto: las wallets de depósito solo reciben crypto que acredita el saldo virtual.

Opciones disponibles:

deposit

receive_only

boolean

Siempre true. Las wallets de depósito no envían, no se exportan ni se importan (para eso están las segregadas).

chain

enum<string>

Opciones disponibles:

tron,

eth,

btc

asset

string

Ejemplo:

"USDT"

address

string

label

string

Etiqueta descriptiva opcional.

created_at

string<date-time>

creation_fee

string

Última modificación el 18 de julio de 2026

Listar mis wallets Listar screenings AML

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

Reponer una wallet de depósito faltante

Autorizaciones

Cuerpo

Respuesta