Saltar al contenido principal
POST

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 los decimales de la moneda (6 para USDT/USDC/GOLD, 8 para BTC).

Ejemplo:

"10.500000"

to_account_id
string<uuid>
to_email
string<email>
to_phone
string

Teléfono E.164 de la cuenta destino. Solo resuelven cuentas con el teléfono verificado por OTP (si no, 404 recipient_not_found; 422 recipient_ambiguous si más de una cuenta comparte el número).

to_contact_id
string<uuid>

Envía directo a un contacto de tu libreta (usa su cuenta CBPay enlazada, o su teléfono verificado).

to_qr_token
string

Token del QR de perfil de la cuenta destino (escaneado desde su QR CBPay). También acepta el payload extendido del QR de checkout (cbpay:pay?to=…&checkout=…) — el checkout token embebido se honra automáticamente.

checkout_token
string

Token opcional de un link de cobro universal para pagarlo directo. El destino se fuerza a la cuenta del link y el monto debe cubrir el due cotizado server-side en el asset elegido (422 checkout_amount_mismatch con el due actualizado si no). Al completar, el link se liquida y auto-convierte a su settlement_asset.

asset
enum<string>
predeterminado:USDT

Moneda del saldo a mover; el destino recibe en esta misma moneda.

Opciones disponibles:
USDT,
USDC,
BTC,
GOLD
description
string
idempotency_key
string
save_contact
boolean
predeterminado:true

El destino se guarda como contacto automáticamente; envía false para no guardarlo.

Respuesta

Respuesta idempotente.

transfer_id
string<uuid>
from_account_id
string<uuid>
to_account_id
string<uuid>
asset
string
Ejemplo:

"USDT"

amount
string
description
string
status
string
Ejemplo:

"completed"

created_at
string<date-time>
idempotency_hit
boolean
Última modificación el 18 de julio de 2026