PayZu Docs

每天将您的交易与我们的进行核对，实时查询流水或拉取长周期的报表，并使用您自己的引用将每笔付款与正确的订单匹配起来。

GETGET /user/transactions/user/transactions POSTPOST /user/report/user/report 分页多租户

实时列表

用于实时查看交易（仪表盘、前一日对账）：

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、type、dateFrom/dateTo 时间窗口、endToEndId、document/name、virtualAccount）记录于分页 · 可用筛选参数。

单笔交易详情

curl "https://api.payzu.processamento.com/v1/user/transactions/PAYZU2025..." \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json"

Schema 见 GET /user/transactions/{id}。

异步报表

对于大时间窗口（月度、年度），使用三步流程。

请求生成

POST /user/report。

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。

跟踪状态

GET /user/report/{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"

余额

在发起付款前查询可用余额：

curl https://api.payzu.processamento.com/v1/user/balance \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json"

参见 GET /user/balance。

对账