> 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/pt-br/crypto-as-a-service-padrao.md).

# Crypto as a Service padrão

A NotBank oferece um serviço de "Crypto as a Service" (CaaS) que fornece uma infraestrutura técnica robusta e documentada (API) para que terceiros (fintechs, bancos ou carteiras) possam integrar rapidamente funcionalidades completas de criptomoedas e ativos digitais sob sua própria marca. Essa solução permite às instituições oferecer aos seus clientes serviços como custódia segura, gestão de carteiras, conversão instantânea de fiat para cripto e operações de envio/recebimento, sem a necessidade de desenvolver do zero a complexidade da camada *blockchain*, o *backend*, a segurança ou a conformidade regulatória. Em essência, a NotBank gerencia a parte técnica, os riscos e a infraestrutura, atuando como ponte entre o mundo financeiro tradicional e o ecossistema cripto, o que permite a seus clientes concentrarem-se unicamente na experiência do usuário e em sua estratégia comercial.

A Notbank oferece duas modalidades de seu serviço **Crypto as a Service (CaaS)** projetadas para diferentes perfis de clientes e necessidades operacionais. O **CaaS padrão** fornece uma solução robusta de conformidade regulatória que acompanha cada cliente por meio de um processo de onboarding estruturado e exaustivo. O **CaaS com reliance**, por outro lado, é voltado àquelas instituições que já contam com uma estrutura de conformidade consolidada e uma reputação verificável, o que permite estabelecer um vínculo de confiança elevada entre as partes. Graças a esse nível adicional de confiança — sustentado em acordos de responsabilidade compartilhada e validação mútua — o processo de onboarding é agilizado consideravelmente, reduzindo tempos e fricções operacionais sem comprometer os padrões regulatórios exigidos.

