Subcuentas

El servicio de subcuentas de Notbank redefine la gestión financiera al permitir una segmentación total de los recursos dentro de una misma plataforma. Esta herramienta facilita el control preciso de los balances, permitiendo operar compras, ventas y conversiones en entornos independientes y seguros. Al aislar cada flujo de capital, los usuarios pueden optimizar sus estrategias comerciales y mantener una organización contable impecable. Es la solución ideal para quienes buscan agilidad operativa sin comprometer la claridad ni la estructura de sus movimientos financieros.

1.1 Crear una subcuenta

Node

// ...
await restClient.getSubAccountService().createSubAccount({
    alias: "subaccount1"
});

1.2 Obtener subcuentas

Node

const subAccounts = await restClient.getSubAccountService().getSubAccounts({
    page: 1,
    page_size: 10
});

console.log(subAccounts);
// [
//    {
//        "id": 1556,
//        "alias": "subaccount1",
//        "created_at": "2026-02-17T13:27:28"
//    }
// ]

1.3 Obtener lista de bancos soportados

Node

const banks = await restClient.getWalletService().getBanks({
  country: "PE"
});

console.log(banks);
// [
//    {
//        "id": "6e83d105-83ff-4a1e-ba62-cd23b21e9d37",
//        "name": "BANK OF CHINA",
//        "country": "PE"
//    },
//    {
//        "id": "925099d0-4b2c-403e-9b8b-f64e18ce5f47",
//        "name": "BANCO AZTECA",
//        "country": "PE"
//    }, ...
// ]

1.4 Obtener provincias

Node

const provinces = await restClient.getWalletService().getProvinces({
  "country": "PE"
});

console.log(provinces);
// {
//   "status": "success",
//   "data": [
//     [
//       "101",
//       "Chachapoyas"
//     ],
//     [
//       "102",
//       "Bagua"
//     ],
//     [
//       "103",
//       "Bongara"
//     ], ...
//   ]
// }

1.5 Agregar cuenta bancaria

Node

// ...
const userBankAccount =  restClient.getWalletService().AddClientBankAccount({
  country: "PEN",
  bank: "6e83d105-83ff-4a1e-ba62-cd23b21e9d37",
  number: "111111111111111111111", // número CCI
  kind: "ahorro",
  province: "212", // Huaylas
  document_number: "111111111",
  document_type: "DNI",
  name_1: "Juan",
  name_2: "Perez"
});

console.log(userBankAccount.id);
// 29cd83cf-3678-4207-80c7-7caaa1d24c27

1.6 Obtener las redes disponibles

Dada la gran cantidad de monedas y redes que soporta Notbank, primero es necesario obtener las redes disponibles para una criptomoneda.

Node

// ...
const networks = await restClient.getWalletService().getNetworksTemplates({
  currency: "USDT"
});

console.log(networks);
// [
//   {
//     "currency": "USDT",
//     "network": "USDT_ERC20",
//     "network_name": "Ethereum",
//     "network_protocol": "ERC-20",
//     template: [
//       [Object],
//       [Object]
//     ]
//   }
// ]

1.7 Obtener una billetera USDT ERC20

Utilizando el código de la red ( network ) obtenido en el paso anterior más el código de la moneda (currency) puedes solicitar tu dirección de billetera.

Node

// ...
const addresses = await restClient.getWalletService().getDepositAddresses({
  account_id: clientAccountId,
  currency: "USDT",
  network: "USDT_ERC20",
});

console.log(addresses)
// ["2N3r9roRrHy7p6C5pGE8NQP9ZNT81H7ZKyU"]

1.8 Convertir criptomonedas

En este ejemplo, vamos a solicitar la cantidad de Ethereum (ETH) que recibiríamos si utilizáramos 1000 Soles (PEN). Luego consultaremos el monto prometido, que tiene una vigencia de 20 segundos y finalmente, ejecutaremos la compra.

La conversión no se limita a transacciones entre criptomonedas, si no que a cualquier combinación posible: criptomoneda a criptomoneda, moneda fiat a criptomoneda, criptomoneda a moneda fiat y moneda fiat a moneda fiat.

Los montos adjuntos en los ejemplos son con fines educativos y no representan el estado actual del mercado.

1.8.1 Solicitar cotización

Node

const quoteId = await restClient.getQuoteService().createDirectQuote({
  from_currency: "PEN",
  from_amount: 1000,
  to_currency: "ETH",
  operation: 3, // CONVERSION
  account_id: clientAccountId,
});

console.log(quoteId)
// fc4ffe0e-b87a-4e1f-a727-f6ddae7dc1e0

1.8.2 Consultar cotización

Node

// ...
const quote = await restClient.getQuoteService().getQuote({
  quote_id: "fc4ffe0e-b87a-4e1f-a727-f6ddae7dc1e0",
  account_id: clientAccountId,
});

console.log(quote.status)
// 0 // pendiente
console.log(quote.amount_out)
// 1.5 // ETH

1.8.3 Ejecutar cotización

Node

// ...
const quote = await restClient.getQuoteService().executeQuote({
  quote_id: "fc4ffe0e-b87a-4e1f-a727-f6ddae7dc1e0",
  account_id: clientAccountId,
});

console.log(quote.status)
// 0 // pendiente
console.log(quote.amount_out)
// 1.5 // ETH

// Luego de unos momentos, consultar de nuevo el estado de la solicitud
const quote = await restClient.getQuoteService().getQuote({
  quote_id: "fc4ffe0e-b87a-4e1f-a727-f6ddae7dc1e0",
  account_id: clientAccountId,
});

console.log(quote.status)
// 1 // ejecutado
console.log(quote.amount_out)
// 1.5 // ETH

1.9 Notificación de retiro bancario

Node

await restClient.getWalletService().createFiatWithdraw({
  account_id: clientAccountId, 
  payment_method: 1,  // transferencia bancaria
  currency: "PEN",
  amount: 1000,
  bank_account_id: "29cd83cf-3678-4207-80c7-7caaa1d24c27"
});

1.10 Mover balance USDT hacia la cuenta principal

Node

await restClient.getWalletService().transferFunds({
  "sender_account_id": subAccountId,
  "receiver_account_id": primaryAccountId,
  "currency_name": "USDT",
  "amount": 100,
  "notes": "transfer detail",
  "otp": "123456" // autenticación de dos pasos
});