Crypto as a Service (CaaS)

NotBank ofrece un servicio de "Crypto as a Service" (CaaS) que proporciona una infraestructura técnica robusta y documentada (API) para que terceros (fintechs, bancos o billeteras) puedan integrar rápidamente funcionalidades completas de criptomonedas y activos digitales bajo su propia marca. Esta solución permite a las instituciones ofrecer a sus clientes servicios como custodia segura, gestión de billeteras, conversión instantánea de fiat a cripto, y operaciones de envío/recepción, sin la necesidad de desarrollar desde cero la complejidad de la capa blockchain, el backend, la seguridad o el cumplimiento normativo. En esencia, NotBank gestiona la parte técnica, los riesgos y la infraestructura, actuando como puente entre el mundo financiero tradicional y el ecosistema cripto, lo que permite a sus clientes concentrarse únicamente en la experiencia de usuario y su estrategia comercial.

Para poder comenzar a utilizar Crypto as a Service (CaaS), el interesado debe formalizar su solicitud mediante la firma de un contrato de prestación de servicios. Este contrato establece claramente los términos de uso, las responsabilidades y los acuerdos comerciales. Para iniciar este proceso, es necesario contactar a nuestro equipo de soporte haciendo clic en el link proporcionado. Este enlace lo dirigirá a un formulario de contacto específico que debe completar. Una vez que recibamos su solicitud a través del formulario, nuestro equipo le enviará de manera oportuna el contrato para su revisión y posterior firma.

1. Autenticación en Notbank

La autenticación para acceder a la API de Notbank se realiza de forma segura combinando las credenciales de API confidenciales con un identificador de usuario específico. Estas credenciales, obtenidas en el paso previo, actúan como la prueba de identidad de la aplicación cliente. Al incluir el identificador de usuario junto con estas credenciales en la solicitud, la API puede verificar la identidad de quien realiza la llamada y, crucialmente, autorizar las operaciones a nivel de la cuenta de usuario específica dentro del ecosistema de Notbank, asegurando que solo los datos y acciones pertinentes estén disponibles.

Node

import { NotbankClient } from 'notbank';

// creación de cliente rest http
const restClient = NotbankClient.Factory.createRestClient();

// autenticación
await restClient.authenticateUser({
  ApiPublicKey: "public-key",
  ApiSecretKey: "secret-key",
  UserId: "user-uuid"
});

cURL

2. Registrar un cliente en Notbank

Si deseas expandir tu propio negocio y ofrecer servicios de criptomonedas a tus usuarios, nuestro registro a través de la opción Crypto as a Service (CaaS) es el indicado. Esta potente integración te permitirá incorporar y gestionar tus propios clientes dentro del ecosistema de Notbank, actuando como un puente entre tus usuarios y todas las funcionalidades de nuestra plataforma.

Node

import { NotbankClient } from 'notbank';

// ..

// registro de cliente
const user = await restClient.getRegisterService().registerUser({
  first_name: "Juan",
  last_name: "Pérez",
  phone_number: "[phone]",
  language: "es"
});
const clientUserId = user.userId;

cURL

3. Subir de nivel en Notbank

Notbank estructura el acceso y las funcionalidades de la plataforma a través de un sistema jerárquico de niveles de verificación, diseñado para garantizar la seguridad y ofrecer capacidades operacionales progresivas. El nivel inicial es el Observador, que está restringido únicamente a la visualización de información y datos, impidiendo cualquier tipo de operación o transacción en la plataforma. A partir de ahí, los niveles Básico, Avanzado, y Avanzado Plus marcan mejoras subsecuente aumentando significativamente las opciones de operación, los límites transaccionales y las funcionalidades habilitadas para el usuario. El sistema culmina con el nivel Institucional, reservado solo para entidades y organizaciones, el cual proporciona el conjunto más amplio y especializado de herramientas y permisos de la plataforma.

3.1 Subir a nivel básico

Node

// ...
import { Gender, Profession, CLComune } from "notbank/lib/models/enums";

