# Depósito

💰 O que é depósito com QR Code Estático?\
Depósito é uma funcionalidade que permite adicionar dinheiro (crédito) à sua conta virtual via PIX. A operação é realizada usando um QR Code Estático, que pode ser gerado diretamente pelo sistema.\
Esse QR Code pode ser escaneado por qualquer aplicativo bancário ou carteira digital que suporte PIX. Após a leitura e o pagamento, o valor é creditado automaticamente na conta virtual vinculada.

🧾 Como funciona tecnicamente (visão simplificada):\
Quando o sistema precisa gerar um novo QR Code para um depósito via PIX, ele envia uma requisição **POST** para o seguinte endpoint da API:

```
https://api.aurixpay.ws/banking/v1/cashin/pix/qrcode/static
```

Informações enviadas no corpo da requisição:

* **amount**: valor em centavos (ex.: 1000 = R$10,00)
* **bank\_account\_id**: ID da conta bancária vinculada
* **description**: adiciona uma descrição ao pagamento
* **reference**: um identificador único para controle interno (ex.: número do pedido)
* **currency**: código da moeda (geralmente "BRL" para Real Brasileiro)
* **options:** configurações adicionais para a criação do pagamento
  * **show\_qrcode\_image:** opção para exibir ou não o código QR
  * **skip\_webhook:** ignora o envio do webhook de criação

Exemplo:

```json
{
  "amount": 10,
  "bank_account_id": "0198c2e7-7b9e-703a-ac98-870740b0cd5a",
  "description": "testes",
  "reference": "PIX-2025-001234",
  "currency": "BRL",
  "options": {
    "show_qrcode_image": true,
    "skip_webhook": false
  }
}
```

✅ O que o sistema retorna:\
Se tudo ocorrer bem, o sistema responde com:

* **txid**: identificador único da transação
* **qrcode**: imagem do QR Code em base64 (pode ser renderizada para o usuário escanear)
* **brcode**: código PIX (pode ser copiado e colado em um app bancário)
* **reference**: um identificador único para controle interno (ex.: número do pedido)
* **expires\_at**: data de expiração do QR Code

Exemplo de resposta:

```json
{
  "txid": "f13733b4-673b-4411-ba9d-e3029a94d1d6",
  "qrcode": "data:image/png;base64,iVBORw0/ACA+z/Wg/8OA...",
  "brcode": "00020126860014br.gov.bcb.pix2564pix.ecomovi.com.br/qr/v3/at/f3daf9b4-86fe-4a63-9fc3-59f604818cf95204000053039865802BR5925DGDS_FERNANDES_COMERCIO_L6009SAO_PAULO62070503***6304C732",
  "reference": "PIX-2025-001234",
  "expires_at": "2025-06-13T06:21:28.000000Z"
}
```

🛠️ Para que serve no sistema?

* Permite que o usuário adicione fundos de forma fácil e rápida, sem taxas.
* Ideal para integrações com marketplaces, carteiras digitais ou aplicativos financeiros que trabalham com contas virtuais.
* Disponível 24/7, sem necessidade de aprovação manual.