# Fluxo básico de Baas

> Este documento irá ajudá-lo a entender o fluxo básico de BaaS.

## Pré-requisitos

Antes de começar a utilizar a API BaaS é necessário duas coisas:

- Solicitar ativação das features: BaaS e Criação de conta
- Gerar uma chave de API master

A API precisa ser do tipo MASTER porque ela precisa ser capaz de criar novas integrações. A conta bancária relacionada a essa API será utilizada no processo de criação das novas contas bancárias, elas usarão os dados desta para serem criadas.

Assim estamos prontos para iniciar a sequência de integração.

## Sequência da integração

![basic-flux-baas](__assets__/basic-flux-baas.png)

## 1. Registrando uma conta

- Utilize o endpoint de registro de conta para registrar uma nova conta
- Utilize a chave de API master para autenticar a requisição
- Faça a requisição:

```bash
curl --request POST \
  --url https://api.woovi.com/api/v1/kyc/onboarding \
  --header 'Authorization: Bearer REPLACE_BEARER_TOKEN' \
  --header 'content-type: application/json' \
  --data '{"taxID":"string","correlationID":"string","redirectUrl":"https://partner.example.com/kyc-done","representatives":[{"taxID":"string","name":"string"}]}'
```

Caso tudo ocorra corretamente, um código 201 será retornado. No corpo da resposta terá:

```json
{
  "linkOnboarding": "https://kyc.woovi.com/onboarding/QWNjb3VudFJlZ2lzdGVyOjY5...",
  "redirectUrl": "https://partner.example.com/kyc-done",
  "accountRegister": {
    "status": "PENDING",
    "officialName": "RAZAO_SOCIAL_DA_EMPRESA",
    "tradeName": "NOME_FANTASIA_DA_EMPRESA",
    "taxID": {
      "taxID": "XXXXXXXX0001XX",
      "type": "BR:CNPJ"
    },
    "correlationID": "my-unique-id",
    "representatives": [
      {
        "name": "NOME_DO_SOCIO",
        "taxID": {
          "taxID": "XXXXXXXXXXX",
          "type": "BR:CPF"
        }
      }
    ]
  }
}
```

## 2. Aguarde a aprovação da conta

Cadastre um webhook ouvindo o seguinte evento: `ACCOUNT_REGISTER_APPROVED`.

Para cadastrar um webhook faça a seguinte request:

```bash
curl --location --request POST 'https://api.woovi.com/api/openpix/v1/webhook' \
  --header 'Content-Type: application/json' \
  --header 'Authorization: <apiMasterKey>' \
  --data-raw '{
    "webhook": {
      "name": "webhook via api",
      "event": "ACCOUNT_REGISTER_APPROVED",
      "url": "https://minhaurl.test/webhook",
      "authorization": "auth_key",
      "isActive": true
    }
  }'
```

No corpo da resposta terá:

```json
{
  "event": "ACCOUNT_REGISTER_APPROVED",
  "accountRegister": {
    "correlationID": "<CNPJ>",
    "officialName": "<NOME-COMPLETO>",
    "taxID": {
      "taxID": "<CNPJ>",
      "type": "BR:CNPJ"
    },
    "status": "APPROVED"
  },
  "account": {
    "status": "OPEN",
    "accountId": "6a1ec49c050ca1d11348008f",
    "account": "00000000000006588018",
    "branch": "0001"
  }
}
```

## 3. Gere uma chave de API padrão

- Utilize o endpoint de application para gerar uma chave de API para a conta recém criada
- Utilize a chave de API master para autenticar a requisição
- Faça a requisição:

```bash
curl -X POST "https://api.woovi.com/api/v1/application" \
  -H "Authorization: <apiMasterKey>" \
  -H "Content-Type: application/json" \
  --data-raw '{
    "accountId": "6a10805a342fd2a76aa0e5ac",
    "application": {
      "name": "Teste API",
      "type": "API",
      "scopes": [
        "CHARGE_GET"
      ]
    }
  }'
```

Caso tudo ocorra corretamente, um código 201 será retornado. No corpo da resposta terá:

```json
{
  "application": {
    "name": "Teste API",
    "isActive": true,
    "type": "API",
    "clientId": "Client_Id_791f667b-c885-45e4-bbe1-468de247a9f6",
    "clientSecret": "Client_Secret_JgDrJ3fedGz9DXlBqPUogNy8HxAucm47l/FWwfSInl8=",
    "appID": "<APID>",
    "scopes": [
      "CHARGE_GET"
    ]
  }
}
```

## 4. Gere uma chave PIX aleatória

- Utilize o endpoint pix-keys para gerar uma chave para a conta
- Utilize o appID gerado no passo anterior para autenticar a requisição
- Faça a requisição:

```bash
curl -X POST "https://api.woovi.com/api/v1/pix-keys" \
  -H "Authorization: <appID>" \
  -H "Content-Type: application/json" \
  --data-raw '{
    "type": "EVP"
  }'
```

Caso tudo ocorra corretamente, um código 200 será retornado. No corpo da resposta terá:

```json
{
  "pixKey": {
    "pixKey": "",
    "type": "EVP",
    "isDefault": false
  }
}
```

Para outros tipos de chave e gerenciamento, veja [Chaves Pix das contas](./chaves-pix-contas.md).