// ...
await restClient.getVerificationService().verifyBasic({
  is_business: false,
  profession: Profession.TRADER,
  gender: Gender.MAN,
  city: "Santiago",
  street: "Calle 43",
  country: "CL",
  commune: CLComune.SANTIAGO,
  user_id: clientUserId
});

cURL

3.1.1 Glosario

Género

Valor	Descripción
0	Mujer
1	Hombre

Profesión

Provincia (AR)

Estado (BR)

Comuna (CL)

3.2. Subir a nivel avanzado

Node

// ...
import { readFileSync } from 'fs';
import { DocumentAdressType } from "notbank/lib/models/enums";

const document = new File([readFileSync("document.pdf")], "document.pdf");
await restClient.getVerificationService().verifyTrader({
  pep: false,
  subject_comply: false,
  is_public_servant: false,
  document_address_file: document,
  document_address_type: DocumentAdressType.CREDIT_CARD_BILL,
  user_id: clientUserId
});

cURL

3.2.1 Glosario

Tipo de documento

Valor	Descripción
3	Servicio
30	Dirección comprobada
35	Factura de tarjeta de crédito
36	Nóminas
37	Certificado de vecinos
38	Certificado de domicilio notarial
39	Factura de producto con certificado de pago
41	Servicio con nacimiento
40	Servicio con matrimonio
42	Licencia de conducir con dirección

4. Enviar y recibir criptomonedas

Las billeteras de criptomonedas de Notbank ofrecen una puerta de entrada segura y accesible al dinámico mundo de los activos digitales. Diseñadas para satisfacer tanto a novatos como a inversores experimentados, se distinguen por su amplia compatibilidad, que abarca una gran variedad de monedas y redes líderes en el mercado, permitiendo a los usuarios gestionar su portafolio en un único y conveniente lugar. Un punto clave de Notbank es su compromiso con la rentabilidad del usuario, ofreciendo tarifas económicas que optimizan cada transacción. Además, la seguridad es la máxima prioridad; con el respaldo de Notbank, estas billeteras incorporan protocolos de protección de última generación y medidas de seguridad avanzadas para garantizar que los fondos y la privacidad de los usuarios estén resguardados en todo momento.

4.1. Crear una billetera para recibir criptomonedas

4.1.1 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_BSC',
//     network_name: 'BNB Smart Chain',
//     network_protocol: 'BEP-20',
//     template: [
//       [Object],
//       [Object]
//     ]
//   }
// ]

cURL

4.1.2 Obtener una billetera

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({
  user_id: clientUserId
  account_id: clientAccountId,
  currency: "USDT",
  network: "USDT_BSC",
});

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

cURL

4.2 Agregar dirección a la lista blanca

Para garantizar la máxima seguridad de tus activos, en Notbank es necesario registrar previamente las direcciones de destino en una lista blanca antes de realizar cualquier transferencia de criptomonedas. Esta medida de protección adicional ayuda a prevenir retiros no autorizados y asegura que tus fondos se envíen únicamente a billeteras de confianza verificadas por ti.

4.2.1 Agregar una dirección

Node

// ...
const whitelistAddressId = await restClient.getWalletService().addWhitelistedAddress({
  user_id: clientUserId
  account_id: clientAccountId,
  currency: "USDT",
  network: "USDT_BSC",
  address: "2N3r9roRrHy7p6C5pGE8NQP9ZNT81H7ZKyU",
  label: "test-address-name",
  otp: "123456"
});

console.log(whitelistAddressId);
// f3d1ddc3-2767-4b99-8763-a0990361009d

El valor del parámetro otp corresponde al código de autenticación de dos pasos que entrega tu aplicación externa al momento de solicitar tu envío.

Notbank te enviará un código de confirmación a tu número de teléfono, con el cual tendrás que confirmar la nueva dirección que estás agregando a la lista blanca.

4.2.2 Confirmar una dirección

Node

