对账文件
了解 Adopay 商户日报的内容、交付方式与字段说明。
能力概览
- 明细与汇总：按日提供代收、代付、提现、资金流水、MED 投诉、代收退款、代付退款明细，以及商户日统计汇总。
- 交付方式：支持 SFTP 下载；也可按配置通过邮件附件投递（与 SFTP 文件内容一致）。
- 文件格式：UTF-8（带 BOM）编码的 CSV，可用 Excel / Numbers / 文本工具打开。
可用报表
| 报表 | 文件名后缀 | 说明 |
|---|---|---|
| 代收订单 | payin_orders | 指定自然日内的代收（Payin）订单明细 |
| 代付订单 | payout_orders | 指定自然日内的代付（cashout）订单明细 |
| 提现订单 | withdrawal_orders | 指定自然日内的提现订单明细 |
| 资金流水 | bills | 指定自然日内的商户余额变动流水 |
| 商户日统计 | mch_static | 指定自然日的商户汇总统计（含环比） |
| MED 投诉 | meds | 指定自然日内的 PIX MED 投诉明细 |
| 代收退款 | ordeRefund | 指定自然日内的代收退款明细 |
| 代付退款 | payoutRefund | 指定自然日内的代付退款明细 |
实际落盘文件名见下文「文件命名规范」。具体生成哪些报表以贵司开通配置为准。
生成时间
报表按日生成，统计范围为巴西时区（America/Sao_Paulo）对应自然日的前一日全天订单/流水/统计数据。
- 生成时刻：巴西时间每天凌晨
01:00（对应北京时间中午12:00）。 - 生成完成后文件写入贵司 SFTP 主目录，可立即下载。
- 若某日某类业务无数据，对应 CSV 可能仅有表头、无数据行。
访问方式：SFTP
合作商连接 Adopay 提供的 SFTP 服务器下载日报。
开通前需提供
| 信息 | 说明 |
|---|---|
| IP 白名单 | 贵司出口公网 IP（支持 CIDR，如 1.2.3.4 或 1.2.3.0/24） |
| SSH 公钥 | OpenSSH 格式（可用 ssh-keygen、PuTTYgen 等生成） |
开通后，我方将提供
| 信息 | 说明 |
|---|---|
| Host | 如 sftp.domain.com（以开通通知为准） |
| Port | 如 2222（以开通通知为准） |
| Username | 为贵司分配的 SFTP 用户名 |
| Password | 系统生成的复杂密码，发送至合作商资料邮箱；也可使用已登记公钥登录 |
连接示例
bash
sftp -P 2222 <username>@sftp.domain.com登录成功后，当前目录即为贵司报表根目录（chroot），可直接 ls / get 下载文件。
权限说明
- 目录权限为只读下载（list / download），不可上传、删除或改写服务器上的文件。
- 请妥善保管账号与密码；需要重置密码时请联系对接同学，新密码将再次发送至合作商资料邮箱。
文件命名规范
格式：
text
{商户号}_{日期}_{报表类型}.csv| 段 | 含义 | 示例 |
|---|---|---|
| 商户号 | 平台商户编号 mid | 1003 |
| 日期 | 报表所属业务日，YYYY-MM-DD | 2026-08-09 |
| 报表类型 | 见下表 | payin_orders |
| 报表类型 | 完整文件名示例 |
|---|---|
| 代收订单 | 1003_2026-08-09_payin_orders.csv |
| 代付订单 | 1003_2026-08-09_payout_orders.csv |
| 提现订单 | 1003_2026-08-09_withdrawal_orders.csv |
| 资金流水 | 1003_2026-08-09_bills.csv |
| 商户日统计 | 1003_2026-08-09_mch_static.csv |
| MED 投诉 | 1003_2026-08-09_meds.csv |
| 代收退款 | 1003_2026-08-09_ordeRefund.csv |
| 代付退款 | 1003_2026-08-09_payoutRefund.csv |
示意（登录后 ls）：
text
1003_2026-08-06_bills.csv
1003_2026-08-06_mch_static.csv
1003_2026-08-06_meds.csv
1003_2026-08-06_ordeRefund.csv
1003_2026-08-06_payin_orders.csv
1003_2026-08-06_payoutRefund.csv
1003_2026-08-06_payout_orders.csv
1003_2026-08-06_withdrawal_orders.csv
1003_2026-08-07_bills.csv
...订单状态说明
代收 / 代付 / 提现明细中的「状态」字段取值：
| 值 | 说明 |
|---|---|
PENDING | 处理中 |
SUCCESS | 成功 |
FAILED | 失败 |
REFUND | 已退款（如适用） |
代收退款 / 代付退款明细中的「状态」字段取值：
| 值 | 说明 |
|---|---|
PENDING | 处理中 / 待操作 |
SUCCESS | 成功 / 已处理 |
FAILED | 失败（仅代收退款） |
报表字段说明
1. 代收订单（payin_orders）
按订单创建时间落在报表日内的代收明细。CSV 表头为中文。
| 表头（中文） | 字段含义 |
|---|---|
| 平台订单号 | Adopay 平台代收订单号 |
| 商户订单号 | 商户侧订单号，对应 API 字段 merchantOrderNo。 |
| 银行流水 | 银行/渠道侧流水号（如有） |
| PIX交易标识 | Pix 端到端交易 ID（end-to-end），用于与巴西央行清算系统对齐 |
| 金额 | 下单金额 |
| 币种 | 订单币种，如 BRL |
| 手续费 | 商户手续费 |
| 实际支付金额 | 用户实际支付金额 |
| 预计结算金额 | 预计结算给商户的金额 |
| 下单时间 | 订单创建时间（Y-m-d H:i:s） |
| 处理时间 | 终态时间；未完成可为空 |
| 清算时间 | 清算完成时间，用于确定订单所属对账日期 |
| 支付方式编码 | 支付方式编码 |
| 支付方式名称 | 支付方式名称 |
| 客户姓名 | 付款人姓名 |
| 状态 | 见「订单状态说明」 |
| 回调 | 是否已回调合作商（展示值以导出为准） |
| 收款备注 | 收款备注 / 产品信息 |
| 透传数据 | 合作商下单时传入的透传字段（attach），原样返回 |
| 错误 | 失败时的错误信息（如有） |
2. 代付订单（payout_orders）
按订单创建时间落在报表日内的代付明细。
| 表头（中文） | 字段含义 |
|---|---|
| 平台订单号 | Adopay 平台代付订单号 |
| 商户订单号 | 商户侧订单号，对应 API 字段 merchantOrderNo。 |
| 银行流水 | 银行/渠道侧流水号（如有） |
| 金额 | 代付金额 |
| 币种 | 订单币种，如 BRL |
| 手续费 | 商户手续费 |
| 结算金额 | 实际结算/扣款相关金额 |
| 下单时间 | 订单创建时间 |
| 付款时间 | 付款完成时间；未完成可为空 |
| 清算时间 | 清算完成时间，用于确定订单所属对账日期 |
| 转账备注 | 转账备注 / 产品信息 |
| 透传数据 | 合作商下单时传入的透传字段（attach），原样返回 |
| 支付方式编码 | 支付方式编码 |
| 支付方式名称 | 支付方式名称 |
| 账户 | 收款账户（可能脱敏） |
| 客户姓名 | 收款人姓名 |
| 状态 | 见「订单状态说明」 |
| 回调 | 是否已回调合作商 |
| 错误 | 失败时的错误信息（如有） |
3. 提现订单（withdrawal_orders）
按订单创建时间落在报表日内的提现明细。
| 表头（中文） | 字段含义 |
|---|---|
| 平台订单号 | Adopay 平台提现订单号 |
| 银行流水 | 银行/渠道侧流水号（如有） |
| 汇率 | 提现汇率（如适用） |
| 金额 | 提现金额 |
| 手续费 | 手续费 |
| 结算金额 | 结算金额 |
| 下单时间 | 订单创建时间 |
| 付款时间 | 完成时间；未完成可为空 |
| 方式 | 提现方式编码 |
| 账户 | 收款账户 |
| 客户姓名 | 收款人姓名 |
| 状态 | 见「订单状态说明」 |
4. 资金流水（bills）
按流水发生时间落在报表日内的余额变动记录。
| 表头（中文） | 字段含义 |
|---|---|
| 交易流水号 | 资金变动流水号 |
| 平台订单号 | 关联的平台订单号（如有） |
| 商户订单号 | 关联的商户订单号（如有） |
| 原金额 | 变动前余额 |
| 金额 | 本次变动金额 |
| 手续费 | 关联手续费金额（如有；部分场景合并展示） |
| 变动后金额 | 变动后余额 |
| 时间 | 流水发生时间（Y-m-d H:i:s） |
| 类型 | 变动类型，常见取值见下表 |
资金流水「类型」常见取值：
| 类型文案 | 说明 |
|---|---|
| 代收入账 | 代收成功入账 |
| 代收手续费 | 代收手续费扣除 |
| 代收结算 | 代收待结算解冻入可用余额 |
| 扣除代付结算手续费 | 代付手续费 |
| 代付驳回 | 代付失败/驳回退回 |
| 提现/转账/结算 | 提现、转账、结算出账 |
| 提款驳回 | 提现驳回退回 |
| 代收退款 / 代付退款 / 提款退款 | 各类退款 |
| 余额增加(手动) / 余额减少(手动) | 人工调账 |
| 冻结 / 解冻 | 余额冻结与解冻 |
| 其他 | 以文件内实际文案为准 |
5. 商户日统计（mch_static）
报表日当日的汇总快照（含与前一日对比的环比字段）。
| 表头（中文） | 字段含义 |
|---|---|
| 日期 | 统计日期 YYYY-MM-DD |
| 商户编号 | 商户 ID |
| 商户名 | 商户名称 |
| 余额 | 当日余额快照 |
| 待结算余额 | 待结算余额 |
| 冻结余额 | 冻结余额 |
| 代收订单数 | 代收下单笔数 |
| 代收成功数 | 代收成功笔数 |
| 代收总金额 | 代收下单总金额 |
| 代收成功金额 | 代收成功金额 |
| 代收失败数 | 代收失败笔数 |
| 代收失败金额 | 代收失败金额 |
| 代付订单数 | 代付下单笔数 |
| 代付成功数 | 代付成功笔数 |
| 代付总金额 | 代付下单总金额 |
| 代付成功金额 | 代付成功金额 |
| 代付失败数 | 代付失败笔数 |
| 代付失败金额 | 代付失败金额 |
| 提现订单数 | 提现下单笔数 |
| 提现成功数 | 提现成功笔数 |
| 提现总金额 | 提现下单总金额 |
| 提现成功金额 | 提现成功金额 |
| 提现失败数 | 提现失败笔数 |
| 提现失败金额 | 提现失败金额 |
| 代收手续费 | 代收手续费合计 |
| 代付手续费 | 代付手续费合计 |
| 提现手续费 | 提现手续费合计 |
| 前日代收订单数 | 前一日代收订单数 |
| 前日代付订单数 | 前一日代付订单数 |
| 代收环比 | 相对前日代收笔数增长率；无法计算时可能为 - |
| 代付环比 | 相对前日代付笔数增长率；无法计算时可能为 - |
6. MED 投诉（meds）
按投诉记录创建时间落在报表日内的 PIX MED 明细。CSV 表头为中文。
| 表头（中文） | 字段含义 |
|---|---|
| 平台订单号 | Adopay 平台代收订单号 |
| 商户订单号 | 商户侧订单号，对应 API 字段 merchantOrderNo。 |
| 投诉类型 | MED 投诉类型原文，常见取值见下表 |
| 状态 | MED 状态原文，常见取值见下表 |
| 金额 | 投诉金额 |
| 用户CPF | 投诉用户文档号 |
| 分析结果 | 分析结果原文：ACCEPTED / REJECTED / PENDING |
| 用户姓名 | 投诉用户姓名 |
| PIX交易标识 | PIX end-to-end ID |
| 违规报告ID | 违规报告 ID |
| 截止时间 | 处理截止时间（Y-m-d H:i:s）；无则可为空 |
| 订单创建时间 | 原代收订单创建时间 |
| 创建时间 | MED 记录创建时间 |
MED「投诉类型」常见取值：
| 值 | 说明 |
|---|---|
SCAM_FRAUD | 诈骗 / 欺诈 |
UNAUTHORIZED_TRANSACTION | 未授权交易 |
COERCIVE_CRIME | 胁迫犯罪 |
FRAUDULENT_ACCESS_AND_AUTHORIZATION | 欺诈性访问与授权 |
OTHER | 其他 |
UNKNOWN | 未知 |
MED「状态」常见取值：
| 值 | 说明 |
|---|---|
WAITING | 待处理 |
EVIDENCE_REQUIRED | 待补充资料 |
UNDER_REVIEW | 平台审核中 |
ACCEPTED_BY_USER / ACCEPTED_BY_PSP | 合作商已提交同意退款（预留，正常不出现）/ 审核成立 |
REJECTED_BY_USER / REJECTED_BY_PSP | 合作商已提交异议（预留，正常不出现）/ 审核不成立 |
CANCELLED_BY_USER / CANCELLED_BY_PSP | 用户撤销 / 平台撤销 |
CLOSED | 已结案 |
7. 代收退款（ordeRefund）
按退款记录创建时间落在报表日内的代收退款明细。
| 表头（中文） | 字段含义 |
|---|---|
| 平台订单号 | Adopay 平台代收订单号 |
| 商户退款单号 | 合作商提交的退款单号 |
| 退款E2E | 退款 PIX E2E |
| 原支付E2E | 原支付 PIX E2E |
| 原支付金额 | 原代收金额 |
| 本次退款金额 | 本笔退款金额 |
| 累计退款金额 | 该订单累计退款金额 |
| 手续费 | 退款手续费 |
| 退款原因 | 退款原因 |
| 状态 | 见上文退款状态说明 |
| 完成时间 | 退款完成时间；未完成可为空 |
| 创建时间 | 退款记录创建时间 |
8. 代付退款（payoutRefund）
按退款记录创建时间落在报表日内的代付退款明细。
| 表头（中文） | 字段含义 |
|---|---|
| 平台订单号 | Adopay 平台代付订单号 |
| 商户订单号 | 商户侧订单号，对应 API 字段 merchantOrderNo。 |
| 银行流水 | 银行/渠道侧流水号（如有） |
| 原金额 | 原代付金额 |
| 退款金额 | 本笔退款金额 |
| 操作时间 | 退款操作时间；未操作可为空 |
| 状态 | 见上文退款状态说明 |
| 创建时间 | 退款记录创建时间 |
对账建议
- 使用商户订单号（代收/代付）与贵司系统订单对齐。
- 以状态 =
SUCCESS的成功金额与资金流水中的入账/出账交叉核对。 - 日终可用
mch_static的成功金额、手续费与明细汇总交叉验证。 - 时区以巴西自然日为准；跨日边界订单以导出「下单时间 / 流水时间」落入的报表日为准。
联系我们
SFTP 开通、IP 白名单变更、公钥更新、密码重置等问题，请联系您的客户成功 / 技术对接同学。