> 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 the need to build the complexity of the layer from scratch *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 modalities of its service **Crypto as a Service (CaaS)** designed for different customer 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 those institutions that already have a consolidated compliance framework and a verifiable reputation, which allows for a high-trust relationship to be established between the parties. Thanks to this additional level of trust —supported by shared liability agreements and mutual validation— the onboarding process is significantly streamlined, reducing times and operational friction without compromising the required regulatory standards.

To begin using Crypto as a Service (CaaS) with reliance, the interested party must formalize their request by signing a service agreement. This contract clearly establishes the terms of use, responsibilities, and commercial agreements. To start this process, it is necessary 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 must be completed. 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 identity for the client application. 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 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';

// creation of REST HTTP client
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 option **Crypto as a Service (CaaS)** is the right one. This powerful integration will allow you to incorporate and manage your own customers 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 an obligated 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                  | Doctor                   |
| dressmaker                 | Dressmaker               |
| dustman                    | Garbage collector        |
| economist                  | Economist                |
| electrician                | Electrician              |
| engineer                   | Engineer                 |
| farmer                     | Farmer                   |
| fireman                    | Firefighter              |
| fisherman                  | Fisherman                |
| florist                    | Florist                  |
| fruiterer                  | Greengrocer              |
| gardener                   | Gardener                 |
| geologist                  | Geologist                |
| hairdresser                | Hairdresser              |
| jeweller                   | Jeweler                  |
| journalist                 | Journalist               |
| judge                      | Judge                    |
| lawyer                     | Lawyer                   |
| librarian                  | Librarian                |
| life\_guard                | Lifeguard                |
| mailman\_postman           | Mailman/Postman          |
| 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         | Teacher/Professor        |
| programmer                 | Programmer               |
| psychiatrist               | Psychiatrist             |
| psychologist               | Psychologist             |
| receptionist               | Receptionist             |
| researcher\_scientist      | Scientific researcher    |
| 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            | ID                                          |
| 2            | Foreigner                                   |
| 3            | NUIP: Unique Personal Identification Number |
| 4            | NIP: Personal Identification Number         |
| 5            | PEP: Special Stay Permit                    |
| 6            | CC: Citizenship ID 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                    |
| 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                      |
| Antarctica                  | Antarctica                  |
| Cape Horn (Former Navarino) | Cape Horn (Former 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 an obligated 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 so your money works and generates returns. In addition, you can create **multiple subaccounts**, which allows 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             | Sub account. Multiple.   |
| {% endtab %}  |                          |
| {% endtabs %} |                          |

## 4. Receive and send cryptocurrencies

Notbank's cryptocurrency wallets **Notbank** offer a secure and accessible gateway to the dynamic world of digital assets. Designed to serve both beginners and experienced investors, they stand out for their broad compatibility, which covers a large **variety of leading coins and networks** in the market, allowing users to manage their portfolio in a single and convenient place. A key point of Notbank is its commitment to user profitability, offering **affordable fees** that optimize each transaction. In addition, security is the top priority; backed by Notbank, 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 Get 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 Get 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 the whitelist

To ensure the highest security for your assets, in Notbank it is necessary to pre-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 when requesting 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 when requesting 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 when requesting 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 affordable 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) that we would receive if we used 100,000 Brazilian reais (BRL). Then we will consult the promised 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 the 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 in fiat currency

In this example, we are going to request the amount of Brazilian reais (BRL) that we would receive if we used 0.0013 Tether (USDT). Then we will consult the promised 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 the 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 options 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 reverse 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. In 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 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) 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
// reverse 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 fund management easier, Notbank offers its users a wide variety of payment methods designed to suit their needs. Customers can load fiat currency balance into their accounts quickly and securely, selecting from traditional options such as bank transfers, using credit cards, or integrating 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 Add bank account

#### 7.1.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.1.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) | checking                | Checking account            |
| Argentina (AR), Chile (CL)                           | sight                   | 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        |
| Phone         | Phone number |
| Other         | Other        |
| {% endtab %}  |              |
| {% endtabs %} |              |

### 7.2 Notify a deposit

At Notbank, we have optimized the process of receiving funds 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, and we also exclusively integrate the **Webpay** for Chile or PIX for Brazil, which allows immediate and efficient validation for users in that region. 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.2.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 (PE).
});
</code></pre>

{% endtab %}
{% endtabs %}

### 7.3 Notify a withdrawal

Notbank guarantees a global financial experience by offering fiat currency withdrawal service in all the countries where the platform has a presence, 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 for the user to confirm the withdrawal notification within the app to complete the transaction successfully.

#### 7.3.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.3.2 Bank withdrawal notification in Argentina

Get information for 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 you a confirmation code to your email 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.