Saltar al contenido principal
Las transferencias internas mueven saldo entre dos cuentas CBPay, de forma atómica en el ledger y siempre sin comisión — el dinero nunca sale del ecosistema. Funcionan con las cuatro monedas (USDT, USDC, BTC, GOLD) y siempre entre saldos de la misma moneda: el asset que envías es el asset que recibe el destino, sin conversión. Funcionan entre cualquier combinación de cuentas:
OrigenDestinoComisión
PersonaPersona0
PersonaEmpresa0
EmpresaPersona0
EmpresaEmpresa0

​
Crear una transferencia

El destino se identifica por to_account_id, to_email, to_phone (teléfono verificado) o to_contact_id (un contacto de tu libreta): 
curl -X POST https://api.qbank.cl/platform/v1/transfers \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{
    "to_phone": "+56987654321",
    "amount": "25.000000",
    "description": "Almuerzo",
    "idempotency_key": "alm-2026-07-10-a"
  }'

curl -X POST https://api.qbank.cl/platform/v1/transfers \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{
    "to_contact_id": "3f8a1b2c-…",
    "amount": "10.000000",
    "idempotency_key": "t-991"
  }'

curl -X POST https://api.qbank.cl/platform/v1/transfers \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{
    "to_email": "carlos@ejemplo.com",
    "amount": "25.000000",
    "description": "Split de gastos",
    "idempotency_key": "split-2026-07-06-a"
  }'

curl -X POST https://api.qbank.cl/platform/v1/transfers \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{
    "to_account_id": "ae8cf540-22a9-414d-82cc-8ac04732be4f",
    "amount": "120.500000",
    "description": "Pago servicio mensual",
    "idempotency_key": "serv-2026-07-a"
  }'

curl -X POST https://api.qbank.cl/platform/v1/transfers \
  -H "Authorization: Bearer <token de la empresa>" \
  -H "Content-Type: application/json" \
  -d '{
    "to_email": "empleado@ejemplo.com",
    "amount": "850.000000",
    "description": "Sueldo julio",
    "idempotency_key": "nomina-2026-07-emp01"
  }'

curl -X POST https://api.qbank.cl/platform/v1/transfers \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{
    "to_email": "carlos@ejemplo.com",
    "asset": "GOLD",
    "amount": "2.500000",
    "description": "Regalo en oro",
    "idempotency_key": "oro-2026-07-09-a"
  }'
La forma del request es idéntica en todas las combinaciones (persona o empresa, en cualquier dirección) — cambia solo la credencial que llama. asset es opcional y por defecto USDT; acepta USDT, USDC, BTC o GOLD y el destino recibe en esa misma moneda. Respuesta 201 — la transferencia es síncrona e inmediata: 
{
  "transfer_id": "77b1…",
  "from_account_id": "…",
  "to_account_id": "…",
  "asset": "USDT",
  "amount": "25.000000",
  "description": "Split de gastos",
  "status": "completed",
  "created_at": "2026-07-06T20:10:00Z"
}
Replay con la misma idempotency_key — 200 con la transferencia original: 
{
  "transfer_id": "77b1…",
  "amount": "25.000000",
  "status": "completed",
  "idempotency_hit": true
}
El receptor puede enterarse por el webhook transfer_received y ambos ven el movimiento en su historial (transfer_out / transfer_in).
Cada transferencia guarda al destinatario como contacto automáticamente (envía "save_contact": false para no guardarlo). Por seguridad, to_phone solo resuelve cuentas con el teléfono verificado por OTP; si más de una cuenta comparte el número responde 422 recipient_ambiguous.

​
Consultar transferencias

Lista las transferencias de tu cuenta (enviadas y recibidas), con paginación y filtros de fecha: 
curl "https://api.qbank.cl/platform/v1/transfers?from=2026-07-01&to=2026-07-07&page_size=50" \
  -H "Authorization: Bearer <token>"
O una en particular por su ID (solo visible para las dos partes): 
curl https://api.qbank.cl/platform/v1/transfers/77b1… \
  -H "Authorization: Bearer <token>"
Cada fila trae direction (sent o received) desde tu perspectiva.

​
Reglas

  • Solo entre cuentas CBPay activas; las cuentas internas del sistema no pueden recibir.
  • Siempre misma moneda en origen y destino: no hay conversión entre saldos (USDT→USDT, GOLD→GOLD, …).
  • No puedes transferirte a ti mismo (400 self_transfer).
  • Requiere idempotency_key (body o header Idempotency-Key); el replay devuelve 200 con idempotency_hit: true.
  • amount acepta hasta los decimales de la moneda: 6 para USDT/USDC/ GOLD, 8 para BTC.

​
Errores

HTTPerrorCausa
400recipient_requiredFalta to_account_id, to_email, to_phone y to_contact_id
400invalid_amountMonto inválido, demasiados decimales o asset no soportado
400invalid_phoneto_phone no se pudo normalizar a E.164
400self_transferOrigen y destino son la misma cuenta
402insufficient_fundsSaldo disponible insuficiente en esa moneda
404recipient_not_foundEl email/ID no corresponde a una cuenta CBPay, o ningún teléfono verificado coincide
422recipient_ambiguousMás de una cuenta comparte ese teléfono (usa to_account_id o to_email)
422contact_not_linkedEl contacto no tiene cuenta CBPay asociada
422recipient_unavailableLa cuenta destino está bloqueada/cerrada
Última modificación el 10 de julio de 2026