报表与对账
将交易转化为可用的财务记录。
Business Portal 报表支持导出 XLS，配合余额与流水 API 以及签名 webhook，为财务团队提供每笔收款、付款和换汇的逐笔明细——覆盖您运营的所有国家。
- 报表可导出 XLS
- 余额、流水与对账 API
- HMAC 签名 webhook
报表可导出 XLS每日对账
2026年9月29日 · 🇧🇷 BRL
| 参考号 | 方式 | 净额 | 状态 |
|---|---|---|---|
| PI-8F2K1043 | Pix | 1,231.25 | 已对账 |
| PI-3B7Q0211 | Pix QR | 4,905.79 | 已对账 |
| PO-9A1C1189 | TED | 22,138.00 | 已对账 |
| PI-5D2E0042 | Pix | 876.65 | 已对账 |
| 合计 · 4 笔 | 29,151.69 | 4 / 4 | |
结算批次 stl_0929_BRL · 0 待处理 · 0 异常
- Business Portal 核心报表
- 5
- 账户资金变动的每日台账
- FIDES
- 定时发送报表
- SFTP · 邮件
- 通过 API 或 Business Portal 获取报表
- API + Portal
为什么重要
财务与运营的唯一可信数据源
各国的收款、付款、换汇和手续费都汇入同样的报表和 API，并使用您系统中已有的标识符。
逐笔明细
每笔交易都包含 externalId、internalId、状态、金额和手续费；涉及换汇时，还包括所用汇率。
各国统一格式
每个市场、每条通道都使用相同的报表和接口，新增国家无需新增对账流程。
余额可核对
按账户查看余额和预计余额，并通过余额对账 API 核对资金变动。
任意交易可查
按 externalId 查询交易、查看状态，或分页列出并筛选交易。
实时 webhook
收款、虚拟账户、付款、货币兑换以及 Wire In/Wire Out 均有 HMAC 签名通知；若您的端点未返回 200，将自动重试。
定时推送
通过电子邮件或 SFTP 按日、周或月定时推送余额、FIDES、明细、流水或全球合并报表，格式为 XLS 或 CSV。
Business Portal 报表
财务最常用的报表
在 Business Portal 中生成报表，并导出 XLS 供 ERP、电子表格或审计使用。
余额
- 内容
- 按账户和币种显示当前余额
- 典型用途
- 每日资金头寸
预计余额
- 内容
- 包含处理中资金变动的预计余额
- 典型用途
- 规划付款与注资
账户流水
- 内容
- 某一期间内账户的入账和出账
- 典型用途
- 与账簿逐笔核对
交易明细
- 内容
- 每笔交易的标识符、状态、金额和手续费
- 典型用途
- 按订单对账与客户服务
FIDES
- 内容
- 账户资金变动的每日台账
- 典型用途
- 每日结账与审计追踪
以上为概要说明。各报表的准确字段请参阅 docs.localpayment.com 上的报表指南。
工作原理
从交易发生到完成结账
为每笔交易打标
每笔收款、付款或换汇都附上您自己的唯一 externalId，Localpayment 会为同一记录返回 internalId。
接收通知
每次状态变化都通过签名 webhook 通知。您的系统验签、返回 200 并更新订单。
核对余额
通过 API 或 Business Portal 报表按账户比对流水和余额，按交易和币种逐项列明。
结账并导出
使用余额对账 API 完成对账，并将报表导出为 XLS，供 ERP 和审计使用。
Webhook
状态一变，立即知晓
Webhook 在 Business Portal 中按客户配置：HTTPS 地址、单个国家或全部国家、账户以及可选的自定义请求头。每个负载都经过签名，收到的数据值得信赖。
- 在 X-Signature 请求头中使用 HMAC-SHA256 签名
- 覆盖收款、虚拟账户、订阅、付款、货币兑换、Wire In 和 Wire Out 事件
- 端点未返回 200 时按指数退避重试
- 按 internalId 或 externalId 去重
- 09:41:02.11409:41:02PayIn100 INPROGRESS20084 ms
- 09:41:05.90209:41:05PayIn200 COMPLETED20091 ms
- 09:42:18.33009:42:18PayOut100 INPROGRESS20077 ms
- 09:42:40.01809:42:40PayOut200 COMPLETED20088 ms
- 09:43:00.55109:43:00VirtualAccount200 COMPLETED20080 ms
POST https://example-merchant.com/webhooks/localpayment
x-Signature: HMAC-SHA256 3f9a1c0e…b47e2b
{ "transactionType": "PayIn", "transactionFlow": "DIRECT",
"data": { "externalId": "order_8F2K-1043",
"status": { "code": "200", "description": "COMPLETED" } } }适用团队
为负责结账的团队而设计
财务与会计
借助逐笔明细报表和与账簿一致的余额，实现每日结账。
资金管理
按账户和币种跟踪余额与预计余额。
资金管理 —运营与客服
按 externalId 查找任意交易，用准确状态答复客户。
工程
借助 REST API、分页和签名 webhook 实现自动对账。
工程 —
开发者
可自动化的对账
通过与支付相同的 REST API 获取余额、流水和交易，使用 Bearer 令牌认证。上线前可在 Stage 中测试每个调用。
- GET /api/accounts/{accountNumber}/balance、/activity 与 /balance-reconciliation
- GET /api/transactions/{externalId} 与 /status
- GET /api/transactions/list/filter，支持分页
# 示例请求——具体接口规范请以 docs.localpayment.com 为准
curl https://api.stage.localpayment.com/api/accounts/<your-account-number>/balance-reconciliation \
-H "Authorization: Bearer $ACCESS_TOKEN"
# 列出并筛选交易（参数仅为示例）
curl -G https://api.stage.localpayment.com/api/transactions/list/filter \
-H "Authorization: Bearer $ACCESS_TOKEN" \
--data-urlencode "since=2026-09-01" \
--data-urlencode "until=2026-09-30" \
--data-urlencode "page=1" \
--data-urlencode "size=100"常见问题
Business Portal 提供哪些报表？
余额、预计余额、账户流水、FIDES 和交易明细。大多数报表可导出为 XLS；大批量导出会在历史报表中排队，通知报表可按计划通过电子邮件或 SFTP 发送。
可以通过 API 对账吗？
可以。余额、流水和余额对账接口均按账户提供；您还可以查询单笔交易、查看状态，或分页列出并筛选交易。
如何把一笔付款与我系统中的订单对应起来？
创建交易时提交您自己的唯一 externalId。它会随 webhook、报表和 API 响应一起返回，并附带 Localpayment 分配的 internalId。
手续费和汇率会逐项列明吗？
会。每笔交易的数据包括金额、币种和手续费；涉及换汇时，还包括汇率和本币金额。
如果我的 webhook 端点不可用怎么办？
端点未返回 200 时，系统会按指数退避重试。您也可以随时调用交易状态 API 查询。
各国的报表是否一致？
是的。您运营的所有国家和通道都使用相同的报表、接口和标识符，新增市场无需新增对账流程。
可以每天自动拉取报表吗？
可以。活动和余额对账端点支持日期范围，定时任务可以获取昨日流水并记入您的账本。
可以查询多久以前的交易？
在交易列表 API 中使用日期筛选和分页。在 Business Portal 中，超过 15,000 行的导出会进入队列，并在历史报表中下载。