> 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 que as instituições ofereçam a 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 que seus clientes se concentrem apenas 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 minucioso. O **CaaS com reliance**, por sua vez, é voltado para aquelas instituições que já contam com um marco de conformidade consolidado 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 é significativamente agilizado, 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 por meio da 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. Este link o direcionará a um formulário de contato específico que deve ser preenchido. 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 de API confidenciais com um identificador de usuário específico. Essas credenciais, obtidas na etapa anterior, atuam como a prova de identidade do aplicativo cliente. Ao incluir o identificador de usuário junto com essas credenciais na solicitação, a API pode verificar a identidade de quem faz a chamada e, crucialmente, autorizar as operações no nível da conta de usuário específica 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 de 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, deve usar `HMAC-SHA256` para codificar seu `Nonce`, `UserId` (ID de usuário) e 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 aos seus usuários, nosso cadastro 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';

// ..

// cadastro 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, criado para garantir a segurança e oferecer capacidades operacionais progressivas. O nível inicial é o **Observador**, que é 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": "Rosario", 
  "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               |
| investidor                | Investidor                |
| estudante                 | Estudante                 |
| dona de casa              | Dona de casa              |
| contador                  | Contador                  |
| ator\_atriz               | Ator/Atriz                |
| comissária de bordo       | Comissária de bordo       |
| arqueólogo                | Arqueólogo                |
| arquiteto                 | Arquiteto                 |
| astronauta                | Astronauta                |
| padeiro                   | Padeiro                   |
| biólogo                   | Biólogo                   |
| pedreiro                  | Pedreiro                  |
| motorista                 | Motorista                 |
| empresário                | Empresário                |
| açougueiro                | Açougueiro                |
| zelador/porteiro          | Zelador/Porteiro          |
| carpinteiro               | Carpinteiro               |
| caixa                     | Caixa                     |
| faxineiro                 | Faxineiro                 |
| palhaço                   | Palhaço                   |
| sapateiro                 | Sapateiro                 |
| cozinheiro\_chef          | Cozinheiro/Chef           |
| químico                   | Químico                   |
| dançarino                 | Dançarino                 |
| decorador                 | Decorador                 |
| dentista                  | Dentista                  |
| designer                  | Designer                  |
| médico                    | Médico                    |
| costureira                | Costureira                |
| lixeiro                   | Lixeiro                   |
| economista                | Economista                |
| eletricista               | Eletricista               |
| engenheiro                | Engenheiro                |
| agricultor                | Agricultor                |
| bombeiro                  | Bombeiro                  |
| pescador                  | Pescador                  |
| florista                  | Florista                  |
| fruteiro                  | Fruteiro                  |
| jardineiro                | Jardineiro                |
| geólogo                   | Geólogo                   |
| cabeleireiro              | Cabeleireiro              |
| joalheiro                 | Joalheiro                 |
| jornalista                | Jornalista                |
| juiz                      | Juiz                      |
| advogado                  | Advogado                  |
| bibliotecário             | Bibliotecário             |
| salva-vidas               | Salva-vidas               |
| carteiro                  | Carteiro                  |
| mecânico                  | Mecânico                  |
| meteorologista            | Meteorologista            |
| minerador de criptomoedas | Minerador de criptomoedas |
| minerador                 | Minerador                 |
| modelo                    | Modelo                    |
| babá                      | Babá                      |
| freira                    | Freira                    |
| enfermeira                | Enfermeira                |
| pintor                    | Pintor                    |
| confeiteiro               | Confeiteiro               |
| farmacêutico              | Farmacêutico              |
| fotógrafo                 | Fotógrafo                 |
| físico                    | Físico                    |
| encanador                 | Encanador                 |
| policial                  | Policial                  |
| político                  | Político                  |
| sacerdote                 | Sacerdote                 |
| professor                 | Professor                 |
| programador               | Programador               |
| psiquiatra                | Psiquiatra                |
| psicólogo                 | Psicólogo                 |
| recepcionista             | Recepcionista             |
| pesquisador\_cientista    | Pesquisador científico    |
| marinheiro                | Marinheiro                |
| vendedor                  | Vendedor                  |
| secretário                | Secretário                |
| atendente\_de\_loja       | Atendente de loja         |
| cantor                    | Cantor                    |
| assistente\_social        | Assistente social         |
| esportista                | Esportista                |
| cirurgião                 | Cirurgião                 |
| taxista                   | Taxista                   |
| telefonista               | Telefonista               |
| agente\_de\_viagens       | Agente de viagens         |
| veterinário               | Veterinário               |
| garçom\_garçonete         | Garçom/Garçonete          |
| escritor                  | Escritor                  |
| entregador                | Entregador                |
| motorista de Uber         | Motorista de Uber         |
| piloto                    | Piloto                    |
| administrativo            | Administrativo            |
| servidor\_público         | Servidor público          |
| outro                     | Outro                     |
| atendimento\_ao\_cliente  | Atendimento ao cliente    |
| militar                   | Militar                   |
| manager\_officier         | 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            | São João                                          |
| 8            | São Luís                                          |
| 22           | Santa Cruz                                        |
| 2            | Santa Fé                                          |
| 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 Páscoa               | Isla de Páscoa               |
| 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                     |
| Estação Central              | Estação Central              |
| Huechuraba                   | Huechuraba                   |
| Independência                | Independência                |
| 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 Família              | Sagrada Família              |
| 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 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             | Serviço                                        |
| 30            | Endereço comprovado                            |
| 35            | Fatura de cartão de crédito                    |
| 36            | Holerites                                      |
| 37            | Certificado de vizinhos                        |
| 38            | Certificado de domicílio notarial              |
| 39            | Fatura de produto com certificado de pagamento |
| 41            | Serviço com nascimento                         |
| 40            | Serviço com casamento                          |
| 42            | Carteira de motorista com endereço             |
| {% endtab %}  |                                                |
| {% endtabs %} |                                                |

