Guia de Pix Avulso

O Pix Avulso é o conjunto de operações para cobrança, transferência, devolução e consultas operacionais. Este guia funciona como um mapa de decisão para os fluxos específicos.

Pré-requisitos gerais

1. Token JWT válido (veja Guia de Autenticação);
2. Header Authorization: Bearer <token> em todas as chamadas;
3. Content-Type: application/json para payloads JSON;
4. Todos os valores no campo amount em centavos.

❗️

Conversão de valor para centavos

• R$ 1,00 -> 100
• R$ 10,50 -> 1050
• R$ 200,00 -> 20000

Escolha o guia por caso de uso

Consultas operacionais (todas as integrações)

Saldo da conta

• Consulta de saldo

GET /v1/connect/balance HTTP/1.1
Host: api.qesh.ai
Authorization: Bearer <token>

Extrato analítico

• Gerar extrato analítico

GET /v1/connect/transactions/list HTTP/1.1
Host: api.qesh.ai
Authorization: Bearer <token>

Listagens para conciliação

• Listar cobranças
• Listar transferências
• Listar devoluções

Estrutura recomendada de implementação

1. Criar operação com external_id único por evento de negócio;
2. Persistir identificadores retornados (id, end_to_end_id, txid, return_identification);
3. Confirmar status por webhook;
4. Usar consulta ativa como fallback;
5. Registrar meta.request_id em logs para suporte.

Próximos passos

• Guia de Cobrança com QR Code
• Guia de Pagamento com Chave Pix
• Guia de Pagamento com QR Code (Pix Copia e Cola)
• Guia de Pagamento com Dados Bancários
• Guia de Devoluções Pix
• Guia de Webhooks