curl --request POST \
  --url https://api.qbank.cl/platform/v1/payins/deposit-accounts \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "country": "MX",
  "currency": "MXN"
}
'

{
  "instrument_id": "a1d4b7c0-1234-5678-9abc-def012345678",
  "account_id": "9b1deb4d-3b7d-4bad-9bdd-2b0d7b3dcb6d",
  "country": "MX",
  "currency": "MXN",
  "method": "bank_transfer",
  "purpose": "fondeo",
  "instrument": "734180000151000006",
  "details": {
    "clabe": "734180000151000006",
    "alias": "Cuenta MXN de ejemplo",
    "bank_name": "Banco receptor de ejemplo",
    "status": "active"
  },
  "status": "active",
  "created_at": "2026-07-07T12:00:00Z"
}

Crear una cuenta de depósito dedicada

Requiere identidad de cuenta aprobada; las cuentas persona necesitan KYC aprobado y las cuentas empresa KYB aprobado antes de que esta operación autenticada cree o cobre un payin. Aprovisiona un destino de depósito fijo ligado a tu cuenta en los corredores que lo soportan (ej. una CLABE mexicana o una CVU argentina). Cada transferencia que llega a él se acredita automáticamente, neta de la comisión de payin. purpose es fondeo por defecto; banking conserva fiat local solo en BO/BOB, MX/MXN y AR/ARS con bank_transfer. La creación es gratuita.

POST

/

v1

/

payins

/

deposit-accounts

curl --request POST \
  --url https://api.qbank.cl/platform/v1/payins/deposit-accounts \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "country": "MX",
  "currency": "MXN"
}
'

{
  "instrument_id": "a1d4b7c0-1234-5678-9abc-def012345678",
  "account_id": "9b1deb4d-3b7d-4bad-9bdd-2b0d7b3dcb6d",
  "country": "MX",
  "currency": "MXN",
  "method": "bank_transfer",
  "purpose": "fondeo",
  "instrument": "734180000151000006",
  "details": {
    "clabe": "734180000151000006",
    "alias": "Cuenta MXN de ejemplo",
    "bank_name": "Banco receptor de ejemplo",
    "status": "active"
  },
  "status": "active",
  "created_at": "2026-07-07T12:00:00Z"
}

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

country

string

predeterminado:MX

currency

string

predeterminado:MXN

method

string

predeterminado:bank_transfer

purpose

enum<string>

predeterminado:fondeo

Propósito del destino de depósito. Banking se limita a BO/BOB, MX/MXN y AR/ARS bank_transfer.

Opciones disponibles:

fondeo,

banking

bank_alias

string

Alias bancario direccionable elegido por el caller para una CVU AR/ARS. Es obligatorio al crear una cuenta de depósito AR/ARS por transferencia bancaria y es distinto del alias del perfil.

Required string length: 6 - 20

Pattern: ^[A-Za-z0-9.\-]*[A-Za-z][A-Za-z0-9.\-]*$

Respuesta

Cuenta de depósito creada y ligada a la cuenta que llama.

instrument_id

string<uuid>

account_id

string<uuid>

country

string

currency

string

method

string

purpose

enum<string>

Propósito del destino de depósito.

Opciones disponibles:

fondeo,

banking

instrument

string

El destino de depósito a compartir con los pagadores (ej. la CLABE).

details

object

Show child attributes

status

enum<string>

Opciones disponibles:

active,

disabled

created_at

string<date-time>