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/staticInformações enviadas no corpo da requisição:
amount: valor em centavos (ex.: 1000 = R$10,00)
reference: um identificador único para controle interno (ex.: número do pedido)
bank_account_id: ID da conta bancária vinculada
currency: código da moeda (geralmente "BRL" para Real Brasileiro)
virtual_account_id: ID da conta virtual que receberá os fundos
Exemplo:
json
{
"amount": 1000,
"reference": "PED-2025-001234",
"bank_account_id": "0197676a-012d-725c-95fa-b9a54a4536b1",
"currency": "BRL",
"virtual_account_id": "0197676a-013e-7121-b1a5-e720b44c5c95"
}✅ 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)
expires_at: data de expiração do QR Code
Exemplo de resposta:
json
{
"txid": "f13733b4-673b-4411-ba9d-e3029a94d1d6",
"qrcode": "data:image/png;base64,...",
"brcode": "00020126...6304C732",
"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.
Last updated