# Fluxo prático: Do login ao primeiro recebimento

Abaixo é detalhado como realizar o primeiro recebimento de PIX 

## 1. Login do usuário

Realize o login com as credenciais do usuário na rota do usuário.
Utilize a rota `/auth/user/login` informando o email e senha cadastrados para o usuário.

``` bash
POST https://api-pix.dadosjah.com.br/v1/auth/user/login
Content-Type: application/json
{
  "email": "usuario@empresa.com",
  "password": "SuaSenhaSegura"
}
```

O retorno esperado é o accessToken.
Guarde este token, ele será utilizado nas próximas requisições.

``` bash
{
    "statusCode": 201, 
    "data": {
        "accessToken": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
        "expiresAt": "2025-04-18T20:14:13-03:00"
    }
}
```

> **Atenção:** Caso o token esteja expirado ou próximo de expirar (utilize o campo "expiresAt" para saber a data/hora de expiração), você pode renovar o token executando novamente a rota de login e gerando um novo token.

## 2. Cadastrar a conta bancária

Faça o cadastro da conta bancária, levando em consideração que é possível ter mais de uma conta bancária (é ilimitado), inclusive por banco.
Abaixo é realizado o cadastro de uma conta bancária:

``` bash
POST https://api-pix.dadosjah.com.br/v1/user/account
Authorization: Bearer 
Content-Type: application/json
[
  {
    "nameAccount": "Conta Principal",
    "psp": "INTER",
    "keyTypePIX": "EMAIL",
    "keyPIX": "financeiro@empresa.com",
    "clientId": "seu-client-id-do-inter",
    "clientSecret": "seu-client-secret-do-inter",
    "scopes": ["scCobWrite", "scCobRead", "scPixWrite", "scPixRead"],
    "active": true
  }
]
```

> **Atenção:** Cada banco pode exigir mais ou menos dados e não é necessário no cadastro colocar todos os dados, é possível cadastrar com os dados básicos e depois alterar a partir da rota `patch /user/account` 

O retorno esperado é o cadastro com "idAccount", guarde este dado, pois será utilizado para criar a cobrança.

``` bash
{
    "statusCode": 200
    "data": {
        "account": [ 
            {
                "idAccount": "{{id-da-conta}}",
                "idSystem": "{{id-do-sistema}}",
                "idUser": "{{id-do-usuario}}", 
                "nameAccount": "Conta Principal", 
                "psp": "INTER",
                ...//outros dados
            }
        ],
        "currentPage": 1, 
        "totalPages": 1, 
        "totalItens": 1
    }
}
``` 

## 3. Criar a cobrança

Crie a cobrança enviando so dados necessários conforme PSP indica.
É possível fazer a requisição `/cob` ou `/cobv`.
Lembre-se de enviar o "idAccount" da conta cadastrada na etapa anterior.

``` bash
POST https://api-pix.dadosjah.com.br/v1/cob
Authorization: Bearer 
Content-Type: application/json
{
  "async": false,
  "idAccount": "{{id-da-conta}}",
  "cobs": [
    {
      "reqOriginalValue": "10.00",
      "reqExpirationSeconds": 3600,
      "reqDebtorCPFCNPJ": "02598982000190",
      "reqDebtorName": "João Silva"
    }
  ]
}
``` 
O retorno é esperado a confirmação da cobrança e demais dados retornados pelo PSP.

``` bash
{
    "statusCode": 201,
    "data": { 
        "cobs": [ 
            {
                "idCob": "{{idCob}}", 
                "idSystem": "{{idSystem}}", 
                "idUser": "{{idUser}}", 
                "idBatch": "{{idBatch}}", 
                "idAccount": "{{idAccount}}", 
                "async": {{async}}, 
                "idExternal": "{{idExternal}}",
				"resPixCopyandPaste": "{{pix-copia-cola}}",
				...//outros dados				
            }
        ],
        "currentPage": 1,
        "totalItens": 1,
        "totalPages": 1
    }
}
```

## 4. Enviar o Pix Copia e Cola para o cliente

Envie para o cliente o campo resPixCopyandPaste que é o PIX COPIA E COLA ou gere um QR Code a partir desta chave retornada.

## 5. Confirmar o pagamento

Quando o pagamento for confirmado ou caso queira verificar se foi pago, utilize a rota `/cob` enviando um dos parâmetros de pesquisa e o forceUpdate igual a true.

``` bash
curl --location --globoff 'https://api-pix.dadosjah.com.br/v1/cob?idCob={{idCob}}&forceUpdate={{forceUpdate}}'
```
