> 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/en/crypto-as-a-service-with-reliance.md).

# Crypto as a Service with reliance

NotBank offers a Crypto as a Service (CaaS) service that provides a robust, documented technical infrastructure (API) so that third parties (fintechs, banks, or wallets) can quickly integrate full cryptocurrency and digital asset functionality under their own brand. This solution allows institutions to offer their customers services such as secure custody, wallet management, instant fiat-to-crypto conversion, and send/receive operations, without needing to build from scratch the complexity of the *blockchain*, the *backend*, security or regulatory compliance. In essence, NotBank handles the technical side, the risks and the infrastructure, acting as a bridge between the traditional financial world and the crypto ecosystem, which allows its clients to focus solely on the user experience and their business strategy.

Notbank offers two service modalities **Crypto as a Service (CaaS)** designed for different client profiles and operational needs. The **standard CaaS** provides a robust regulatory compliance solution that accompanies each client through a structured and thorough onboarding process. The **CaaS with reliance**, on the other hand, is aimed at institutions that already have a consolidated compliance framework and verifiable reputation, which makes it possible to establish a high-trust relationship between the parties. Thanks to this additional level of trust —supported by shared responsibility agreements and mutual validation— the onboarding process is considerably streamlined, reducing times and operational friction without compromising the required regulatory standards.

