Tutoriais
Os endpoints isolados são ferramentas. Os tutoriais mostram como combinar eles em fluxos reais. Cada um traz código pronto pra copiar.
Por caso de uso
O que cada um cobre
| Tutorial | Endpoints principais | Quando seguir |
|---|---|---|
| Receber Pix | POST /pix, GET /pix, callback COMPLETED | Loja online, gateway, cobrança de assinatura. |
| Enviar Pix | GET /pix/key, POST /withdraw, POST /withdraw/qrcode | Pagar fornecedor, repasse a usuário, payout de marketplace. |
| Transferência interna | POST /internal-transfer, GET /internal-transfer | Mover saldo entre contas Saq sem tocar no Pix. |
| Conciliação | GET /user/transactions, POST /user/report | Fechar caixa diário, auditoria, BI. |
| Infrações (MED) | GET /user/infractions, POST .../defenses | Quando recebe webhook com infraction aberta. |
Fluxos cobertos
Convenções nos exemplos
| Item | Convenção |
|---|---|
| Token | Variável $TOKEN ou process.env.SAQ_TOKEN |
| Base URL | https://api.saq.processamento.com/v1 |
| Content-Type | application/json (obrigatório em toda chamada) |
| Valores | Em reais (BRL), nunca centavos |
| Linguagens | curl, Node.js, Python, Go, PHP |
Get Withdrawal Receipt
Retorna o comprovante da transação como JSON com o campo `base64` (PDF codificado). Decodifique pra exibir ou salvar como `.pdf`.
Receber pagamento Pix
Fluxo completo para receber dinheiro de um cliente via Pix. Você cria a cobrança, exibe o QR Code, processa o callback de COMPLETED e implementa polling como fallback. Código pronto em curl, Node, Python, Go e PHP.