## 4. Enviar e receber criptomoedas

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

### 4.1. Criar uma carteira para receber criptomoedas

#### 4.1.1 Obter as redes disponíveis

Dada a grande quantidade de moedas e redes suportadas pela Notbank, 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 na etapa 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 branca

Para garantir a máxima segurança dos seus ativos, na Notbank é necessário registrar previamente os endereços de destino em uma lista branca antes de realizar qualquer transferência de criptomoedas. Essa medida extra de proteção ajuda a evitar 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 que sua aplicação externa fornece no momento de solicitar o envio.
{% endhint %}

{% hint style="info" %}
A Notbank vai te 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 branca.
{% 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 que sua aplicação externa fornece no momento de solicitar o envio.
{% endhint %}

## 5. Comprar, vender e converter criptomoedas

Descubra **Simple**, a funcionalidade projetada para tornar a compra, venda e conversão de criptomoedas 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 tarifa 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 fiat

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 validade de 20 segundos e, por fim, executaremos a compra.

{% hint style="info" %}
Os valores mostrados nos exemplos são apenas para 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 instantes, 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 por moeda fiat

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 validade de 20 segundos e, por fim, executaremos a compra.

{% hint style="info" %}
Os valores mostrados nos exemplos são apenas para 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 instantes, 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 Notbank oferece duas modalidades de cotação para converter moedas.** Com a cotação direta, basta informar o valor que 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ê informa o valor que precisa receber na moeda de destino e especifica a moeda de origem, e o sistema calcula automaticamente quanto dinheiro você precisa ter 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 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 fiat para criptomoeda, criptomoeda para moeda fiat e moeda fiat para moeda fiat.
{% endhint %}

{% hint style="info" %}
Os valores mostrados nos exemplos são apenas para 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 utilizássemos 1 Bitcoin (BTC). Depois consultaremos o valor prometido, que tem 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) de que precisaríamos se quiséssemos 1 Ethereum (ETH). Depois consultaremos o valor prometido, que tem 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 instantes, 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 fiat

Para facilitar o gerenciamento 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 fiat 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 plataformas 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 Adicionar conta bancária

#### 6.1.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 do Chile",
//     "country": "CL"
//   },
//   {
//     "id": "388c4c6f-d0b5-4a42-927c-bbcc64e7ce2e",
//     "name": "Banco Estado",
//     "country": "CL"
//   }, ...
// ]
```

{% endtab %}
{% endtabs %}

#### 6.1.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) | ahorro                  | Conta poupança                    |
| Argentina (AR), Chile (CL)                           | electronic\_checkbook   | Talão de cheques eletrônico       |
| Argentina (AR)                                       | ar\_cbu                 | Conta CBU                         |
| Argentina (AR)                                       | ar\_cvu                 | Conta CVU                         |
| Argentina (AR)                                       | ar\_alias               | Apelido                           |
| 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     |
| EMAIL         | E-mail             |
| Phone         | Número de telefone |
| Outro         | Outro              |
| {% endtab %}  |                    |
| {% endtabs %} |                    |

### 6.2 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 em que 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.2.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.2.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.3 Notificar um saque

A Notbank garante 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.3.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.3.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 do 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 do CUIT",
  name: "Nome da pessoa"
});

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

{% endtab %}
{% endtabs %}

{% hint style="info" %}
Ao notificar um saque bancário, a Notbank enviará um código de confirmação para o seu e-mail, que você deverá 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.