// ...
await restClient.getWalletService().confirmWhitelistedAddress({
  user_id: clientUserId
  account_id: clientAccountId,
  whitelistedAddressId: "f3d1ddc3-2767-4b99-8763-a0990361009d",
  sms_code: "1234567",
});

4.3. Enviar tus criptomonedas hacia otra billetera

Node

// ...
const withdraw = await restClient.getWalletService().createCryptoWithdraw({
  user_id: clientUserId
  account_id: clientAccountId,
  currency: "USDT",
  network: "USDT_BSC",
  address: "2N3r9roRrHy7p6C5pGE8NQP9ZNT81H7ZKyU",
  amount: 12.3,
  otp: "123456"
});

console.log(withdraw);
// 0ea47288-76dd-4dd5-a544-e8af547ed3c7

cURL

El valor del parámetro otp corresponde al código de autenticación de dos pasos que entrega tu aplicación externa al momento de solicitar tu envío.

5. Comprar, vender y convertir criptomonedas

Descubre Simple, la funcionalidad diseñada para que la compra, venta y conversión de criptomonedas sea una experiencia simple, rápida y segura para todos. Olvídate de complejas interfaces y tipos de órdenes; con Simple, puedes ejecutar tus transacciones de manera intuitiva en pocos pasos. Esta herramienta es perfecta tanto para quienes se inician en el mundo cripto como para usuarios avanzados que buscan velocidad. Además de su facilidad de uso, Simple destaca por ofrecer una tarifa de transacción económica, permitiéndote optimizar tus operaciones y haciendo que tu incursión en el mercado cripto sea no solo eficiente, sino también accesible.

5.1 Comprar criptomonedas con moneda fiat

En este ejemplo, vamos a solicitar la cantidad de Bitcoin (BTC) que recibiríamos si utilizaramos $100.000 pesos chilenos (CLP). Luego consultaremos el monto prometido, que tiene una vigencia de 20 segundos y finalmente, ejecutaremos la compra.

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

5.1.1 Solicitar cotización

Node

const quoteId = await restClient.getQuoteService().createDirectQuote({
  from_currency: "CLP",
  from_amount: 100000,
  to_currency: "BTC",
  operation: 1, // BUY
  user_id: clientUserId
  account_id: clientAccountId,
});

console.log(quoteId)
// c1c56ca3-75c3-4bb6-97e3-702448382cd3

5.1.2 Consultar cotización

Node

// ...
const quote = await restClient.getQuoteService().getQuote({
  quote_id: "c1c56ca3-75c3-4bb6-97e3-702448382cd3",
  user_id: clientUserId
  account_id: clientAccountId,
});

console.log(quote.status)
// 0 // pendiente
console.log(quote.amount_out)
// 0.0013 // BTC

5.1.3 Ejecutar cotización

Node

// ...
const quote = await client.getQuoteService().executeQuote({
  quote_id: "c1c56ca3-75c3-4bb6-97e3-702448382cd3",
  user_id: clientUserId
  account_id: clientAccountId,
});

console.log(quote.status)
// 0 // pendiente
console.log(quote.amount_out)
// 0.0013 // BTC

// Luego de unos momentos, consultar de nuevo el estado de la solicitud
const quote = await restClient.getQuoteService().getQuote({
  quote_id: "c1c56ca3-75c3-4bb6-97e3-702448382cd3",
  user_id: clientUserId
  account_id: clientAccountId,
});

console.log(quote.status)
// 1 // ejecutado
console.log(quote.amount_out)
// 0.0013 // BTC

5.2 Vender criptomonedas en moneda fiat

En este ejemplo, vamos a solicitar la cantidad de pesos chilenos (CLP) que recibiríamos si utilizaramos 0.0013 Bitcoin (BTC). Luego consultaremos el monto prometido, que tiene una vigencia de 20 segundos y finalmente, ejecutaremos la compra.

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

5.2.1 Solicitar cotización

Node

