> For the complete documentation index, see [llms.txt](https://www.notbank.com/learn/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://www.notbank.com/learn/tutorial/crypto-as-a-service-con-reliance.md).

# Crypto as a  Service con reliance

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.

Notbank ofrece dos modalidades de su servicio **Crypto as a Service (CaaS)** diseñadas para distintos perfiles de clientes y necesidades operativas. El **CaaS estándar** proporciona una solución robusta de cumplimiento normativo que acompaña a cada cliente a través de un proceso de onboarding estructurado y exhaustivo. El **CaaS con reliance**, en cambio, está orientado a aquellas instituciones que ya cuentan con un marco de cumplimiento consolidado y una reputación verificable, lo que permite establecer un vínculo de confianza elevada entre las partes. Gracias a este nivel adicional de confianza —sustentado en acuerdos de responsabilidad compartida y validación mutua— el proceso de onboarding se agiliza considerablemente, reduciendo tiempos y fricciones operativas sin comprometer los estándares regulatorios exigidos.

Para poder comenzar a utilizar Crypto as a Service (CaaS) con reliance, 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](https://support.notbank.com/support/s/contactsupport?language=es) 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.

{% tabs %}
{% tab title="cURL" %}

```bash
GET /ap/AuthenticateUser HTTP/1.1
Host: https://api.notbank.com
Content-Type: application/json
APIKey: "<public-key>",
Signature: "<signature>",
UserId: "<user-uuid>",
Nonce: "2247733562"

---

{
  "Authenticated": true,
  "SessionToken": "02de4e6d-43f2-4e89-7213-49a9935d5607",  // token, aptoken
  // ...
}
```

***

`Nonce` cualquier número arbitrario o cadena aleatoria que se utilice con la llave privada de la API para generar una firma.

`Signature` es una cadena alfanumérica larga generada utilizando la llave privada de la API y el nonce. Para generar su propia firma con un `nonce` diferente, debe utilizar `HMAC-SHA256` para codificar su `Nonce`, `UserId` (ID de usuario) y llave pública de la API (`<public-key>`), en el formato `NonceUserIdAPIPublicKey` utilizando la llave secreta de la API (`<secret-key>`) como clave.
{% endtab %}

{% tab title="Node" %}

```js
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"
});
```

{% endtab %}
{% endtabs %}

## 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.

### 2.1 Registro de nivel básico

{% tabs %}
{% tab title="cURL" %}

```bash
POST /api/nb/account/register HTTP/1.1
Host: https://api.notbank.com
Content-Type: application/json
aptoken: <token>

{ 
  "first_name": "Juan",
  "last_name": "Perez",
  "phone_number": "+56911111111",
  "profession": "trader",
  "gender": "1",
  "birthdate": "01/01/1990",
  "citizenship": "BR",
  "identity_type": "1",
  "identity_number": "55330450314",
  "identity_country": "BR",
  "address_country": "BR",
  "address_city": "São Paulo",
  "address_street": "Calle 1",
  "address_postal_code": "123456",
  // solo Argentina (address_country=AR)
  "address_province": "1",
  "subject_comply": false,  // es sujeto obligado
  // solo Brasil (address_country=BR)
  "address_district": "Distrito 1",
  "address_number": "1234",
  "address_state": "SP",
  "address_complement": "Bloque 3" // opcional
  // solo Chile (address_country=CL)
  "address_comune": "Arica",
  // solo Perú (address_country=PE)
  "civil_status": "casado",
  "spouse_name": "María Soto",
  "pep": true,
  // solo Perú y PEP (pep=true)  
  "pep_position": "Alcalde",
  "pep_institution": "Municipalidad de Santiago",
  "pep_links_description": "Rodrigo Pérez (Padre)",
  "is_pep_family_member": true,
  // solo Perú y si familiar es PEP (is_pep_family_member=true)
  "pep_family_member_name": "Luis Pérez",
  "pep_family_member_relation": "Abuelo"
}

---

{
  "status": "success",
  "data": {
    "userId": "<client-user-id>",
    "token": "<client-jwt>"
  }
}
```

{% endtab %}
{% endtabs %}

#### 2.1.1 Glosario

{% tabs %}
{% tab title="Profesión" %}

| Valor                      | Descripción             |
| -------------------------- | ----------------------- |
| trader                     | Comerciante             |
| investor                   | Inversor                |
| student                    | Estudiante              |
| housewife                  | Ama de casa             |
| accountant                 | Contable                |
| actor\_actress             | Actor/Actriz            |
| air\_hostess               | Azafata                 |
| archaeologist              | Arqueólogo              |
| architect                  | Arquitecto              |
| astronaut                  | Astronauta              |
| baker                      | Panadero                |
| biologist                  | Biólogo                 |
| bricklayer                 | Albañil                 |
| driver                     | Conductor               |
| businessman                | Empresario              |
| butcher                    | Carnicero               |
| caretaker\_janitor\_porter | Conserje/Portero        |
| carpenter                  | Carpintero              |
| cashier                    | Cajero                  |
| cleaner                    | Limpiador               |
| clown                      | Payaso                  |
| cobbler                    | Zapatero                |
| cook\_chef                 | Cocinero/Chef           |
| chemist                    | Químico                 |
| dancer                     | Bailarín                |
| decorator                  | Decorador               |
| dentist                    | Dentista                |
| designer                   | Diseñador               |
| physician                  | Médico                  |
| dressmaker                 | Modista                 |
| dustman                    | Basurero                |
| economist                  | Economista              |
| electrician                | Electricista            |
| engineer                   | Ingeniero               |
| farmer                     | Agricultor              |
| fireman                    | Bombero                 |
| fisherman                  | Pescador                |
| florist                    | Florista                |
| fruiterer                  | Frutero                 |
| gardener                   | Jardinero               |
| geologist                  | Geólogo                 |
| hairdresser                | Peluquero               |
| jeweller                   | Joyero                  |
| journalist                 | Periodista              |
| judge                      | Juez                    |
| lawyer                     | Abogado                 |
| librarian                  | Bibliotecario           |
| life\_guard                | Socorrista              |
| mailman\_postman           | Cartero                 |
| mechanic                   | Mecánico                |
| meteorologist              | Meteorólogo             |
| cryptocurrency\_miner      | Minero de criptomonedas |
| mineral\_miner             | Minero                  |
| model                      | Modelo                  |
| nanny\_nursemaid           | Niñera                  |
| nun                        | Monja                   |
| nurse                      | Enfermera               |
| painter                    | Pintor                  |
| pastry\_cook               | Pastelero               |
| pharmacist                 | Farmacéutico            |
| photographer               | Fotógrafo               |
| physicist                  | Físico                  |
| plumber                    | Fontanero               |
| policeman\_policewoman     | Policía                 |
| politician                 | Político                |
| priest                     | Sacerdote               |
| professor\_teacher         | Profesor                |
| programmer                 | Programador             |
| psychiatrist               | Psiquiatra              |
| psychologist               | Psicólogo               |
| receptionist               | Recepcionista           |
| researcher\_scientist      | Investigador científico |
| sailor                     | Marinero                |
| salesman                   | Vendedor                |
| secretary                  | Secretario              |
| shop\_assistant            | Dependiente             |
| singer                     | Cantante                |
| social\_worker             | Trabajador social       |
| sportsman                  | Deportista              |
| surgeon                    | Cirujano                |
| taxi\_driver               | Taxista                 |
| telephone\_operator        | Operador telefónico     |
| travel\_agent              | Agente de viajes        |
| veterinarian               | Veterinario             |
| waiter\_waitress           | Camarero/Camarera       |
| writer                     | Escritor                |
| deliveryman                | Repartidor              |
| uber\_driver               | Conductor de Uber       |
| pilot                      | Piloto                  |
| administrative             | Administrativo          |
| public\_servant            | Funcionario público     |
| other                      | Otro                    |
| customer\_care             | Atención al cliente     |
| military                   | Militar                 |
| manager\_officier          | Gerente/Oficial         |
| {% endtab %}               |                         |

{% tab title="Género" %}

| Valor        | Descripción |
| ------------ | ----------- |
| 0            | Mujer       |
| 1            | Hombre      |
| {% endtab %} |             |

{% tab title="Tipo de identidad" %}

| Valor        | Descripción                                   |
| ------------ | --------------------------------------------- |
| 1            | DNI                                           |
| 2            | Extranjero                                    |
| 3            | NUIP: Número único de identificación personal |
| 4            | NIP: Número de identificación personal        |
| 5            | PEP: Permiso especial de permanencia          |
| 6            | CC: Cédula de ciudadanía                      |
| 7            | CE: Cédula de extranjería                     |
| 8            | Pasaporte                                     |
| {% endtab %} |                                               |

{% tab title="Provincia (AR)" %}

| Valor        | Descripción                                           |
| ------------ | ----------------------------------------------------- |
| 1            | Buenos Aires                                          |
| 10           | Catamarca                                             |
| 14           | Chaco                                                 |
| 20           | Chubut                                                |
| 43           | Ciudad Autónoma de Buenos Aires                       |
| 3            | Córdoba                                               |
| 15           | Corrientes                                            |
| 5            | Entre Ríos                                            |
| 13           | Formosa                                               |
| 11           | Jujuy                                                 |
| 18           | La Pampa                                              |
| 9            | La Rioja                                              |
| 4            | Mendoza                                               |
| 16           | Misiones                                              |
| 19           | Neuquén                                               |
| 21           | Río Negro                                             |
| 12           | Salta                                                 |
| 7            | San Juan                                              |
| 8            | San Luis                                              |
| 22           | Santa Cruz                                            |
| 2            | Santa Fe                                              |
| 6            | Santiago del Estero                                   |
| 23           | Tierra del Fuego, Antártida e Islas del Atlántico Sur |
| 17           | Tucumán                                               |
| {% endtab %} |                                                       |

{% tab title="Estado (BR)" %}

| Valor        | Descripción         |
| ------------ | ------------------- |
| RO           | Rondônia            |
| AC           | Acre                |
| AM           | Amazonas            |
| RR           | Roraima             |
| PA           | Pará                |
| AP           | Amapá               |
| TO           | Tocantins           |
| MA           | Maranhão            |
| PI           | Piauí               |
| CE           | Ceará               |
| RN           | Rio Grande do Norte |
| PB           | Paraíba             |
| PE           | Pernambuco          |
| AL           | Alagoas             |
| SE           | Sergipe             |
| BA           | Bahia               |
| MG           | Minas Gerais        |
| ES           | Espírito Santo      |
| RJ           | Rio de Janeiro      |
| SP           | São Paulo           |
| PR           | Paraná              |
| SC           | Santa Catarina      |
| RS           | Rio Grande do Sul   |
| MS           | Mato Grosso do Sul  |
| MT           | Mato Grosso         |
| GO           | Goiás               |
| DF           | Distrito Federal    |
| {% endtab %} |                     |

{% tab title="Comuna (CL)" %}

| Valor                        | Descripción                  |
| ---------------------------- | ---------------------------- |
| Arica                        | Arica                        |
| Camarones                    | Camarones                    |
| General Lagos                | General Lagos                |
| Putre                        | Putre                        |
| Alto Hospicio                | Alto Hospicio                |
| Camiña                       | Camiña                       |
| Colchane                     | Colchane                     |
| Huara                        | Huara                        |
| Iquique                      | Iquique                      |
| Pica                         | Pica                         |
| Pozo Almonte                 | Pozo Almonte                 |
| Antofagasta                  | Antofagasta                  |
| Calama                       | Calama                       |
| María Elena                  | María Elena                  |
| Mejillones                   | Mejillones                   |
| Ollagüe                      | Ollagüe                      |
| San Pedro de Atacama         | San Pedro de Atacama         |
| Sierra Gorda                 | Sierra Gorda                 |
| Taltal                       | Taltal                       |
| Tocopilla                    | Tocopilla                    |
| Alto del Carmen              | Alto del Carmen              |
| Caldera                      | Caldera                      |
| Chañaral                     | Chañaral                     |
| Copiapó                      | Copiapó                      |
| Diego de Almagro             | Diego de Almagro             |
| Freirina                     | Freirina                     |
| Huasco                       | Huasco                       |
| Tierra Amarilla              | Tierra Amarilla              |
| Vallenar                     | Vallenar                     |
| Andacollo                    | Andacollo                    |
| Canela                       | Canela                       |
| Combarbalá                   | Combarbalá                   |
| Coquimbo                     | Coquimbo                     |
| Illapel                      | Illapel                      |
| La Higuera                   | La Higuera                   |
| La Serena                    | La Serena                    |
| Los Vilos                    | Los Vilos                    |
| Monte Patria                 | Monte Patria                 |
| Ovalle                       | Ovalle                       |
| Paiguano                     | Paiguano                     |
| Punitaqui                    | Punitaqui                    |
| Río Hurtado                  | Río Hurtado                  |
| Salamanca                    | Salamanca                    |
| Vicuña                       | Vicuña                       |
| Algarrobo                    | Algarrobo                    |
| Cabildo                      | Cabildo                      |
| Calera                       | Calera                       |
| Calle Larga                  | Calle Larga                  |
| Cartagena                    | Cartagena                    |
| Casablanca                   | Casablanca                   |
| Catemu                       | Catemu                       |
| Concón                       | Concón                       |
| El Quisco                    | El Quisco                    |
| El Tabo                      | El Tabo                      |
| Hijuelas                     | Hijuelas                     |
| Isla de Pascua               | Isla de Pascua               |
| Juan Fernández               | Juan Fernández               |
| La Cruz                      | La Cruz                      |
| La Ligua                     | La Ligua                     |
| Limache                      | Limache                      |
| Llaillay                     | Llaillay                     |
| Los Andes                    | Los Andes                    |
| Nogales                      | Nogales                      |
| Olmué                        | Olmué                        |
| Panquehue                    | Panquehue                    |
| Papudo                       | Papudo                       |
| Petorca                      | Petorca                      |
| Puchuncaví                   | Puchuncaví                   |
| Putaendo                     | Putaendo                     |
| Quillota                     | Quillota                     |
| Quilpué                      | Quilpué                      |
| Quintero                     | Quintero                     |
| Rinconada                    | Rinconada                    |
| San Antonio                  | San Antonio                  |
| San Esteban                  | San Esteban                  |
| San Felipe                   | San Felipe                   |
| Santa María                  | Santa María                  |
| Santo Domingo                | Santo Domingo                |
| Valparaíso                   | Valparaíso                   |
| Villa Alemana                | Villa Alemana                |
| Viña del Mar                 | Viña del Mar                 |
| Zapallar                     | Zapallar                     |
| Alhué                        | Alhué                        |
| Buin                         | Buin                         |
| Calera de Tango              | Calera de Tango              |
| Cerrillos                    | Cerrillos                    |
| Cerro Navia                  | Cerro Navia                  |
| Colina                       | Colina                       |
| Conchalí                     | Conchalí                     |
| Curacaví                     | Curacaví                     |
| El Bosque                    | El Bosque                    |
| El Monte                     | El Monte                     |
| Estación Central             | Estación Central             |
| Huechuraba                   | Huechuraba                   |
| Independencia                | Independencia                |
| Isla de Maipo                | Isla de Maipo                |
| La Cisterna                  | La Cisterna                  |
| La Florida                   | La Florida                   |
| La Granja                    | La Granja                    |
| La Pintana                   | La Pintana                   |
| La Reina                     | La Reina                     |
| Lampa                        | Lampa                        |
| Las Condes                   | Las Condes                   |
| Lo Barnechea                 | Lo Barnechea                 |
| Lo Espejo                    | Lo Espejo                    |
| Lo Prado                     | Lo Prado                     |
| Macul                        | Macul                        |
| Maipú                        | Maipú                        |
| María Pinto                  | María Pinto                  |
| Melipilla                    | Melipilla                    |
| Ñuñoa                        | Ñuñoa                        |
| Padre Hurtado                | Padre Hurtado                |
| Paine                        | Paine                        |
| Pedro Aguirre Cerda          | Pedro Aguirre Cerda          |
| Peñaflor                     | Peñaflor                     |
| Peñalolén                    | Peñalolén                    |
| Pirque                       | Pirque                       |
| Providencia                  | Providencia                  |
| Pudahuel                     | Pudahuel                     |
| Puente Alto                  | Puente Alto                  |
| Quilicura                    | Quilicura                    |
| Quinta Normal                | Quinta Normal                |
| Recoleta                     | Recoleta                     |
| Renca                        | Renca                        |
| San Bernardo                 | San Bernardo                 |
| San Joaquín                  | San Joaquín                  |
| San José de Maipo            | San José de Maipo            |
| San Miguel                   | San Miguel                   |
| San Pedro                    | San Pedro                    |
| San Ramón                    | San Ramón                    |
| Santiago                     | Santiago                     |
| Talagante                    | Talagante                    |
| Tiltil                       | Tiltil                       |
| Vitacura                     | Vitacura                     |
| Chimbarongo                  | Chimbarongo                  |
| Chépica                      | Chépica                      |
| Codegua                      | Codegua                      |
| Coinco                       | Coinco                       |
| Coltauco                     | Coltauco                     |
| Doñihue                      | Doñihue                      |
| Graneros                     | Graneros                     |
| La Estrella                  | La Estrella                  |
| Las Cabras                   | Las Cabras                   |
| Litueche                     | Litueche                     |
| Lolol                        | Lolol                        |
| Machalí                      | Machalí                      |
| Malloa                       | Malloa                       |
| Marchihue                    | Marchihue                    |
| Nancagua                     | Nancagua                     |
| Navidad                      | Navidad                      |
| Olivar                       | Olivar                       |
| Palmilla                     | Palmilla                     |
| Paredones                    | Paredones                    |
| Peralillo                    | Peralillo                    |
| Peumo                        | Peumo                        |
| Pichidegua                   | Pichidegua                   |
| Pichilemu                    | Pichilemu                    |
| Placilla                     | Placilla                     |
| Pumanque                     | Pumanque                     |
| Quinta de Tilcoco            | Quinta de Tilcoco            |
| Rancagua                     | Rancagua                     |
| Rengo                        | Rengo                        |
| Requínoa                     | Requínoa                     |
| San Fernando                 | San Fernando                 |
| San Francisco de Mostazal    | San Francisco de Mostazal    |
| San Vicente de Tagua Tagua   | San Vicente de Tagua Tagua   |
| Santa Cruz                   | Santa Cruz                   |
| Cauquenes                    | Cauquenes                    |
| Chanco                       | Chanco                       |
| Colbún                       | Colbún                       |
| Constitución                 | Constitución                 |
| Curepto                      | Curepto                      |
| Curicó                       | Curicó                       |
| Empedrado                    | Empedrado                    |
| Hualañé                      | Hualañé                      |
| Licantén                     | Licantén                     |
| Linares                      | Linares                      |
| Longaví                      | Longaví                      |
| Maule                        | Maule                        |
| Molina                       | Molina                       |
| Parral                       | Parral                       |
| Pelarco                      | Pelarco                      |
| Pelluhue                     | Pelluhue                     |
| Pencahue                     | Pencahue                     |
| Rauco                        | Rauco                        |
| Retiro                       | Retiro                       |
| Romeral                      | Romeral                      |
| Río Claro                    | Río Claro                    |
| Sagrada Familia              | Sagrada Familia              |
| San Clemente                 | San Clemente                 |
| San Javier de Loncomilla     | San Javier de Loncomilla     |
| San Rafael                   | San Rafael                   |
| Talca                        | Talca                        |
| Teno                         | Teno                         |
| Vichuquén                    | Vichuquén                    |
| Villa Alegre                 | Villa Alegre                 |
| Yerbas Buenas                | Yerbas Buenas                |
| Bulnes                       | Bulnes                       |
| Chillán Viejo                | Chillán Viejo                |
| Chillán                      | Chillán                      |
| Cobquecura                   | Cobquecura                   |
| Coelemu                      | Coelemu                      |
| Coihueco                     | Coihueco                     |
| El Carmen                    | El Carmen                    |
| Ninhue                       | Ninhue                       |
| Ñiquén                       | Ñiquén                       |
| Pemuco                       | Pemuco                       |
| Pinto                        | Pinto                        |
| Portezuelo                   | Portezuelo                   |
| Quillón                      | Quillón                      |
| Quirihue                     | Quirihue                     |
| Ránquil                      | Ránquil                      |
| San Carlos                   | San Carlos                   |
| San Fabián                   | San Fabián                   |
| San Ignacio                  | San Ignacio                  |
| San Nicolás                  | San Nicolás                  |
| Treguaco                     | Treguaco                     |
| Yungay                       | Yungay                       |
| Alto Biobío                  | Alto Biobío                  |
| Antuco                       | Antuco                       |
| Arauco                       | Arauco                       |
| Cabrero                      | Cabrero                      |
| Cañete                       | Cañete                       |
| Chiguayante                  | Chiguayante                  |
| Concepción                   | Concepción                   |
| Contulmo                     | Contulmo                     |
| Coronel                      | Coronel                      |
| Curanilahue                  | Curanilahue                  |
| Florida                      | Florida                      |
| Hualpén                      | Hualpén                      |
| Hualqui                      | Hualqui                      |
| Laja                         | Laja                         |
| Lebu                         | Lebu                         |
| Los Álamos                   | Los Álamos                   |
| Los Ángeles                  | Los Ángeles                  |
| Lota                         | Lota                         |
| Mulchén                      | Mulchén                      |
| Nacimiento                   | Nacimiento                   |
| Negrete                      | Negrete                      |
| Penco                        | Penco                        |
| Quilaco                      | Quilaco                      |
| Quilleco                     | Quilleco                     |
| San Pedro de la Paz          | San Pedro de la Paz          |
| San Rosendo                  | San Rosendo                  |
| Santa Bárbara                | Santa Bárbara                |
| Santa Juana                  | Santa Juana                  |
| Talcahuano                   | Talcahuano                   |
| Tirúa                        | Tirúa                        |
| Tomé                         | Tomé                         |
| Tucapel                      | Tucapel                      |
| Yumbel                       | Yumbel                       |
| Angol                        | Angol                        |
| Carahue                      | Carahue                      |
| Cholchol                     | Cholchol                     |
| Collipulli                   | Collipulli                   |
| Cunco                        | Cunco                        |
| Curacautín                   | Curacautín                   |
| Curarrehue                   | Curarrehue                   |
| Ercilla                      | Ercilla                      |
| Freire                       | Freire                       |
| Galvarino                    | Galvarino                    |
| Gorbea                       | Gorbea                       |
| Lautaro                      | Lautaro                      |
| Loncoche                     | Loncoche                     |
| Lonquimay                    | Lonquimay                    |
| Los Sauces                   | Los Sauces                   |
| Lumaco                       | Lumaco                       |
| Melipeuco                    | Melipeuco                    |
| Nueva Imperial               | Nueva Imperial               |
| Padre las Casas              | Padre las Casas              |
| Perquenco                    | Perquenco                    |
| Pitrufquén                   | Pitrufquén                   |
| Pucón                        | Pucón                        |
| Purén                        | Purén                        |
| Renaico                      | Renaico                      |
| Saavedra                     | Saavedra                     |
| Temuco                       | Temuco                       |
| Teodoro Schmidt              | Teodoro Schmidt              |
| Toltén                       | Toltén                       |
| Traiguén                     | Traiguén                     |
| Victoria                     | Victoria                     |
| Vilcún                       | Vilcún                       |
| Villarrica                   | Villarrica                   |
| Corral                       | Corral                       |
| Futrono                      | Futrono                      |
| La Unión                     | La Unión                     |
| Lago Ranco                   | Lago Ranco                   |
| Lanco                        | Lanco                        |
| Los Lagos                    | Los Lagos                    |
| Mariquina                    | Mariquina                    |
| Máfil                        | Máfil                        |
| Paillaco                     | Paillaco                     |
| Panguipulli                  | Panguipulli                  |
| Río Bueno                    | Río Bueno                    |
| Valdivia                     | Valdivia                     |
| Ancud                        | Ancud                        |
| Calbuco                      | Calbuco                      |
| Castro                       | Castro                       |
| Chaitén                      | Chaitén                      |
| Chonchi                      | Chonchi                      |
| Cochamó                      | Cochamó                      |
| Curaco de Vélez              | Curaco de Vélez              |
| Dalcahue                     | Dalcahue                     |
| Fresia                       | Fresia                       |
| Frutillar                    | Frutillar                    |
| Futaleufú                    | Futaleufú                    |
| Hualaihué                    | Hualaihué                    |
| Llanquihue                   | Llanquihue                   |
| Los Muermos                  | Los Muermos                  |
| Maullín                      | Maullín                      |
| Osorno                       | Osorno                       |
| Palena                       | Palena                       |
| Puerto Montt                 | Puerto Montt                 |
| Puerto Octay                 | Puerto Octay                 |
| Puerto Varas                 | Puerto Varas                 |
| Puqueldón                    | Puqueldón                    |
| Purranque                    | Purranque                    |
| Puyehue                      | Puyehue                      |
| Queilén                      | Queilén                      |
| Quellón                      | Quellón                      |
| Quemchi                      | Quemchi                      |
| Quinchao                     | Quinchao                     |
| Río Negro                    | Río Negro                    |
| San Juan de la Costa         | San Juan de la Costa         |
| San Pablo                    | San Pablo                    |
| Aisén                        | Aisén                        |
| Chile Chico                  | Chile Chico                  |
| Cisnes                       | Cisnes                       |
| Cochrane                     | Cochrane                     |
| Coihaique                    | Coihaique                    |
| Guaitecas                    | Guaitecas                    |
| Lago Verde                   | Lago Verde                   |
| O’Higgins                    | O’Higgins                    |
| Río Ibáñez                   | Río Ibáñez                   |
| Tortel                       | Tortel                       |
| Antártica                    | Antártica                    |
| Cabo de Hornos (Ex Navarino) | Cabo de Hornos (Ex Navarino) |
| Laguna Blanca                | Laguna Blanca                |
| Natales                      | Natales                      |
| Porvenir                     | Porvenir                     |
| Primavera                    | Primavera                    |
| Punta Arenas                 | Punta Arenas                 |
| Río Verde                    | Río Verde                    |
| San Gregorio                 | San Gregorio                 |
| Timaukel                     | Timaukel                     |
| Torres del Paine             | Torres del Paine             |
| {% endtab %}                 |                              |

{% tab title="Estado civil (PE)" %}

| Valor         | Descripción |
| ------------- | ----------- |
| soltero       | Soltero     |
| casado        | Casado      |
| conviviente   | Conviviente |
| divorciado    | Divorciado  |
| viudo         | Viudo       |
| {% endtab %}  |             |
| {% endtabs %} |             |

### 2.2. Registro de nivel avanzado

{% tabs %}
{% tab title="cURL" %}

```bash
POST /api/nb/account/register HTTP/1.1
Host: https://api.notbank.com
Content-Type: application/json
aptoken: <token>

{
  // incluir todos los parámetros del registo básico más los siguientes parámetros:
  "pep": false,  // es persona expuesta políticamente
  "is_public_servant": true,  // es servidor público
  "subject_comply": false,  // es sujeto obligado
}

---

{
  "status": "success",
  "data": {
    "userId": "<client-user-id>",
    "token": "<client-jwt>"
  }
}
```

{% endtab %}
{% endtabs %}

## 3. Obtener cuentas

**Notbank** te ofrece diferentes tipos de cuentas: la **cuenta primaria**, pensada para tus operaciones del día a día, la **cuenta yield**, diseñada para que tu dinero trabaje y genere rendimientos. Además, puedes crear **múltiples subcuentas**, lo que te permite mantener tus balances perfectamente organizados — separando, por ejemplo, tus fondos operativos de tus ahorros.

{% hint style="warning" %}
Si necesita realizar la operación sobre la cuenta de su cliente, debe incluir los parámetros `user_id` retornado en el registro y el valor del parámetro  `account_id`  debe ser la cuenta de su cliente. En caso contrario, solo su `account_id` y la operación se hará sobre el usuario autenticado.
{% endhint %}

{% tabs %}
{% tab title="cURL" %}

```bash
GET /api/nb/account?user_id=<clientUserId>&account_id=<clientAccountId> HTTP/1.1
Host: https://api.notbank.com
aptoken: <token>

----

{
  "status": "success",
  "data": [
    {
      "id": 12345,  // account_id
      "type": 1,
    }, ...
  ]
}
```

{% endtab %}
{% endtabs %}

### 3.1 Glosario

{% tabs %}
{% tab title="Tipo de cuenta" %}

| Valor         | Descripción             |
| ------------- | ----------------------- |
| 1             | Cuenta primaria. Única. |
| 3             | Cuenta yield. Única.    |
| 5             | Sub cuenta. Múltiples.  |
| {% endtab %}  |                         |
| {% endtabs %} |                         |

## 4. Recibir y enviar 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.

{% tabs %}
{% tab title="cURL" %}

```bash
GET /api/nb/wallet/crypto/withdrawal/templates?currency=USDT HTTP/1.1
Host: https://api.notbank.com
aptoken: <token>

----

{
  "status": "success",
  "data": [
    {
      "currency": "USDT",
      "network": "USDT_ETH",
      "network_name": "Ethereum",
      "network_protocol": "ERC-20",
      "template": [...]
    }, ...
  ]
}
```

{% endtab %}

{% tab title="Node" %}

```js
// ...
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]
//     ]
//   }
// ]
```

{% endtab %}
{% endtabs %}

#### 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.&#x20;

{% hint style="warning" %}
Si necesita realizar la operación sobre la cuenta de su cliente, debe incluir los parámetros `user_id` retornado en el registro y el valor del parámetro  `account_id`  debe ser la cuenta de su cliente. En caso contrario, solo su `account_id` y la operación se hará sobre el usuario autenticado.
{% endhint %}

{% tabs %}
{% tab title="cURL" %}

```bash
GET /api/nb/wallet/crypto?user_id=clientUserId&account_id=clientAccountId&currency=USDT&network=USDT_ETH HTTP/1.1
Host: https://api.notbank.com
aptoken: <token>

----

{
  "status": "success",
  "data": [
    "2N3r9roRrHy7p6C5pGE8NQP9ZNT81H7ZKyU"
  ]
}
```

{% endtab %}

{% tab title="Node" %}

```js
// ...
const addresses = await restClient.getWalletService().getDepositAddresses({
  user_id: clientUserId
  account_id: clientAccountId,
  currency: "USDT",
  network: "USDT_ETH",
});

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

{% endtab %}
{% endtabs %}

### 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

{% hint style="warning" %}
Si necesita realizar la operación sobre la cuenta de su cliente, debe incluir los parámetros `user_id` retornado en el registro y el valor del parámetro  `account_id`  debe ser la cuenta de su cliente. En caso contrario, solo su `account_id` y la operación se hará sobre el usuario autenticado.
{% endhint %}

{% tabs %}
{% tab title="Node" %}

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

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

{% endtab %}
{% endtabs %}

{% hint style="info" %}
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.
{% endhint %}

{% hint style="info" %}
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.
{% endhint %}

#### 4.2.2 Confirmar una dirección

{% hint style="warning" %}
Si necesita realizar la operación sobre la cuenta de su cliente, debe incluir los parámetros `user_id` retornado en el registro y el valor del parámetro  `account_id`  debe ser la cuenta de su cliente. En caso contrario, solo su `account_id` y la operación se hará sobre el usuario autenticado.
{% endhint %}

{% tabs %}
{% tab title="Node" %}

<pre class="language-js"><code class="lang-js">// ...
await restClient.getWalletService().confirmWhitelistedAddress({
<strong>  user_id: clientUserId
</strong>  account_id: clientAccountId,
  whitelistedAddressId: "f3d1ddc3-2767-4b99-8763-a0990361009d",
  sms_code: "1234567",
});
</code></pre>

{% endtab %}
{% endtabs %}

### 4.3. Enviar tus criptomonedas hacia otra billetera

{% hint style="warning" %}
Si necesita realizar la operación sobre la cuenta de su cliente, debe incluir los parámetros `user_id` retornado en el registro y el valor del parámetro  `account_id`  debe ser la cuenta de su cliente. En caso contrario, solo su `account_id` y la operación se hará sobre el usuario autenticado.
{% endhint %}

{% tabs %}
{% tab title="cURL" %}

```bash
POST /api/nb/wallet/crypto/withdrawal HTTP/1.1
Host: https://api.notbank.com
aptoken: <token>
Content-Type: application/json

{
  "user_id": clientUserId,
  "account_id": clientAccountId,
  "currency": "USDT",
  "network": "USDT_BSC",
  "address": "2N3r9roRrHy7p6C5pGE8NQP9ZNT81H7ZKyU",
  "amount": 12.3,
  "otp": "123456"
}

----

{
  "status": "success",
  "data": "0ea47288-76dd-4dd5-a544-e8af547ed3c7"
}
```

{% endtab %}

{% tab title="Node" %}

```js
// ...
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
```

{% endtab %}
{% endtabs %}

{% hint style="info" %}
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.
{% endhint %}

## 5. Transferir fondos

### 5.1 Transferir fondos utilizando los identificadores de cuenta

En este ejemplo, vamos a solicitar una transferencia de `1000` `USDT` desde su cuenta `accountId` hacia la cuenta de su cliente `clientAccountId` .

{% tabs %}
{% tab title="cURL" %}

```bash
POST /api/nb/wallet/transfer-funds HTTP/1.1
Host: https://api.notbank.com
aptoken: <token>
Content-Type: application/json

{
  "sender_account_id": accountId,
  "receiver_account_id": clientAccountId,
  "currency_name": "USDT",
  "amount": "1000",
  "notes": "Nota de prueba",  // opcional
  "otp": "123456"
}

----

{
  "status": "success",
  "data": 12345 // identificador de la transferencia
}
```

{% endtab %}

{% tab title="Node" %}

```js
import Notbank from 'notbank'

const transferId = await restClient.getWalletService().transferFunds({
  "sender_account_id": accountId,
  "receiver_account_id": clientAccountId,
  "currency_name": "USDT",
  "amount": 1000,
  "notes": "Nota de prueba",
  "otp": "123456"
});

console.log(transferId)
// 12345
```

{% endtab %}
{% endtabs %}

{% hint style="info" %}
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.
{% endhint %}

## 6. 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.

### 6.1 Comprar criptomonedas con moneda fiat

En este ejemplo, vamos a solicitar la cantidad de Tether (USDT) que recibiríamos si utilizaramos $100.000 reales brasileños (BRL).  Luego consultaremos el monto prometido, que tiene una vigencia de 20 segundos y finalmente, ejecutaremos la compra.

{% hint style="info" %}
Los montos adjuntos en los ejemplos son con fines educativos y no representan el estado actual del mercado.
{% endhint %}

#### 6.1.1 Solicitar cotización

{% hint style="warning" %}
Si necesita realizar la operación sobre la cuenta de su cliente, debe incluir los parámetros `user_id` retornado en el registro y el valor del parámetro  `account_id`  debe ser la cuenta de su cliente. En caso contrario, solo su `account_id` y la operación se hará sobre el usuario autenticado.
{% endhint %}

{% tabs %}
{% tab title="Node" %}

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

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

{% endtab %}
{% endtabs %}

#### 6.1.2 Consultar cotización

{% hint style="warning" %}
Si necesita realizar la operación sobre la cuenta de su cliente, debe incluir los parámetros `user_id` retornado en el registro y el valor del parámetro  `account_id`  debe ser la cuenta de su cliente. En caso contrario, solo su `account_id` y la operación se hará sobre el usuario autenticado.
{% endhint %}

{% tabs %}
{% tab title="Node" %}

```js
// ...
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 // USDT
```

{% endtab %}
{% endtabs %}

#### 6.1.3 Ejecutar cotización

{% hint style="warning" %}
Si necesita realizar la operación sobre la cuenta de su cliente, debe incluir los parámetros `user_id` retornado en el registro y el valor del parámetro  `account_id`  debe ser la cuenta de su cliente. En caso contrario, solo su `account_id` y la operación se hará sobre el usuario autenticado.
{% endhint %}

{% tabs %}
{% tab title="Node" %}

```js
// ...
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 // USDT

// 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 // USDT
```

{% endtab %}
{% endtabs %}

### 6.2 Vender criptomonedas en moneda fiat

En este ejemplo, vamos a solicitar la cantidad de reales brasileños (BRL) que recibiríamos si utilizaramos 0.0013 Tether (USDT).  Luego consultaremos el monto prometido, que tiene una vigencia de 20 segundos y finalmente, ejecutaremos la compra.

{% hint style="info" %}
Los montos adjuntos en los ejemplos son con fines educativos y no representan el estado actual del mercado.
{% endhint %}

#### 6.2.1 Solicitar cotización

{% hint style="warning" %}
Si necesita realizar la operación sobre la cuenta de su cliente, debe incluir los parámetros `user_id` retornado en el registro y el valor del parámetro  `account_id`  debe ser la cuenta de su cliente. En caso contrario, solo su `account_id` y la operación se hará sobre el usuario autenticado.
{% endhint %}

{% tabs %}
{% tab title="Node" %}

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

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

{% endtab %}
{% endtabs %}

#### 6.2.2 Consultar cotización

{% hint style="warning" %}
Si necesita realizar la operación sobre la cuenta de su cliente, debe incluir los parámetros `user_id` retornado en el registro y el valor del parámetro  `account_id`  debe ser la cuenta de su cliente. En caso contrario, solo su `account_id` y la operación se hará sobre el usuario autenticado.
{% endhint %}

{% tabs %}
{% tab title="Node" %}

```js
// ...
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 // BRL
```

{% endtab %}
{% endtabs %}

#### 6.2.3 Ejecutar cotización

{% hint style="warning" %}
Si necesita realizar la operación sobre la cuenta de su cliente, debe incluir los parámetros `user_id` retornado en el registro y el valor del parámetro  `account_id`  debe ser la cuenta de su cliente. En caso contrario, solo su `account_id` y la operación se hará sobre el usuario autenticado.
{% endhint %}

{% tabs %}
{% tab title="Node" %}

```js
// ...
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 // BRL

// 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 // BRL
```

{% endtab %}
{% endtabs %}

### 6.3 Convertir criptomonedas

**Notbank te ofrece dos modalidades de cotización para convertir monedas.** Con la cotización directa, simplemente ingresa el monto que deseas convertir y selecciona la moneda de origen y la moneda de destino; el sistema te mostrará inmediatamente cuánto dinero recibirás en la divisa final. La cotización inversa funciona al revés: tú indicas el monto que necesitas recibir en la moneda de destino y especificas la moneda de origen, y el sistema calcula automáticamente cuánto dinero necesitas en la moneda original para obtener exactamente esa cantidad. De esta forma, puedes elegir la opción que mejor se adapte a tu necesidad: calcular el resultado de una conversión o determinar cuánto necesitas tener en la moneda de partida.

{% hint style="success" %}
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.
{% endhint %}

{% hint style="info" %}
Los montos adjuntos en los ejemplos son con fines educativos y no representan el estado actual del mercado.
{% endhint %}

#### 6.3.1 Solicitar cotización

{% hint style="warning" %}
Si necesita realizar la operación sobre la cuenta de su cliente, debe incluir los parámetros `user_id` retornado en el registro y el valor del parámetro  `account_id`  debe ser la cuenta de su cliente. En caso contrario, solo su `account_id` y la operación se hará sobre el usuario autenticado.
{% endhint %}

En este ejemplo, vamos a solicitar la cantidad de Tether (USDT) que recibiríamos si utilizáramos 1 Bitcoin (BTC).  Luego consultaremos el monto prometido, que tiene una vigencia de 20 segundos y finalmente, ejecutaremos la compra.

{% tabs %}
{% tab title="Node" %}

```js
// cotización directa
const quoteId = await restClient.getQuoteService().createDirectQuote({
  from_currency: "BTC",
  from_amount: 1,
  to_currency: "USDT",
  operation: 3, // CONVERSION
  user_id: clientUserId
  account_id: clientAccountId,
});

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

{% endtab %}
{% endtabs %}

En este ejemplo, vamos a solicitar la cantidad de Bitcoin (BTC) que necesitaríamos si quisiéramos 100 Tether (USDT).  Luego consultaremos el monto prometido, que tiene una vigencia de 20 segundos y finalmente, ejecutaremos la compra.

{% tabs %}
{% tab title="Node" %}

```js
// cotización inversa
const quoteId = await restClient.getQuoteService().createInverseQuote({
  from_currency: "BTC",
  to_amount: 100,
  to_currency: "USDT",
  operation: 3, // CONVERSION
  user_id: clientUserId
  account_id: clientAccountId,
});

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

{% endtab %}
{% endtabs %}

#### 6.3.2 Consultar cotización

{% hint style="warning" %}
Si necesita realizar la operación sobre la cuenta de su cliente, debe incluir los parámetros `user_id` retornado en el registro y el valor del parámetro  `account_id`  debe ser la cuenta de su cliente. En caso contrario, solo su `account_id` y la operación se hará sobre el usuario autenticado.
{% endhint %}

{% tabs %}
{% tab title="Node" %}

```js
// ...
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 // USDT
```

{% endtab %}
{% endtabs %}

#### 6.3.3 Ejecutar cotización

{% hint style="warning" %}
Si necesita realizar la operación sobre la cuenta de su cliente, debe incluir los parámetros `user_id` retornado en el registro y el valor del parámetro  `account_id`  debe ser la cuenta de su cliente. En caso contrario, solo su `account_id` y la operación se hará sobre el usuario autenticado.
{% endhint %}

{% tabs %}
{% tab title="Node" %}

```js
// ...
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 // USDT

// 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 // USDT
```

{% endtab %}
{% endtabs %}

## 7. 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.

### 7.1 Agregar cuenta bancaria

#### 7.1.1 Obtener lista de bancos soportados

{% hint style="warning" %}
Si necesita realizar la operación sobre la cuenta de su cliente, debe incluir los parámetros `user_id` retornado en el registro y el valor del parámetro  `account_id`  debe ser la cuenta de su cliente. En caso contrario, solo su `account_id` y la operación se hará sobre el usuario autenticado.
{% endhint %}

{% tabs %}
{% tab title="Node" %}

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

console.log(banks);
// {
//   "status": "success",
//   "data": [
//     {
//       "id": "9ad5a964-f91c-4a7d-8257-119c97cf960a",
//       "name": "CAIXA ECONOMICA FEDERAL",
//       "country": "BR"
//     }, ...
//   ]
// }

```

{% endtab %}
{% endtabs %}

#### 7.1.2 Agregar cuenta bancaria

{% hint style="warning" %}
Si necesita realizar la operación sobre la cuenta de su cliente, debe incluir los parámetros `user_id` retornado en el registro y el valor del parámetro  `account_id`  debe ser la cuenta de su cliente. En caso contrario, solo su `account_id` y la operación se hará sobre el usuario autenticado.
{% endhint %}

{% tabs %}
{% tab title="Node" %}

```js
// ...
const userBankAccount =  restClient.getWalletService().AddClientBankAccount({
  user_id: clientUserId,
  country: "BR",
  bank: "9ad5a964-f91c-4a7d-8257-119c97cf960a",
  number: "55330450314",
  kind: "br_pix",
  pix_type: "CPF",  // Solo Brasil (BR)
  // agency: "",  // Solo Brasil (BR) si kind != br_pix
  // dv: "", // Solo Brasil (BR) si kind != br_pix
  // province?: string; Solo Perú (PE)
});

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

{% endtab %}
{% endtabs %}

#### Glosario

{% tabs %}
{% tab title="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                           |
| {% endtab %}                                         |                         |                                      |

{% tab title="Tipo de cuenta PIX" %}

| Valor         | Descripción        |
| ------------- | ------------------ |
| CPF           | Número CPF         |
| CNPJ          | Número CNPJ        |
| EMAIL         | Correo electrónico |
| Phone         | Número de teléfono |
| Otro          | Otro               |
| {% endtab %}  |                    |
| {% endtabs %} |                    |

### 7.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 o PIX para Brasil, 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.

#### 7.2.1 Notificación bancaria

{% hint style="warning" %}
Si necesita realizar la operación sobre la cuenta de su cliente, debe incluir los parámetros `user_id` retornado en el registro y el valor del parámetro  `account_id`  debe ser la cuenta de su cliente. En caso contrario, solo su `account_id` y la operación se hará sobre el usuario autenticado.
{% endhint %}

{% tabs %}
{% tab title="Node" %}

<pre class="language-js"><code class="lang-js">// ...
await restClient.getWalletService().createFiatDeposit({
<strong>  user_id: clientUserId,
</strong>  account_id: clientAccountId,  
  payment_method: 1,  // bank transfer
  currency: "BRL",
  amount: 1000,
  bank_account_id: "29cd83cf-3678-4207-80c7-7caaa1d24c27",
  // voucher: File. Solo PE (Perú).
});
</code></pre>

{% endtab %}
{% endtabs %}

### 7.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.

#### 7.3.1 Notificación de retiro bancario

{% hint style="warning" %}
Si necesita realizar la operación sobre la cuenta de su cliente, debe incluir los parámetros `user_id` retornado en el registro y el valor del parámetro  `account_id`  debe ser la cuenta de su cliente. En caso contrario, solo su `account_id` y la operación se hará sobre el usuario autenticado.
{% endhint %}

{% tabs %}
{% tab title="Node" %}

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

{% endtab %}
{% endtabs %}

#### 7.3.2 Notificación de retiro bancario en Argentina

Obtener información de una cuenta CBU de destino

{% tabs %}
{% tab title="Node" %}

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

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

{% endtab %}
{% endtabs %}

Notificar un retiro bancario

{% hint style="warning" %}
Si necesita realizar la operación sobre la cuenta de su cliente, debe incluir los parámetros `user_id` retornado en el registro y el valor del parámetro  `account_id`  debe ser la cuenta de su cliente. En caso contrario, solo su `account_id` y la operación se hará sobre el usuario autenticado.
{% endhint %}

{% tabs %}
{% tab title="Node" %}

```js
// ...
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
```

{% endtab %}
{% endtabs %}

{% hint style="info" %}
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.
{% endhint %}

Confirmar un retiro bancario

{% hint style="warning" %}
Si necesita realizar la operación sobre la cuenta de su cliente, debe incluir los parámetros `user_id` retornado en el registro y el valor del parámetro  `account_id`  debe ser la cuenta de su cliente. En caso contrario, solo su `account_id` y la operación se hará sobre el usuario autenticado.
{% endhint %}

{% tabs %}
{% tab title="Node" %}

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

{% endtab %}
{% endtabs %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://www.notbank.com/learn/tutorial/crypto-as-a-service-con-reliance.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.