To start using Crypto as a Service (CaaS) with reliance, the interested party must formalize their request by signing a service agreement. This contract clearly sets out the terms of use, responsibilities, and commercial agreements. To start this process, you need to contact our support team by clicking on the [link](https://support.notbank.com/support/s/contactsupport?language=es) provided. This link will take you to a specific contact form that you must complete. Once we receive your request through the form, our team will promptly send you the contract for your review and subsequent signature.

## 1. Authentication in Notbank

Authentication to access the Notbank API is performed securely by combining the confidential API credentials with a specific user identifier. These credentials, obtained in the previous step, act as proof of the client application's identity. By including the user identifier along with these credentials in the request, the API can verify the identity of the caller and, crucially, authorize operations at the level of the specific user account within the Notbank ecosystem, ensuring that only the relevant data and actions are available.

{% 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` any arbitrary number or random string used with the API private key to generate a signature.

`Signature` is a long alphanumeric string generated using the API private key and the nonce. To generate your own signature with a `nonce` different, you must use `HMAC-SHA256` to encode your `Nonce`, `UserId` (user ID) and the API public key (`<public-key>`), in the format `NonceUserIdAPIPublicKey` using the API secret key (`<secret-key>`) as the key.
{% endtab %}

{% tab title="Node" %}

```js
import { NotbankClient } from 'notbank';

// REST HTTP client creation
const restClient = NotbankClient.Factory.createRestClient();

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

{% endtab %}
{% endtabs %}

## 2. Register a client in Notbank

If you want **to expand your own business** and offer cryptocurrency services to your users, our registration through the **Crypto as a Service (CaaS)** option is the right one. This powerful integration will allow you to onboard and manage your own clients within the Notbank ecosystem, acting as a bridge between your users and all the functionality of our platform.

### 2.1 Basic-level registration

{% 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": "Street 1",
  "address_postal_code": "123456",
  // only Argentina (address_country=AR)
  "address_province": "1",
  "subject_comply": false,  // is a regulated entity
  // only Brazil (address_country=BR)
  "address_district": "District 1",
  "address_number": "1234",
  "address_state": "SP",
  "address_complement": "Block 3" // optional
  // only Chile (address_country=CL)
  "address_comune": "Arica",
  // only Peru (address_country=PE)
  "civil_status": "married",
  "spouse_name": "María Soto",
  "pep": true,
  // only Peru and PEP (pep=true)  
  "pep_position": "Mayor",
  "pep_institution": "Municipality of Santiago",
  "pep_links_description": "Rodrigo Pérez (Father)",
  "is_pep_family_member": true,
  // only Peru and if family member is PEP (is_pep_family_member=true)
  "pep_family_member_name": "Luis Pérez",
  "pep_family_member_relation": "Grandfather"
}

---

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

{% endtab %}
{% endtabs %}

#### 2.1.1 Glossary

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

| Value                      | Description              |
| -------------------------- | ------------------------ |
| trader                     | Merchant                 |
| investor                   | Investor                 |
| student                    | Student                  |
| housewife                  | Housewife                |
| accountant                 | Accountant               |
| actor\_actress             | Actor/Actress            |
| air\_hostess               | Flight attendant         |
| archaeologist              | Archaeologist            |
| architect                  | Architect                |
| astronaut                  | Astronaut                |
| baker                      | Baker                    |
| biologist                  | Biologist                |
| bricklayer                 | Bricklayer               |
| driver                     | Driver                   |
| businessman                | Businessman              |
| butcher                    | Butcher                  |
| caretaker\_janitor\_porter | Caretaker/Janitor/Porter |
| carpenter                  | Carpenter                |
| cashier                    | Cashier                  |
| cleaner                    | Cleaner                  |
| clown                      | Clown                    |
| cobbler                    | Cobbler                  |
| cook\_chef                 | Cook/Chef                |
| chemist                    | Chemist                  |
| dancer                     | Dancer                   |
| decorator                  | Decorator                |
| dentist                    | Dentist                  |
| designer                   | Designer                 |
| physician                  | Physician                |
| dressmaker                 | Dressmaker               |
| dustman                    | Garbage collector        |
| economist                  | Economist                |
| electrician                | Electrician              |
| engineer                   | Engineer                 |
| farmer                     | Farmer                   |
| fireman                    | Firefighter              |
| fisherman                  | Fisherman                |
| florist                    | Florist                  |
| fruiterer                  | Fruit seller             |
| gardener                   | Gardener                 |
| geologist                  | Geologist                |
| hairdresser                | Hairdresser              |
| jeweller                   | Jeweler                  |
| journalist                 | Journalist               |
| judge                      | Judge                    |
| lawyer                     | Lawyer                   |
| librarian                  | Librarian                |
| life\_guard                | Lifeguard                |
| mailman\_postman           | Mail carrier             |
| mechanic                   | Mechanic                 |
| meteorologist              | Meteorologist            |
| cryptocurrency\_miner      | Cryptocurrency miner     |
| mineral\_miner             | Miner                    |
| model                      | Model                    |
| nanny\_nursemaid           | Nanny                    |
| nun                        | Nun                      |
| nurse                      | Nurse                    |
| painter                    | Painter                  |
| pastry\_cook               | Pastry chef              |
| pharmacist                 | Pharmacist               |
| photographer               | Photographer             |
| physicist                  | Physicist                |
| plumber                    | Plumber                  |
| policeman\_policewoman     | Police officer           |
| politician                 | Politician               |
| priest                     | Priest                   |
| professor\_teacher         | Professor/Teacher        |
| programmer                 | Programmer               |
| psychiatrist               | Psychiatrist             |
| psychologist               | Psychologist             |
| receptionist               | Receptionist             |
| researcher\_scientist      | Researcher/Scientist     |
| sailor                     | Sailor                   |
| salesman                   | Salesperson              |
| secretary                  | Secretary                |
| shop\_assistant            | Shop assistant           |
| singer                     | Singer                   |
| social\_worker             | Social worker            |
| sportsman                  | Athlete                  |
| surgeon                    | Surgeon                  |
| taxi\_driver               | Taxi driver              |
| telephone\_operator        | Telephone operator       |
| travel\_agent              | Travel agent             |
| veterinarian               | Veterinarian             |
| waiter\_waitress           | Waiter/Waitress          |
| writer                     | Writer                   |
| deliveryman                | Delivery person          |
| uber\_driver               | Uber driver              |
| pilot                      | Pilot                    |
| administrative             | Administrative           |
| public\_servant            | Public servant           |
| other                      | Other                    |
| customer\_care             | Customer service         |
| military                   | Military                 |
| manager\_officier          | Manager/Officer          |
| {% endtab %}               |                          |

{% tab title="Gender" %}

| Value        | Description |
| ------------ | ----------- |
| 0            | Female      |
| 1            | Male        |
| {% endtab %} |             |

{% tab title="Identity Type" %}

| Value        | Description                                 |
| ------------ | ------------------------------------------- |
| 1            | National ID                                 |
| 2            | Foreigner                                   |
| 3            | NUIP: Unique personal identification number |
| 4            | NIP: Personal identification number         |
| 5            | PEP: Special Stay Permit                    |
| 6            | CC: Citizenship card                        |
| 7            | CE: Foreigner ID card                       |
| 8            | Passport                                    |
| {% endtab %} |                                             |

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

| Value        | Description                                             |
| ------------ | ------------------------------------------------------- |
| 1            | Buenos Aires                                            |
| 10           | Catamarca                                               |
| 14           | Chaco                                                   |
| 20           | Chubut                                                  |
| 43           | Autonomous City of 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, Antarctica and South Atlantic Islands |
| 17           | Tucumán                                                 |
| {% endtab %} |                                                         |

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

| Value        | Description         |
| ------------ | ------------------- |
| 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           | Federal District    |
| {% endtab %} |                     |

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

| Value                      | Description                |
| -------------------------- | -------------------------- |
| 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                   |
| Easter Island              | Easter Island              |
| 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                   |
| Central Station            | Central Station            |
| 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                     |
| Antarctica                 | Antarctica                 |
| Cape Horn (Ex Navarino)    | Cape Horn (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="Marital status (PE)" %}

| Value         | Description |
| ------------- | ----------- |
| single        | Single      |
| married       | Married     |
| cohabiting    | Cohabiting  |
| divorced      | Divorced    |
| widowed       | Widowed     |
| {% endtab %}  |             |
| {% endtabs %} |             |

### 2.2. Advanced level registration

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

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

{
  // include all the parameters from the basic registration plus the following parameters:
  "pep": false,  // is a politically exposed person
  "is_public_servant": true,  // is a public servant
  "subject_comply": false,  // is a regulated entity
}

---

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

{% endtab %}
{% endtabs %}

## 3. Get accounts

**Notbank** offers you different types of accounts: the **primary account**, designed for your day-to-day operations, the **yield account**, designed for your money to work and generate returns. In addition, you can create **multiple subaccounts**, allowing you to keep your balances perfectly organized — separating, for example, your operating funds from your savings.

{% hint style="warning" %}
If you need to perform the operation on your client's account, you must include the parameters `user_id` returned in the registration and the value of the parameter  `account_id`  must be your client's account. Otherwise, only your `account_id` and the operation will be performed on the authenticated user.
{% 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 Glossary

{% tabs %}
{% tab title="Account type" %}

| Value         | Description              |
| ------------- | ------------------------ |
| 1             | Primary account. Single. |
| 3             | Yield account. Single.   |
| 5             | Subaccount. Multiple.    |
| {% endtab %}  |                          |
| {% endtabs %} |                          |

## 4. Receive and send cryptocurrencies

The cryptocurrency wallets of **Notbank** offer a secure and accessible gateway to the dynamic world of digital assets. Designed to satisfy both novices and experienced investors, they stand out for their broad compatibility, covering a wide **variety of leading coins and networks** in the market, allowing users to manage their portfolio in one convenient place. A key point of Notbank is its commitment to user profitability, offering **economical fees** that optimize each transaction. In addition, security is the top priority; with Notbank's backing, these wallets incorporate state-of-the-art protection protocols and advanced security measures to ensure that users' funds and privacy are safeguarded at all times.

### 4.1. Create a wallet to receive cryptocurrencies

#### 4.1.1 Obtain the available networks

Given the large number of coins and networks supported by Notbank, it is first necessary to obtain the available networks for a cryptocurrency.

{% 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 Obtain a wallet

Using the network code ( `network` ) obtained in the previous step plus the currency code (`currency`) you can request your wallet address.&#x20;

{% hint style="warning" %}
If you need to perform the operation on your client's account, you must include the parameters `user_id` returned in the registration and the value of the parameter  `account_id`  must be your client's account. Otherwise, only your `account_id` and the operation will be performed on the authenticated user.
{% 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 Add address to whitelist

To ensure the maximum security of your assets, in Notbank it is necessary to register destination addresses in a whitelist before making any cryptocurrency transfer. This additional protection measure helps prevent unauthorized withdrawals and ensures that your funds are sent only to trusted wallets verified by you.

#### 4.2.1 Add an address

{% hint style="warning" %}
If you need to perform the operation on your client's account, you must include the parameters `user_id` returned in the registration and the value of the parameter  `account_id`  must be your client's account. Otherwise, only your `account_id` and the operation will be performed on the authenticated user.
{% 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" %}
The value of the parameter `otp` corresponds to the two-step authentication code provided by your external application at the time you request your transfer.
{% endhint %}

{% hint style="info" %}
Notbank will send you a **confirmation code** to your phone number, which you will need to use to confirm the new address you are adding to the whitelist.
{% endhint %}

#### 4.2.2 Confirm an address

{% hint style="warning" %}
If you need to perform the operation on your client's account, you must include the parameters `user_id` returned in the registration and the value of the parameter  `account_id`  must be your client's account. Otherwise, only your `account_id` and the operation will be performed on the authenticated user.
{% 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. Send your cryptocurrencies to another wallet

{% hint style="warning" %}
If you need to perform the operation on your client's account, you must include the parameters `user_id` returned in the registration and the value of the parameter  `account_id`  must be your client's account. Otherwise, only your `account_id` and the operation will be performed on the authenticated user.
{% 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" %}
The value of the parameter `otp` corresponds to the two-step authentication code provided by your external application at the time you request your transfer.
{% endhint %}

## 5. Transfer funds

### 5.1 Transfer funds using account identifiers

In this example, we are going to request a transfer of `1000` `USDT` from your account `accountId` to your client's account `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": "Test note",  // optional
  "otp": "123456"
}

----

{
  "status": "success",
  "data": 12345 // transfer identifier
}
```

{% 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": "Test note",
  "otp": "123456"
});

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

{% endtab %}
{% endtabs %}

{% hint style="info" %}
The value of the parameter `otp` corresponds to the two-step authentication code provided by your external application at the time you request your transfer.
{% endhint %}

## 6. Buy, sell, and convert cryptocurrencies

Discover **Simple**, the functionality designed to make buying, selling, and converting cryptocurrencies a simple, fast, and secure experience for everyone. Forget about complex interfaces and order types; with Simple, you can execute your transactions intuitively in just a few steps. This tool is perfect both for those who are just starting in the crypto world and for advanced users looking for speed. In addition to its ease of use, Simple stands out for offering an economical transaction fee, allowing you to optimize your operations and making your entry into the crypto market not only efficient, but also accessible.

### 6.1 Buy cryptocurrencies with fiat currency

In this example, we are going to request the amount of Tether (USDT) we would receive if we used 100,000 Brazilian reais (BRL). Then we will check the quoted amount, which is valid for 20 seconds, and finally, we will execute the purchase.

{% hint style="info" %}
The amounts included in the examples are for educational purposes and do not represent the current market state.
{% endhint %}

#### 6.1.1 Request a quote

{% hint style="warning" %}
If you need to perform the operation on your client's account, you must include the parameters `user_id` returned in the registration and the value of the parameter  `account_id`  must be your client's account. Otherwise, only your `account_id` and the operation will be performed on the authenticated user.
{% 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 Check quote

{% hint style="warning" %}
If you need to perform the operation on your client's account, you must include the parameters `user_id` returned in the registration and the value of the parameter  `account_id`  must be your client's account. Otherwise, only your `account_id` and the operation will be performed on the authenticated user.
{% 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 // pending
console.log(quote.amount_out)
// 0.0013 // USDT
```

{% endtab %}
{% endtabs %}

#### 6.1.3 Execute quote

{% hint style="warning" %}
If you need to perform the operation on your client's account, you must include the parameters `user_id` returned in the registration and the value of the parameter  `account_id`  must be your client's account. Otherwise, only your `account_id` and the operation will be performed on the authenticated user.
{% 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 // pending
console.log(quote.amount_out)
// 0.0013 // USDT

// After a few moments, check the request status again
const quote = await restClient.getQuoteService().getQuote({
  quote_id: "c1c56ca3-75c3-4bb6-97e3-702448382cd3",
  user_id: clientUserId
  account_id: clientAccountId,
});

console.log(quote.status)
// 1 // executed
console.log(quote.amount_out)
// 0.0013 // USDT
```

{% endtab %}
{% endtabs %}

### 6.2 Sell cryptocurrencies for fiat currency

In this example, we are going to request the amount of Brazilian reais (BRL) we would receive if we used 0.0013 Tether (USDT). Then we will check the quoted amount, which is valid for 20 seconds, and finally, we will execute the purchase.

{% hint style="info" %}
The amounts included in the examples are for educational purposes and do not represent the current market state.
{% endhint %}

#### 6.2.1 Request a quote

{% hint style="warning" %}
If you need to perform the operation on your client's account, you must include the parameters `user_id` returned in the registration and the value of the parameter  `account_id`  must be your client's account. Otherwise, only your `account_id` and the operation will be performed on the authenticated user.
{% 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 Check quote

{% hint style="warning" %}
If you need to perform the operation on your client's account, you must include the parameters `user_id` returned in the registration and the value of the parameter  `account_id`  must be your client's account. Otherwise, only your `account_id` and the operation will be performed on the authenticated user.
{% 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 // pending
console.log(quote.amount_out)
// 100000 // BRL
```

{% endtab %}
{% endtabs %}

#### 6.2.3 Execute quote

{% hint style="warning" %}
If you need to perform the operation on your client's account, you must include the parameters `user_id` returned in the registration and the value of the parameter  `account_id`  must be your client's account. Otherwise, only your `account_id` and the operation will be performed on the authenticated user.
{% 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 // pending
console.log(quote.amount_out)
// 100000 // BRL

// After a few moments, check the request status again
const quote = await restClient.getQuoteService().getQuote({
  quote_id: "1b09948d-2169-4f93-84ec-a55fb1741663",
  user_id: clientUserId
  account_id: clientAccountId,
});

console.log(quote.status)
// 1 // executed
console.log(quote.amount_out)
// 100000 // BRL
```

{% endtab %}
{% endtabs %}

### 6.3 Convert cryptocurrencies

**Notbank offers you two quote modes for converting currencies.** With the direct quote, simply enter the amount you want to convert and select the source currency and the destination currency; the system will immediately show you how much money you will receive in the final currency. The inverse quote works the other way around: you indicate the amount you need to receive in the destination currency and specify the source currency, and the system automatically calculates how much money you need in the original currency to obtain exactly that amount. This way, you can choose the option that best fits your need: calculate the result of a conversion or determine how much you need to have in the starting currency.

{% hint style="success" %}
Conversion is not limited to transactions between cryptocurrencies, but rather to any possible combination: cryptocurrency to cryptocurrency, fiat currency to cryptocurrency, cryptocurrency to fiat currency, and fiat currency to fiat currency.
{% endhint %}

{% hint style="info" %}
The amounts included in the examples are for educational purposes and do not represent the current market state.
{% endhint %}

#### 6.3.1 Request quote

{% hint style="warning" %}
If you need to perform the operation on your client's account, you must include the parameters `user_id` returned in the registration and the value of the parameter  `account_id`  must be your client's account. Otherwise, only your `account_id` and the operation will be performed on the authenticated user.
{% endhint %}

In this example, we are going to request the amount of Tether (USDT) we would receive if we used 1 Bitcoin (BTC). Then we will consult the promised amount, which is valid for 20 seconds, and finally, we will execute the purchase.

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

```js
// direct quote
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 %}

In this example, we are going to request the amount of Bitcoin (BTC) that we would need if we wanted 100 Tether (USDT). Then we will consult the promised amount, which is valid for 20 seconds, and finally, we will execute the purchase.

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

```js
// inverse quote
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 Check quote

{% hint style="warning" %}
If you need to perform the operation on your client's account, you must include the parameters `user_id` returned in the registration and the value of the parameter  `account_id`  must be your client's account. Otherwise, only your `account_id` and the operation will be performed on the authenticated user.
{% 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 // pending
console.log(quote.amount_out)
// 30 // USDT
```

{% endtab %}
{% endtabs %}

#### 6.3.3 Execute quote

{% hint style="warning" %}
If you need to perform the operation on your client's account, you must include the parameters `user_id` returned in the registration and the value of the parameter  `account_id`  must be your client's account. Otherwise, only your `account_id` and the operation will be performed on the authenticated user.
{% 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 // pending
console.log(quote.amount_out)
// 30 // USDT

// After a few moments, check the request status again
const quote = await restClient.getQuoteService().getQuote({
  quote_id: "fc4ffe0e-b87a-4e1f-a727-f6ddae7dc1e0",
  user_id: clientUserId
  account_id: clientAccountId,
});

console.log(quote.status)
// 1 // executed
console.log(quote.amount_out)
// 30 // USDT
```

{% endtab %}
{% endtabs %}

## 7. Deposit and withdraw fiat

To make managing your funds easier, Notbank offers its users a wide variety of payment methods designed to adapt to their needs. Clients can top up fiat currency balances in their accounts quickly and securely, choosing between traditional options such as bank transfers, the use of credit cards, or integration with modern payment gateways. This flexibility ensures that each user can manage their capital with total convenience and under the highest financial security standards.

### 7.1 Get deposit bank accounts

Notbank offers a service to obtain Notbank bank accounts for `general`, to which clients must deposit in order to assign balance to their local currency wallets.

{% hint style="info" %}
**IMPORTANT**: Use bank accounts that are associated with the same verified identity in Notbank for correct balance allocation.
{% endhint %}

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

```bash
GET /api/nb/bank-deposits?user_id=clientUserId HTTP/1.1
Host: https://api.notbank.com
Content-Type: application/json
aptoken: <ap-token>

---

{
  "status": "success",
  "data": [
    {
      "id": "41d63634-2f2a-47b8-8dd5-55b81fe87243",
      "currency": "CLP",
      "bank": "BCI (BCO DE CREDITO E INV)",
      "identity_number": "76.590.133-2",
      "identity_type": "RUT",
      "company_name": "CryptoMKT SpA",
      "account_type": "Checking account",
      "account_number": "32782381",
      "agency": null,
      "email": "transferencias@cryptomkt.com",
      "created_at": "2026-07-31T15:57:08",
      "updated_at": "2026-07-31T15:57:08"
    },
    {
      "id": "5885ce0e-474e-4e7d-b499-28cca702c58d",
      "currency": "ARS",
      "bank": "BANCO COINAG S.A.",
      "identity_number": "30715538063",
      "identity_type": "CUIT",
      "company_name": "Cryptomkt S.A.",
      "account_type": "Virtual account",
      "account_number": "0000053600000000890630",
      "agency": null,
      "email": "transferencias@cryptomkt.com",
      "created_at": "2026-07-31T16:16:08",
      "updated_at": "2026-07-31T16:16:08"
    },
    {
      "id": "8f8877b6-2495-4ee9-81bd-100dd9089235",
      "currency": "BRL",
      "bank": "BANCO GENIAL S.A. (ex BRASIL PLURAL S.A.)",
      "identity_number": "28183128000157",
      "identity_type": "CNPJ",
      "company_name": "CRYPTOMKT SERVICOS DIGITAIS LTDA",
      "account_type": "Legal entity",
      "account_number": "4351-6",
      "agency": "0001",
      "email": "transferencias@cryptomkt.com",
      "created_at": "2026-07-31T16:18:46",
      "updated_at": "2026-07-31T16:18:46"
    },
    {
      "id": "fe85a901-0351-4f5b-8f7f-ea8439c02dfe",
      "currency": "PEN",
      "bank": "DALE",
      "identity_number": "20606503858",
      "identity_type": "RUC",
      "company_name": "CryptoMKT Peru SAC",
      "account_type": "Electronic money account",
      "account_number": "92200200000336442611",
      "agency": null,
      "email": "transferencias@cryptomkt.com",
      "created_at": "2026-07-31T16:43:53",
      "updated_at": "2026-07-31T16:43:53"
    }
  ]
}
```

{% endtab %}
{% endtabs %}

#### 7.1.1 Get virtual or FBO deposit bank accounts

{% hint style="warning" %}
**IMPORTANT**: We will soon offer support for virtual and FBO accounts. **This service is still under development**.&#x20;
{% endhint %}

The **virtual** and **fbo**, accounts are the client's bank accounts but managed by Notbank. These accounts will have a **unique account number** for each client, which can be used to deposit and withdraw local currency balances.

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

```bash
GET /api/nb/bank-deposits?user_id=clientUserId HTTP/1.1
Host: https://api.notbank.com
Content-Type: application/json
aptoken: <ap-token>

---

{
  "status": "success",
  "data": [
    {
      "id": "41d63634-2f2a-47b8-8dd5-55b81fe87243",
      "type": "general",  // new
      "currency": "CLP",
      "bank": "BCI (BCO DE CREDITO E INV)",
      "identity_number": "76.590.133-2",
      "identity_type": "RUT",
      "company_name": "CryptoMKT SpA",
      "account_type": "Checking account",
      "account_number": "32782381",
      "agency": null,
      "email": "transferencias@cryptomkt.com",
      "created_at": "2026-07-31T15:57:08",
      "updated_at": "2026-07-31T15:57:08"
    },
    {
      "id": "41d63634-2f2a-47b8-8dd5-55b81fe87243",
      "type": "virtual",  // new
      "currency": "COP",
      "account_type": "virtual",  // new
      "account_number": "12345678901234567890",
      "account_alias": null,  // new
      "created_at": "2026-07-31T15:57:08",
      "updated_at": "2026-07-31T15:57:08"
    },
    {
      "id": "41d63634-2f2a-47b8-8dd5-55b81fe87243",
      "type": "fbo",  // new
      "currency": "ARS",
      "account_type": "cvu",  // new
      "account_number": "12345678901234567890",
      "account_alias": null,  // new
      "created_at": "2026-07-31T15:57:08",
      "updated_at": "2026-07-31T15:57:08"
    },
    {
      "id": "41d63634-2f2a-47b8-8dd5-55b81fe87243",
      "type": "fbo",  // new
      "currency": "USD",
      "account_type": "swift",  // new
      "account_number": "40000010851",
      "account_alias": null,  // new
      "created_at": "2026-07-31T15:57:08",
      "updated_at": "2026-07-31T15:57:08",
      "beneficiary": {  // new
        "name": "beneficiary-name",
        "address": "beneficiary-address",
        "account_number": "40000010851",
        "bank": {
          "name": "bank-name",
          "swift": "XXXXXXXXXXX",
          "routing_number": "123456789"
        }
      },
      "intermediary_bank": {  // new
        "name": "bank-name",
        "routing_number": "123456789",
        "bic_code": "XXXXXXXXXXX"
      }
    }
  ]
}
```

{% endtab %}
{% endtabs %}

### 7.2 Create a virtual or FBO deposit bank account

{% hint style="warning" %}
**IMPORTANT**: We will soon offer support for virtual and FBO accounts. **This service is still under development**.&#x20;
{% endhint %}

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

```bash
POST /api/nb/bank-deposits HTTP/1.1
Host: hostname goes here...
aptoken: 2c262ce0-aebf-4dcb-8a70-cd60506a9ac8
Content-Type: multipart/form-data

{
  "type": "fbo",
  "currency": "ARS",
  "user_id": clientUserId
}


---

{
  "status": "success",
  "message": "Request received successfully."
}
```

{% endtab %}
{% endtabs %}

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

```bash
POST /api/nb/bank-deposits HTTP/1.1
Host: hostname goes here...
aptoken: 2c262ce0-aebf-4dcb-8a70-cd60506a9ac8
Content-Type: multipart/form-data

{
  "type": "virtual",
  "currency": "COP",
  "account_number": "1234567890123",
  "user_id": clientUserId
}

---

{
  "status": "success",
  "message": "Request received successfully."
}
```

{% endtab %}
{% endtabs %}

### 7.3 Edit the alias of an FBO deposit bank account

{% hint style="warning" %}
**IMPORTANT**: We will soon offer support for virtual and FBO accounts. **This service is still under development**.&#x20;
{% endhint %}

{% hint style="info" %}
**IMPORTANT**: Method only available for accounts **fbo** with currency **ARS**.
{% endhint %}

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

```bash
PATCH /api/nb/bank-deposits/02e82e3f-f200-41e9-a31b-81eaedc9cdc5 HTTP/1.1
Host: hostname goes here...
aptoken: 2c262ce0-aebf-4dcb-8a70-cd60506a9ac8
Content-Type: application/json

{
    "account_alias": "new-alias",
    "user_id": clientUserId
}

---

{
  "status": "success",
  "data": {
    "id": "02e82e3f-f200-41e9-a31b-81eaedc9cdc5",
    "type": "fbo",
    "account_number": "1231237817239817239",
    "account_alias": "new-alias",
    "account_type": "cvu",
    "currency": "ARS",
    "created_at": "2026-07-31T16:43:53",
    "updated_at": "2026-07-31T16:43:53"
  }
}
```

{% endtab %}
{% endtabs %}

### 7.4 Add bank account

#### 7.4.1 Get list of supported banks

{% hint style="warning" %}
If you need to perform the operation on your client's account, you must include the parameters `user_id` returned in the registration and the value of the parameter  `account_id`  must be your client's account. Otherwise, only your `account_id` and the operation will be performed on the authenticated user.
{% 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.4.2 Add bank account

{% hint style="warning" %}
If you need to perform the operation on your client's account, you must include the parameters `user_id` returned in the registration and the value of the parameter  `account_id`  must be your client's account. Otherwise, only your `account_id` and the operation will be performed on the authenticated user.
{% 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",  // Brazil only (BR)
  // agency: "",  // Brazil only (BR) if kind != br_pix
  // dv: "", // Brazil only (BR) if kind != br_pix
  // province?: string; Peru only (PE)
});

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

{% endtab %}
{% endtabs %}

#### Glossary

{% tabs %}
{% tab title="Bank account type" %}

| Country                                              | Value                   | Description                 |
| ---------------------------------------------------- | ----------------------- | --------------------------- |
| Argentina (AR), Chile (CL), Peru (PE), Colombia (CO) | current                 | Checking account            |
| Argentina (AR), Chile (CL)                           | view                    | Sight account               |
| Argentina (AR), Chile (CL), Peru (PE), Colombia (CO) | savings                 | Savings account             |
| Argentina (AR), Chile (CL)                           | electronic\_checkbook   | Electronic checkbook        |
| Argentina (AR)                                       | ar\_cbu                 | CBU account                 |
| Argentina (AR)                                       | ar\_cvu                 | CVU account                 |
| Argentina (AR)                                       | ar\_alias               | Alias                       |
| Brazil (BR)                                          | br\_corriente\_fisica   | Individual checking account |
| Brazil (BR)                                          | br\_simple\_fisica      | Individual simple account   |
| Brazil (BR)                                          | br\_corriente\_juridica | Corporate checking account  |
| Brazil (BR)                                          | br\_poupanca\_fisica    | Individual savings account  |
| Brazil (BR)                                          | br\_poupanca\_juridica  | Individual savings account  |
| Brazil (BR)                                          | br\_caixa\_facil        | Caixa Fácil account         |
| Brazil (BR)                                          | br\_pix                 | PIX account                 |
| {% endtab %}                                         |                         |                             |

{% tab title="PIX account type" %}

| Value         | Description   |
| ------------- | ------------- |
| CPF           | CPF number    |
| CNPJ          | CNPJ number   |
| EMAIL         | Email address |
| Phone         | Phone number  |
| Other         | Other         |
| {% endtab %}  |               |
| {% endtabs %} |               |

### 7.5 Notify a deposit

At Notbank, we have optimized the fund receipt process to offer you an agile and secure experience in managing your assets. Currently, we support deposit notifications in fiat currency through **bank transfers** traditional for all the countries where we operate, additionally integrating exclusively the **Webpay** method for Chile or PIX for Brazil, which allows immediate and efficient validation for users in those regions. We are continuously working to expand our operational capabilities, so we will soon add new payment methods to our API, providing greater flexibility and reach to our global financial solutions.

#### 7.5.1 Bank notification

{% hint style="warning" %}
If you need to perform the operation on your client's account, you must include the parameters `user_id` returned in the registration and the value of the parameter  `account_id`  must be your client's account. Otherwise, only your `account_id` and the operation will be performed on the authenticated user.
{% 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. Peru only (Peru).
});
</code></pre>

{% endtab %}
{% endtabs %}

### 7.6 Notify a withdrawal

Notbank guarantees a global financial experience by offering fiat currency withdrawal services in all countries where the platform is present, allowing users to convert their digital assets into local money efficiently. However, it is important to note that there is a special case for Argentina: due to specific validation processes in that region, it is essential that the user confirms the withdrawal notification within the app to complete the transaction successfully.

#### 7.6.1 Bank withdrawal notification

{% hint style="warning" %}
If you need to perform the operation on your client's account, you must include the parameters `user_id` returned in the registration and the value of the parameter  `account_id`  must be your client's account. Otherwise, only your `account_id` and the operation will be performed on the authenticated user.
{% 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.6.2 Bank withdrawal notification in Argentina

Get information about a destination CBU account

{% 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 %}

Notify a bank withdrawal

{% hint style="warning" %}
If you need to perform the operation on your client's account, you must include the parameters `user_id` returned in the registration and the value of the parameter  `account_id`  must be your client's account. Otherwise, only your `account_id` and the operation will be performed on the authenticated user.
{% 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" %}
When you notify a bank withdrawal, Notbank will send a confirmation code to your email address that you must then enter in the next step.
{% endhint %}

Confirm a bank withdrawal

{% hint style="warning" %}
If you need to perform the operation on your client's account, you must include the parameters `user_id` returned in the registration and the value of the parameter  `account_id`  must be your client's account. Otherwise, only your `account_id` and the operation will be performed on the authenticated user.
{% 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/en/crypto-as-a-service-with-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.