const quoteId = await restClient.getQuoteService().createDirectQuote({
  from_currency: "BTC",
  from_amount: 0.0013,
  to_currency: "CLP",
  operation: 2, // SELL
  user_id: clientUserId
  account_id: clientAccountId,
});

console.log(quoteId)
// 1b09948d-2169-4f93-84ec-a55fb1741663

5.2.2 Consultar cotización

Node

// ...
const quote = await restClient.getQuoteService().getQuote({
  quote_id: "c1c56ca3-75c3-4bb6-97e3-702448382cd3",
  user_id: clientUserId
  account_id: clientAccountId,
});

console.log(quote.status)
// 0 // pendiente
console.log(quote.amount_out)
// 100000 // CLP

5.2.3 Ejecutar cotización

Node

// ...
const quote = await client.getQuoteService().executeQuote({
  quote_id: "1b09948d-2169-4f93-84ec-a55fb1741663",
  user_id: clientUserId
  account_id: clientAccountId,
});

console.log(quote.status)
// 0 // pendiente
console.log(quote.amount_out)
// 100000 // CLP

// Luego de unos momentos, consultar de nuevo el estado de la solicitud
const quote = await restClient.getQuoteService().getQuote({
  quote_id: "1b09948d-2169-4f93-84ec-a55fb1741663",
  user_id: clientUserId
  account_id: clientAccountId,
});

console.log(quote.status)
// 1 // ejecutado
console.log(quote.amount_out)
// 100000 // CLP

5.3 Convertir criptomonedas

En este ejemplo, vamos a solicitar la cantidad de Ethereum (ETH) que recibiríamos si utilizaramos 1 Bitcoin (BTC). 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.

5.3.1 Solicitar cotización

Node

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

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

5.3.2 Consultar cotización

Node

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

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

5.3.3 Ejecutar cotización

Node

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

console.log(quote.status)
// 0 // pendiente
console.log(quote.amount_out)
// 30 // 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",
  user_id: clientUserId
  account_id: clientAccountId,
});

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

6. Depositar y retirar fiat

Para facilitar la gestión de sus fondos, Notbank ofrece a sus usuarios una amplia variedad de métodos de pago diseñados para adaptarse a sus necesidades. Los clientes pueden cargar balance de moneda fiat en sus cuentas de manera rápida y segura, seleccionando entre opciones tradicionales como transferencias bancarias, el uso de tarjetas de crédito o la integración con modernas pasarelas de pago. Esta flexibilidad garantiza que cada usuario pueda gestionar su capital con total comodidad y bajo los más altos estándares de seguridad financiera.

6.1 Agregar cuenta bancaria

6.1.1 Obtener lista de bancos soportados

Node

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

console.log(banks);
// [
//   {
//     "id": "7aa9d19d-01b6-4993-8075-0e922bf471d2",
//     "name": "Banco de Chile",
//     "country": "CL"
//   },
//   {
//     "id": "388c4c6f-d0b5-4a42-927c-bbcc64e7ce2e",
//     "name": "Banco Estado",
//     "country": "CL"
//   }, ...
// ]

6.1.2 Agregar cuenta bancaria

Node

// ...
const userBankAccount =  restClient.getWalletService().AddClientBankAccount({
  user_id: clientUserId,
  country: "CL",
  bank: "388c4c6f-d0b5-4a42-927c-bbcc64e7ce2e",
  number: "11111111",
  kind: "vista",
  // pix_type: string; Solo Brasil (BR)
  // agency: string; Solo Brasil (BR)
  // dv: string; Solo Brasil (BR)
  // province?: string; Solo Perú (PE)
});

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

Glosario

Tipo de cuenta bancaria

