对账
实时列表
用于查看实时交易（仪表板、前一日对账）：
curl "https://api.payzu.processamento.com/v1/user/transactions?dateFrom=2025-08-01&dateTo=2025-08-31&page=1&limit=100" \
-H "Authorization: Bearer $TOKEN" \
-H "Content-Type: application/json"过滤器详情见 GET /user/transactions。
实用过滤器
| 过滤器 | 描述 |
|---|---|
clientReference | 查找对应你订单的交易。 |
status | CSV：COMPLETED,PENDING。支持多个。 |
type | CSV：DEPOSIT,WITHDRAW,COMMISSION。 |
dateFrom / dateTo | 时间窗口（ISO 8601）。 |
endToEndId | Bacen 唯一标识符。 |
document, name | 按付款人过滤。document 仅数字（11 或 14 位）。 |
virtualAccount | 按租户过滤（多店铺）。 |
limit, page | 分页。limit 最大 100。 |
单笔交易详情
curl "https://api.payzu.processamento.com/v1/user/transactions/PAYZU2025..." \
-H "Authorization: Bearer $TOKEN" \
-H "Content-Type: application/json"Schema 见 GET /user/transactions/{id}。
异步报表
用于大时间窗口（月、年），使用 3 步流程。
请求生成
curl -X POST https://api.payzu.processamento.com/v1/user/report \
-H "Authorization: Bearer $TOKEN" \
-H "Content-Type: application/json" \
-d '{
"dateFrom": "2025-01-01",
"dateTo": "2025-12-31",
"status": ["COMPLETED"],
"type": ["DEPOSIT", "WITHDRAW"]
}'响应中包含任务的 id。
跟踪状态
curl "https://api.payzu.processamento.com/v1/user/report/JOB_ID" \
-H "Authorization: Bearer $TOKEN" \
-H "Content-Type: application/json"就绪后下载
POST /user/report/{id}/download 返回短期有效的签名 URL，用于下载 CSV。
curl -X POST "https://api.payzu.processamento.com/v1/user/report/JOB_ID/download" \
-H "Authorization: Bearer $TOKEN" \
-H "Content-Type: application/json"推荐策略
- 用
clientReference标识每一笔收款/提现，这是你的标识符，不要只依赖 PayZu 的id。 - 将 callbacks 作为主要数据源，不要轮询。
- 每日通过报表对账：获取前一日的 CSV 并与你的数据库交叉核对。可检测遗漏的 callback。
- 保存
endToEndId，争议时便于在 Bacen 进行追溯。
余额
支付前查看可用余额：
curl https://api.payzu.processamento.com/v1/user/balance \
-H "Authorization: Bearer $TOKEN" \
-H "Content-Type: application/json"Transferência interna
Quando origem e destino são contas PayZu, você pode mover saldo entre elas sem passar pelo Pix tradicional. Liquidação instantânea, identificação por accountNumber. Ideal para repasses internos entre matriz/filial ou pagar parceiros PayZu.
Infrações (MED)
O MED é o processo do Bacen para contestar Pix em casos de fraude ou erro do pagador. Quando uma cobrança recebida vira disputa, a PayZu cria uma infração e você tem prazo curto para responder com defesa.