Para poder começar a usar o Crypto as a Service (CaaS), o interessado deve formalizar sua solicitação mediante a assinatura de um contrato de prestação de serviços. Esse contrato estabelece claramente os termos de uso, as responsabilidades e os acordos comerciais. Para iniciar esse processo, é necessário contatar nossa equipe de suporte clicando no [link](https://support.notbank.com/support/s/contactsupport?language=es) fornecido. Esse link o direcionará para um formulário de contato específico que deve preencher. Assim que recebermos sua solicitação por meio do formulário, nossa equipe lhe enviará prontamente o contrato para sua revisão e posterior assinatura.

## 1. Autenticação na Notbank

A autenticação para acessar a API da Notbank é realizada de forma segura combinando as credenciais confidenciais da API com um identificador de usuário específico. Essas credenciais, obtidas na etapa anterior, atuam como prova de identidade da aplicação cliente. Ao incluir o identificador de usuário junto com essas credenciais na solicitação, a API pode verificar a identidade de quem realiza a chamada e, crucialmente, autorizar as operações no nível da conta específica do usuário dentro do ecossistema da Notbank, garantindo que apenas os dados e ações pertinentes estejam disponíveis.

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

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

// criação do cliente REST HTTP
const restClient = NotbankClient.Factory.createRestClient();

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

{% endtab %}

{% 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",
  // ...
}
```

***

`Nonce` qualquer número arbitrário ou cadeia aleatória usada com a chave privada da API para gerar uma assinatura.

`Signature` é uma longa cadeia alfanumérica gerada usando a chave privada da API e o nonce. Para gerar sua própria assinatura com um `nonce` diferente, você deve usar `HMAC-SHA256` para codificar seu `Nonce`, `UserId` (ID de usuário) e a chave pública da API (`<public-key>`), no formato `NonceUserIdAPIPublicKey` usando a chave secreta da API (`<secret-key>`) como chave.
{% endtab %}
{% endtabs %}

## 2. Registrar um cliente na Notbank

Se você deseja **expandir seu próprio negócio** e oferecer serviços de criptomoedas a seus usuários, nosso registro por meio da opção **Crypto as a Service (CaaS)** é o indicado. Essa poderosa integração permitirá incorporar e gerenciar seus próprios clientes dentro do ecossistema da Notbank, atuando como uma ponte entre seus usuários e todas as funcionalidades de nossa plataforma.

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

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

// ..

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

{% endtab %}

{% 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",
  "language": "es" // valor padrão: en
}

---

{
  "status": "success",
  "data": {
    "userId": "<client_user_id>",
    "token": "<client_jwt>"
  }
}
```

{% endtab %}
{% endtabs %}

## 3. Subir de nível na Notbank

A Notbank estrutura o acesso e as funcionalidades da plataforma por meio de um sistema hierárquico de níveis de verificação, projetado para garantir a segurança e oferecer capacidades operacionais progressivas. O nível inicial é o **Observador**, que está restrito apenas à visualização de informações e dados, impedindo qualquer tipo de operação ou transação na plataforma. A partir daí, os níveis **Básico**, **Avançado**, e **Avançado Plus** marcam melhorias subsequentes, aumentando significativamente as opções de operação, os limites transacionais e as funcionalidades habilitadas para o usuário. O sistema culmina com o nível **Institucional**, reservado apenas para entidades e organizações, o qual fornece o conjunto mais amplo e especializado de ferramentas e permissões da plataforma.

### 3.1 Subir para nível básico

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

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

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

{% endtab %}

{% tab title="cURL" %}

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

{
  "is_business": false, 
  "profession": "trader", 
  "gender": 1, // homem
  "country": "CL", 
  "city": "Rosário", 
  "commune": "Santiago", // Apenas para o Chile.
  "street": "Calle 43", 
  "user_id": client_user_id
}

---

{
  "status": "success",
  "data": {
    "metamap_url":"https://cryptomkt.com/api/api/v1/platform/shortly/b9467945-ac32-4905-a88e-5281f50a394b" 
  }
}
```

{% endtab %}
{% endtabs %}

#### 3.1.1 Glossário

{% tabs %}
{% tab title="Gênero" %}

| Valor        | Descrição |
| ------------ | --------- |
| 0            | Mulher    |
| 1            | Homem     |
| {% endtab %} |           |

{% tab title="Profissão" %}

| Valor                      | Descrição                 |
| -------------------------- | ------------------------- |
| trader                     | Comerciante               |
| investor                   | Investidor                |
| student                    | Estudante                 |
| housewife                  | Dona de casa              |
| accountant                 | Contador                  |
| actor\_actress             | Ator/Atriz                |
| air\_hostess               | Aeromoça                  |
| archaeologist              | Arqueólogo                |
| architect                  | Arquiteto                 |
| astronaut                  | Astronauta                |
| baker                      | Padeiro                   |
| biologist                  | Biólogo                   |
| bricklayer                 | Pedreiro                  |
| driver                     | Motorista                 |
| businessman                | Empresário                |
| butcher                    | Açougueiro                |
| caretaker\_janitor\_porter | Zelador/Porteiro          |
| carpenter                  | Carpinteiro               |
| cashier                    | Caixa                     |
| cleaner                    | Faxineiro                 |
| clown                      | Palhaço                   |
| cobbler                    | Sapateiro                 |
| cook\_chef                 | Cozinheiro/Chef           |
| chemist                    | Químico                   |
| dancer                     | Dançarino                 |
| decorator                  | Decorador                 |
| dentist                    | Dentista                  |
| designer                   | Designer                  |
| physician                  | Médico                    |
| dressmaker                 | Costureira                |
| dustman                    | Lixeiro                   |
| economist                  | Economista                |
| electrician                | Eletricista               |
| engineer                   | Engenheiro                |
| farmer                     | Agricultor                |
| fireman                    | Bombeiro                  |
| fisherman                  | Pescador                  |
| florist                    | Florista                  |
| fruiterer                  | Fruteiro                  |
| gardener                   | Jardineiro                |
| geologist                  | Geólogo                   |
| hairdresser                | Cabeleireiro              |
| jeweller                   | Joalheiro                 |
| journalist                 | Jornalista                |
| judge                      | Juiz                      |
| lawyer                     | Advogado                  |
| librarian                  | Bibliotecário             |
| life\_guard                | Salva-vidas               |
| mailman\_postman           | Carteiro                  |
| mechanic                   | Mecânico                  |
| meteorologist              | Meteorologista            |
| cryptocurrency\_miner      | Minerador de criptomoedas |
| mineral\_miner             | Minerador                 |
| model                      | Modelo                    |
| nanny\_nursemaid           | Babá                      |
| nun                        | Freira                    |
| nurse                      | Enfermeira                |
| painter                    | Pintor                    |
| pastry\_cook               | Confeiteiro               |
| pharmacist                 | Farmacêutico              |
| photographer               | Fotógrafo                 |
| physicist                  | Físico                    |
| plumber                    | Encanador                 |
| policeman\_policewoman     | Policial                  |
| politician                 | Político                  |
| priest                     | Padre                     |
| professor\_teacher         | Professor                 |
| programmer                 | Programador               |
| psychiatrist               | Psiquiatra                |
| psychologist               | Psicólogo                 |
| receptionist               | Recepcionista             |
| researcher\_scientist      | Pesquisador científico    |
| sailor                     | Marinheiro                |
| salesman                   | Vendedor                  |
| secretary                  | Secretário                |
| shop\_assistant            | Assistente de loja        |
| singer                     | Cantor                    |
| social\_worker             | Assistente social         |
| sportsman                  | Esportista                |
| surgeon                    | Cirurgião                 |
| taxi\_driver               | Taxista                   |
| telephone\_operator        | Operador de telefonia     |
| travel\_agent              | Agente de viagens         |
| veterinarian               | Veterinário               |
| waiter\_waitress           | Garçom/Garçonete          |
| writer                     | Escritor                  |
| deliveryman                | Entregador                |
| uber\_driver               | Motorista de Uber         |
| pilot                      | Piloto                    |
| administrative             | Administrativo            |
| public\_servant            | Servidor público          |
| other                      | Outro                     |
| customer\_care             | Atendimento ao cliente    |
| militar                    | Militar                   |
| gerente\_oficial           | Gerente/Oficial           |
| {% endtab %}               |                           |

{% tab title="Província (AR)" %}

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

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

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

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

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

### 3.2. Subir para o nível avançado

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

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

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

{% endtab %}

{% tab title="cURL" %}

```bash
POST /api/nb/account/verification/trader HTTP/1.1
Host: https://api.notbank.com
Content-Type: multipart/form-data
aptoken: <token>

{
  "pep": false,
  "subject_comply": false,
  "is_public_servant": false, 
  "document_address_file": documento.png,
  "document_address_type": 35,
  "user_id": client_user_id
}

---

{
  "status": "success"
}
```

{% endtab %}
{% endtabs %}

#### 3.2.1 Glossário

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

| Valor         | Descrição                                      |
| ------------- | ---------------------------------------------- |
| 3             | Conta de serviço                               |
| 30            | Endereço comprovado                            |
| 35            | Fatura de cartão de crédito                    |
| 36            | Contracheques                                  |
| 37            | Declaração de vizinhos                         |
| 38            | Comprovante de residência notarial             |
| 39            | Fatura de produto com comprovante de pagamento |
| 41            | Certidão de nascimento                         |
| 40            | Certidão de casamento                          |
| 42            | Carteira de motorista com endereço             |
| {% endtab %}  |                                                |
| {% endtabs %} |                                                |

## 4. Enviar e receber criptomoedas

As carteiras de criptomoedas de **Notbank** oferecem uma porta de entrada segura e acessível para o dinâmico mundo dos ativos digitais. Projetadas para atender tanto novatos quanto investidores experientes, elas se destacam por sua ampla compatibilidade, que abrange uma grande **variedade de moedas e redes** líderes do mercado, permitindo que os usuários gerenciem seu portfólio em um único e conveniente lugar. Um ponto-chave da Notbank é seu compromisso com a rentabilidade do usuário, oferecendo **taxas econômicas** que otimizam cada transação. Além disso, a segurança é a prioridade máxima; com o respaldo da Notbank, essas carteiras incorporam protocolos de proteção de última geração e medidas avançadas de segurança para garantir que os fundos e a privacidade dos usuários estejam protegidos o tempo todo.

### 4.1. Criar uma carteira para receber criptomoedas

#### 4.1.1 Obter as redes disponíveis

Dada a grande quantidade de moedas e redes que a Notbank suporta, primeiro é necessário obter as redes disponíveis para uma criptomoeda.

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

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

#### 4.1.2 Obter uma carteira

Usando o código da rede ( `network` ) obtido no passo anterior mais o código da moeda (`currency`) você pode solicitar o endereço da sua carteira.&#x20;

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

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

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

{% endtab %}

{% tab title="cURL" %}

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

----

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

{% endtab %}
{% endtabs %}

### 4.2 Adicionar endereço à lista de permissões

Para garantir a máxima segurança dos seus ativos, na Notbank é necessário registrar previamente os endereços de destino em uma lista de permissões antes de realizar qualquer transferência de criptomoedas. Essa medida adicional de proteção ajuda a prevenir saques não autorizados e garante que seus fundos sejam enviados somente para carteiras confiáveis verificadas por você.

#### 4.2.1 Adicionar um endereço

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

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

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

{% endtab %}
{% endtabs %}

{% hint style="info" %}
O valor do parâmetro `otp` corresponde ao código de autenticação de dois fatores fornecido pelo seu aplicativo externo no momento de solicitar o envio.
{% endhint %}

{% hint style="info" %}
A Notbank vai enviar um **código de confirmação** para o seu número de telefone, com o qual você terá que confirmar o novo endereço que está adicionando à lista de permissões.
{% endhint %}

#### 4.2.2 Confirmar um endereço

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

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

{% endtab %}
{% endtabs %}

### 4.3. Enviar suas criptomoedas para outra carteira

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

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

{% hint style="info" %}
O valor do parâmetro `otp` corresponde ao código de autenticação de dois fatores fornecido pelo seu aplicativo externo no momento de solicitar o envio.
{% endhint %}

## 5. Comprar, vender e converter criptomoedas

Descubra **Simple**, a funcionalidade projetada para que a compra, venda e conversão de criptomoedas seja uma experiência simples, rápida e segura para todos. Esqueça interfaces complexas e tipos de ordens; com o Simple, você pode executar suas transações de forma intuitiva em poucos passos. Esta ferramenta é perfeita tanto para quem está começando no mundo cripto quanto para usuários avançados que buscam velocidade. Além da facilidade de uso, o Simple se destaca por oferecer uma taxa de transação econômica, permitindo que você otimize suas operações e tornando sua entrada no mercado cripto não apenas eficiente, mas também acessível.

### 5.1 Comprar criptomoedas com moeda fiduciária

Neste exemplo, vamos solicitar a quantidade de Bitcoin (BTC) que receberíamos se utilizássemos $100.000 pesos chilenos (CLP). Depois consultaremos o valor prometido, que tem uma validade de 20 segundos e, por fim, executaremos a compra.

{% hint style="info" %}
Os valores anexados nos exemplos têm fins educacionais e não representam o estado atual do mercado.
{% endhint %}

#### 5.1.1 Solicitar cotação

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

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

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

{% endtab %}
{% endtabs %}

#### 5.1.2 Consultar cotação

{% 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 // pendente
console.log(quote.amount_out)
// 0.0013 // BTC
```

{% endtab %}
{% endtabs %}

#### 5.1.3 Executar cotação

{% 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 // pendente
console.log(quote.amount_out)
// 0.0013 // BTC

// Depois de alguns momentos, consultar novamente o status da solicitação
const quote = await restClient.getQuoteService().getQuote({
  quote_id: "c1c56ca3-75c3-4bb6-97e3-702448382cd3",
  user_id: clientUserId
  account_id: clientAccountId,
});

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

{% endtab %}
{% endtabs %}

### 5.2 Vender criptomoedas em moeda fiduciária

Neste exemplo, vamos solicitar a quantidade de pesos chilenos (CLP) que receberíamos se utilizássemos 0.0013 Bitcoin (BTC). Depois consultaremos o valor prometido, que tem uma validade de 20 segundos e, por fim, executaremos a compra.

{% hint style="info" %}
Os valores anexados nos exemplos têm fins educacionais e não representam o estado atual do mercado.
{% endhint %}

#### 5.2.1 Solicitar cotação

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

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

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

{% endtab %}
{% endtabs %}

#### 5.2.2 Consultar cotação

{% 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 // pendente
console.log(quote.amount_out)
// 100000 // CLP
```

{% endtab %}
{% endtabs %}

#### 5.2.3 Executar cotação

{% 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 // pendente
console.log(quote.amount_out)
// 100000 // CLP

// Depois de alguns momentos, consultar novamente o status da solicitação
const quote = await restClient.getQuoteService().getQuote({
  quote_id: "1b09948d-2169-4f93-84ec-a55fb1741663",
  user_id: clientUserId
  account_id: clientAccountId,
});

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

{% endtab %}
{% endtabs %}

### 5.3 Converter criptomoedas

**A Notnank oferece duas modalidades de cotação para converter moedas.** Com a cotação direta, basta inserir o valor que você deseja converter e selecionar a moeda de origem e a moeda de destino; o sistema mostrará imediatamente quanto dinheiro você receberá na moeda final. A cotação inversa funciona ao contrário: você indica o valor que precisa receber na moeda de destino e especifica a moeda de origem, e o sistema calcula automaticamente quanto dinheiro você precisa na moeda original para obter exatamente esse valor. Dessa forma, você pode escolher a opção que melhor se adapta à sua necessidade: calcular o resultado de uma conversão ou determinar quanto você precisa ter na moeda de partida.

{% hint style="success" %}
A conversão não se limita a transações entre criptomoedas, mas sim a qualquer combinação possível: criptomoeda para criptomoeda, moeda fiduciária para criptomoeda, criptomoeda para moeda fiduciária e moeda fiduciária para moeda fiduciária.
{% endhint %}

{% hint style="info" %}
Os valores anexados nos exemplos têm fins educacionais e não representam o estado atual do mercado.
{% endhint %}

#### 5.3.1 Solicitar cotação

Neste exemplo, vamos solicitar a quantidade de Ethereum (ETH) que receberíamos se usássemos 1 Bitcoin (BTC). Depois consultaremos o valor prometido, que tem uma validade de 20 segundos e, por fim, executaremos a compra.

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

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

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

{% endtab %}
{% endtabs %}

Neste exemplo, vamos solicitar a quantidade de Bitcoin (BTC) que precisaríamos se quiséssemos 1 Ethereum (ETH). Depois consultaremos o valor prometido, que tem uma validade de 20 segundos e, por fim, executaremos a compra.

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

```js
// cotação inversa
const quoteId = await restClient.getQuoteService().createInverseQuote({
  from_currency: "BTC",
  to_amount: 1,
  to_currency: "ETH",
  operation: 3, // CONVERSION
  user_id: clientUserId
  account_id: clientAccountId,
});

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

{% endtab %}
{% endtabs %}

#### 5.3.2 Consultar cotação

{% 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 // pendente
console.log(quote.amount_out)
// 30 // ETH
```

{% endtab %}
{% endtabs %}

#### 5.3.3 Executar cotação

{% 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 // pendente
console.log(quote.amount_out)
// 30 // ETH

// Depois de alguns momentos, consultar novamente o status da solicitação
const quote = await restClient.getQuoteService().getQuote({
  quote_id: "fc4ffe0e-b87a-4e1f-a727-f6ddae7dc1e0",
  user_id: clientUserId
  account_id: clientAccountId,
});

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

{% endtab %}
{% endtabs %}

## 6. Depositar e retirar moeda fiduciária

Para facilitar a gestão dos seus fundos, a Notbank oferece aos seus usuários uma ampla variedade de métodos de pagamento projetados para se adaptar às suas necessidades. Os clientes podem carregar saldo em moeda fiduciária em suas contas de forma rápida e segura, escolhendo entre opções tradicionais como transferências bancárias, uso de cartões de crédito ou integração com modernas gateways de pagamento. Essa flexibilidade garante que cada usuário possa gerenciar seu capital com total comodidade e sob os mais altos padrões de segurança financeira.

### 6.1 Obter contas bancárias de depósito

A Notbank oferece um serviço para obter as contas bancárias de uso da Notbank `geral`, nas quais os clientes devem depositar para poder atribuir saldo às suas carteiras de moeda local.

{% hint style="info" %}
**IMPORTANTE**: Usar contas bancárias que estejam associadas à mesma identidade verificada na Notbank para uma correta atribuição do saldo.
{% endhint %}

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

```bash
GET /api/nb/bank-deposits 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": "Conta corrente",
      "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": "Conta virtual",
      "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": "Pessoa jurídica",
      "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": "Conta de dinheiro eletrônico",
      "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 %}

#### 6.1.1 Obter contas bancárias de depósito virtuais ou FBO

{% hint style="warning" %}
**IMPORTANTE**: Em breve ofereceremos suporte para contas virtuais e FBO. **Este serviço ainda está em desenvolvimento**.&#x20;
{% endhint %}

As contas **virtuais** e **FBO**, são contas bancárias do cliente, mas gerenciadas pela Notbank. Essas contas terão um número de **conta única** por cliente, que poderá ser usado para depositar e sacar saldo de moedas locais.

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

```bash
GET /api/nb/bank-deposits 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",  // novo
      "currency": "CLP",
      "bank": "BCI (BCO DE CREDITO E INV)",
      "identity_number": "76.590.133-2",
      "identity_type": "RUT",
      "company_name": "CryptoMKT SpA",
      "account_type": "Conta corrente",
      "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",  // novo
      "currency": "COP",
      "account_type": "virtual",  // novo
      "account_number": "12345678901234567890",
      "account_alias": null,  // novo
      "created_at": "2026-07-31T15:57:08",
      "updated_at": "2026-07-31T15:57:08"
    },
    {
      "id": "41d63634-2f2a-47b8-8dd5-55b81fe87243",
      "type": "fbo",  // novo
      "currency": "ARS",
      "account_type": "cvu",  // novo
      "account_number": "12345678901234567890",
      "account_alias": null,  // novo
      "created_at": "2026-07-31T15:57:08",
      "updated_at": "2026-07-31T15:57:08"
    },
    {
      "id": "41d63634-2f2a-47b8-8dd5-55b81fe87243",
      "type": "fbo",  // novo
      "currency": "USD",
      "account_type": "swift",  // novo
      "account_number": "40000010851",
      "account_alias": null,  // novo
      "created_at": "2026-07-31T15:57:08",
      "updated_at": "2026-07-31T15:57:08",
      "beneficiary": {  // novo
        "name": "beneficiary-name",
        "address": "beneficiary-address",
        "account_number": "40000010851",
        "bank": {
          "name": "bank-name",
          "swift": "XXXXXXXXXXX",
          "routing_number": "123456789"
        }
      },
      "intermediary_bank": {  // novo
        "name": "bank-name",
        "routing_number": "123456789",
        "bic_code": "XXXXXXXXXXX"
      }
    }
  ]
}
```

{% endtab %}
{% endtabs %}

### 6.2 Criar uma conta bancária de depósito virtual ou FBO

{% hint style="warning" %}
**IMPORTANTE**: Em breve ofereceremos suporte para contas virtuais e FBO. **Este serviço ainda está em desenvolvimento**.&#x20;
{% endhint %}

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

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

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

---

{
  "status": "success",
  "message": "Solicitação recebida com sucesso."
}
```

{% endtab %}
{% endtabs %}

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

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

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

---

{
  "status": "success",
  "message": "Solicitação recebida com sucesso."
}
```

{% endtab %}
{% endtabs %}

### 6.3 Editar o alias de uma conta bancária de depósito FBO

{% hint style="warning" %}
**IMPORTANTE**: Em breve ofereceremos suporte para contas virtuais e FBO. **Este serviço ainda está em desenvolvimento**.&#x20;
{% endhint %}

{% hint style="info" %}
**IMPORTANTE**: Método disponível apenas para contas **FBO** com a moeda **ARS**.
{% endhint %}

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

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

{
    "account_alias": "new-alias"
}

---

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

### 6.4 Adicionar conta bancária

#### 6.4.1 Obter lista de bancos suportados

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

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

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

{% endtab %}
{% endtabs %}

#### 6.4.2 Adicionar conta bancária

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

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

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

{% endtab %}
{% endtabs %}

#### Glossário

{% tabs %}
{% tab title="Tipo de conta bancária" %}

| País                                                 | Valor                   | Descrição                         |
| ---------------------------------------------------- | ----------------------- | --------------------------------- |
| Argentina (AR), Chile (CL), Peru (PE), Colômbia (CO) | corrente                | Conta corrente                    |
| Argentina (AR), Chile (CL)                           | vista                   | Conta vista                       |
| Argentina (AR), Chile (CL), Peru (PE), Colômbia (CO) | poupança                | Conta poupança                    |
| Argentina (AR), Chile (CL)                           | electronic\_checkbook   | Cheque eletrônico                 |
| Argentina (AR)                                       | ar\_cbu                 | Conta CBU                         |
| Argentina (AR)                                       | ar\_cvu                 | Conta CVU                         |
| Argentina (AR)                                       | ar\_alias               | Alias                             |
| Brasil (BR)                                          | br\_corriente\_fisica   | Conta corrente de pessoa física   |
| Brasil (BR)                                          | br\_simple\_fisica      | Conta simples de pessoa física    |
| Brasil (BR)                                          | br\_corriente\_juridica | Conta corrente de pessoa jurídica |
| Brasil (BR)                                          | br\_poupanca\_fisica    | Conta poupança de pessoa física   |
| Brasil (BR)                                          | br\_poupanca\_juridica  | Conta poupança de pessoa física   |
| Brasil (BR)                                          | br\_caixa\_facil        | Conta Caixa Fácil                 |
| Brasil (BR)                                          | br\_pix                 | Conta PIX                         |
| {% endtab %}                                         |                         |                                   |

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

| Valor         | Descrição          |
| ------------- | ------------------ |
| CPF           | Número do CPF      |
| CNPJ          | Número do CNPJ     |
| E-mail        | E-mail             |
| Telefone      | Número de telefone |
| Outro         | Outro              |
| {% endtab %}  |                    |
| {% endtabs %} |                    |

### 6.5 Notificar um depósito

Na Notbank, otimizamos o processo de recebimento de fundos para oferecer a você uma experiência ágil e segura na gestão dos seus ativos. Atualmente, aceitamos a notificação de depósitos em moeda fiduciária por meio de **transferências bancárias** tradicionais para todos os países onde operamos, integrando também, de forma exclusiva, o método de **Webpay** para o Chile, o que permite uma validação imediata e eficiente para os usuários dessa região. Estamos trabalhando continuamente para expandir nossas capacidades operacionais, por isso em breve adicionaremos novos métodos de pagamento à nossa API, oferecendo maior flexibilidade e alcance às nossas soluções financeiras globais.

#### 6.5.1 Notificação bancária

{% 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,  // transferência bancária
  currency: "CLP",
  amount: 1000,
  bank_account_id: "29cd83cf-3678-4207-80c7-7caaa1d24c27",
  // voucher: File. Apenas PE (Peru).
});
</code></pre>

{% endtab %}
{% endtabs %}

#### 6.5.2 Notificação Webpay

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

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

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

{% endtab %}
{% endtabs %}

### 6.6 Notificar um saque

Na Notbank, garantimos uma experiência financeira global ao oferecer o serviço de saque de moeda fiduciária em todos os países onde a plataforma está presente, permitindo que os usuários convertam seus ativos digitais em dinheiro local de forma eficiente. No entanto, é importante destacar que existe um caso especial para a Argentina: devido a processos de validação específicos nessa região, é indispensável que o usuário confirme a notificação do saque dentro do aplicativo para concluir a transação com sucesso.

#### 6.6.1 Notificação de saque bancário

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

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

{% endtab %}
{% endtabs %}

#### 6.6.2 Notificação de saque bancário na Argentina

Obter informações de uma conta CBU de destino

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

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

console.log(owners);
// [
//   {
//     "person_type": "F",
//     "cuit": "número de CUIT",
//     "name": "Nome da pessoa"
//   }, ...
// ]
```

{% endtab %}
{% endtabs %}

Notificar um saque bancário

{% 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: "número de CUIT"
  name: "Nome da pessoa"
});

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

{% endtab %}
{% endtabs %}

{% hint style="info" %}
Quando você notificar um saque bancário, a Notbank enviará um código de confirmação para o seu e-mail, que depois você deve inserir na próxima etapa.
{% endhint %}

Confirmar um saque bancário

{% 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/pt-br/crypto-as-a-service-padrao.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.