País	Valor	Descripción
Argentina (AR), Chile (CL), Perú (PE), Colombia (CO)	corriente	Cuenta corriente
Argentina (AR), Chile (CL)	vista	Cuenta vista
Argentina (AR), Chile (CL), Perú (PE), Colombia (CO)	ahorro	Cuenta de ahorro
Argentina (AR), Chile (CL)	electronic_checkbook	Chequera electrónica
Argentina (AR)	ar_cbu	Cuenta CBU
Argentina (AR)	ar_cvu	Cuenta CVU
Argentina (AR)	ar_alias	Alias
Brasil (BR)	br_corriente_fisica	Cuenta corriente de persona física
Brasil (BR)	br_simple_fisica	Cuenta simple de persona física
Brasil (BR)	br_corriente_juridica	Cuenta corriente de persona jurídica
Brasil (BR)	br_poupanca_fisica	Cuenta poupanca de persona física
Brasil (BR)	br_poupanca_juridica	Cuenta poupanca de persona física
Brasil (BR)	br_caixa_facil	Cuenta Caixa Fácil
Brasil (BR)	br_pix	Cuenta PIX

Tipo de cuenta PIX

6.2 Notificar un depósito

En Notbank, hemos optimizado el proceso de recepción de fondos para ofrecerte una experiencia ágil y segura en la gestión de tus activos. Actualmente, admitimos la notificación de depósitos en moneda fiat a través de transferencias bancarias tradicionales para todos los países donde operamos, integrando además de forma exclusiva el método de Webpay para Chile, lo que permite una validación inmediata y eficiente para los usuarios en dicha región. Estamos trabajando continuamente en expandir nuestras capacidades operativas, por lo que próximamente añadiremos nuevos métodos de pago a nuestra API, brindando mayor flexibilidad y alcance a nuestras soluciones financieras globales.

6.2.1 Notificación bancaria

Node

// ...
await restClient.getWalletService().createFiatDeposit({
  user_id: clientUserId,
  account_id: clientAccountId,  
  payment_method: 1,  // bank transfer
  currency: "CLP",
  amount: 1000,
  bank_account_id: "29cd83cf-3678-4207-80c7-7caaa1d24c27",
  // voucher: File. Solo PE (Perú).
});

6.2.2 Notificación Webpay

Node

// ...
const url = await restClient.getWalletService().createFiatDeposit({
  user_id: clientUserId,
  account_id: clientAccountId,  
  payment_method: 2,  // webpay
  currency: "CLP",
  amount: 1000
});

console.log(url);
// https://...

6.3 Notificar un retiro

Notbank garantiza una experiencia financiera global al ofrecer el servicio de retiro de moneda fiat en todos los países donde la plataforma tiene presencia, permitiendo a los usuarios convertir sus activos digitales en dinero local de forma eficiente. No obstante, es importante destacar que existe un caso especial para Argentina: debido a procesos de validación específicos en dicha región, es indispensable que el usuario confirme la notificación del retiro dentro de la aplicación para completar la transacción con éxito.

6.3.1 Notificación de retiro bancario

Node

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

6.3.2 Notificación de retiro bancario en Argentina

Obtener información de una cuenta CBU de destino

Node

// ...
const owners = await restClient.getWalletService().getOwnersFiatWithdraw({
  cbu: "6845784411100069899422"
});

console.log(owners);
// [
//   {
//     "person_type": "F",
//     "cuit": "CUIT number",
//     "name": "Person name"
//   }, ...
// ]

Notificar un retiro bancario

Node

// ...
const withdrawId = await restClient.getWalletService().createFiatWithdraw({
  user_id: clientUserId,
  account_id: clientAccountId, 
  payment_method: 1,
  currency: "ARS",
  amount: 1000,
  cbu: "6845784411100069899422",
  person_type: "F",
  cuit: "CUIT number",
  name: "Person name"
});

console.log(withdrawId);
// 32347216-4a4c-49ee-b0a5-1ad993fe522b

Cuando notifiques un retiro bancario, Notbank te enviará un código de confirmación a tu correo electrónico que luego debes ingresar en la siguiente etapa.

Confirmar un retiro bancario

Node

// ...
await restClient.getWalletService().confirmFiatWithdraw({
  user_id: clientUserId,
  withdrawal_id: "32347216-4a4c-49ee-b0a5-1ad993fe522b",
  attempt_code: 123456
});