教程
独立的端点只是工具。教程展示如何将它们组合成真实的流程。每一个都附有可直接复制的代码。
按使用场景
每个教程涵盖的内容
| 教程 | 主要端点 | 何时使用 |
|---|---|---|
| 接收 Pix | POST /pix、GET /pix、callback COMPLETED | 在线商店、网关、订阅收费。 |
| 发送 Pix | GET /pix/key、POST /withdraw、POST /withdraw/qrcode | 支付供应商、向用户转账、市场平台 payout。 |
| 内部转账 | POST /internal-transfer、GET /internal-transfer | 在 Saq 账户之间转移余额，无需触及 Pix。 |
| 对账 | GET /user/transactions、POST /user/report | 日终结账、审计、BI。 |
| 违规（MED） | GET /user/infractions、POST .../defenses | 收到带有 infraction 已开启的 webhook 时。 |
涵盖的流程
示例中的约定
| 项目 | 约定 |
|---|---|
| Token | 变量 $TOKEN 或 process.env.SAQ_TOKEN |
| Base URL | https://api.saq.processamento.com/v1 |
| Content-Type | application/json（每次调用必填） |
| 金额 | 以雷亚尔（BRL）为单位，不使用分 |
| 编程语言 | 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.