Skip to main content

​
概述

Waffo 提供交易和 Settlement 报表用于 Reconciliation。本页说明各类报表的定义，以及如何获取和使用这些报表完成 Reconciliation。
所有报表文件均为 CSV（Comma-Separated Values）格式，并使用 UTF-8 编码。 SFTP server 上超过 7 天的 Reconciliation reports 可能会被删除；你仍可从 Merchant Portal 下载历史报表。

​
开通 SFTP 访问

如需通过 SFTP 获取 Reconciliation reports，请联系 Waffo 技术支持团队开通访问权限。提交申请前，请准备：
  • 用于接收 SFTP 账号信息和后续通知的邮箱。
  • 用于访问 SFTP server 的公网 IP 地址或 IP 段。
Waffo 技术支持团队会根据这些信息为你配置访问权限，并在配置完成后提供 SFTP 连接信息。权限开通后，你可以按下文各报表的 SFTP 路径下载对应文件。

​
Transaction Details Report

Transaction Details Report 包含 T 日所有交易的明细记录。 该报表会在 T+1 日生成。如果 T 日没有交易，系统会生成一个仅包含字段名表头的空文件。 获取方式
  • 从 Merchant Portal 查询。
  • 通过 SFTP Server\transactions\\{transaction date}\ 下载
  • 文件名：transaction_details_{merchant id}_{transaction date}.csv
    • merchant id：Waffo 分配的唯一标识，用于识别商户。
    • transaction date：交易处理日期，格式为 YYYYMMDD，时区为 UTC+8。
字段
字段类型描述
Merchant Id必填
String (64)		Waffo 分配的唯一标识，用于识别商户。
Sub Merchant Id可选
String (64)		Waffo 分配的唯一标识，用于识别直接向用户提供服务或商品的二级商户。
Order Id必填
String (32)		Waffo 分配的唯一标识，用于识别交易或 Chargeback。
  • 当 ‘Transaction Type’ 为 PAYMENT 时，表示支付交易 ID。
  • 当 ‘Transaction Type’ 为 REFUND 时，表示退款交易 ID。
  • 当 ‘Transaction Type’ 为 CHARGEBACK 时，表示 Chargeback ID。
Merchant Order Id可选
String (32)		商户分配的唯一标识，用于识别交易。
Payment Request Id可选
String (32)		商户分配的唯一标识，用于识别交易支付请求。
Original Order Id可选
String (32)		原交易的唯一标识。
  • 当 ‘Transaction Type’ 为 PAYMENT 时，该字段为空。
  • 当 ‘Transaction Type’ 为 REFUND 或 CHARGEBACK 时，表示原支付交易 ID。
Order Amount必填
String (24) 		对应币种下的交易金额。
Order Currency必填
String (3)		交易金额的币种，使用 ISO 4217 定义的 3 位币种代码。
Transaction Type必填
String (32)		交易类型。
  • PAYMENT：表示支付交易。
  • REFUND：表示退款交易。
  • CHARGEBACK：表示 Chargeback。
Payment Method必填
String (32)		处理支付所用的 payment method。请参考 API 规范。
Payment Option可选
String (32)		Payment option 表示 payment method 下用于处理支付的子方式。例如使用 DANA balance 支付时，Payment option 为 balance。
如果没有 payment option，则为空。
Payment Request Datetime必填
String (32)		Waffo 接收商户支付请求的时间，格式为 YYYY-MM-DD hh:mm:ss，时区为 UTC+8。
Payment Date必填
String (32)		对应交易达到成功状态的日期，格式为 YYYY-MM-DD，时区为 UTC+8。
Payment Time必填
String (32)		对应交易达到成功状态的时间，格式为 hh:mm:ss，时区为 UTC+8。
Order Description可选
String (128)		交易描述。
Product Name必填
String (32)		Waffo 与商户签约的支付产品。
  • ONE_TIME_PAYMENT：One Time Payment 产品
Merchant User Id可选
String (64)		商户分配的唯一标识，用于识别自己的用户。
示例
Text

​
Settlement Details Report

Settlement Details Report 包含一个 Settlement 周期内每笔交易的 Settlement 明细记录。 该报表会在收到 Settlement 银行回单后的次日生成。如果 Settlement date 没有净 Settlement，则不会生成 Settlement Details Report。如果你需要无交易的空报表，请联系技术支持团队进行配置。 获取方式
  • 从 Merchant Portal 查询或下载。
  • 通过 SFTP Server\settlements\\{settlement date}\ 下载
  • 文件名：settlement_details_{merchant id}_{settlement batch id}_{settlement date}_{settlement currency}.csv
    • merchant id：Waffo 分配的唯一标识，用于识别商户。
    • settlement batch id：Waffo 分配的唯一标识，用于识别一个 Settlement 周期内的一笔 Settlement。
    • settlement date：Settlement 文件生成日期，格式为 YYYYMMDD，时区为 UTC+8。
    • settlement currency：Settlement amount 的币种。
字段
字段类型描述
Merchant Id必填
String (64)		Waffo 分配的唯一标识，用于识别商户。
Sub Merchant Id可选
String (64)		Waffo 分配的唯一标识，用于识别直接向用户提供服务或商品的二级商户。
Settlement Batch Id必填
String (64)		Waffo 分配的唯一标识，用于识别一个 Settlement 周期内的一笔 Settlement。
Settlement Date必填
String (16)		Settlement 文件生成日期，格式为 YYYY-MM-DD，时区为 UTC+8。
Order Id必填
String (32)		Waffo 分配的唯一标识，用于识别交易或 Chargeback。
  • 当 ‘Transaction Type’ 为 PAYMENT 时，表示支付交易 ID。
  • 当 ‘Transaction Type’ 为 REFUND 时，表示退款交易 ID。
  • 当 ‘Transaction Type’ 为 CHARGEBACK 时，表示 Chargeback ID。
Merchant Order Id可选
String (32)		商户分配的唯一标识，用于识别交易。
Payment Request Id可选
String (32)		商户分配的唯一标识，用于识别交易支付请求。
  • 当 ‘Transaction Type’ 为 CHARGEBACK 时，该字段为空。
Original Order Id可选
String (32)		原交易的唯一标识。
  • 当 ‘Transaction Type’ 为 PAYMENT 时，该字段为空。
  • 当 ‘Transaction Type’ 为 REFUND 或 CHARGEBACK 时，表示原支付交易 ID。
Order Amount必填
String (24) 		对应币种下的交易金额。
Order Amount (Settlement Currency)必填
String (24) 		Settlement currency 下的交易金额。
Order Currency必填
String (3)		交易金额的币种，使用 ISO 4217 定义的 3 位币种代码。
Transaction Type必填
String (16)		交易类型。
  • PAYMENT：表示支付交易。
  • REFUND：表示退款交易。
  • CHARGEBACK：表示 Chargeback。
Payment Method Type必填
String (32)		处理支付所用的 payment method type。请参考 API 规范。
Payment Method必填
String (32)		处理支付所用的 payment method。请参考 API 规范。
Payment Option可选
String (32)		Payment option 表示 payment method 下用于处理支付的子方式。例如使用 DANA balance 支付时，Payment option 为 balance。
如果没有 payment option，则为空。
Payment Request Datetime必填
String (32)		Waffo 接收商户支付请求的时间，格式为 YYYY-MM-DD hh:mm:ss，时区为 UTC+8。
Payment Date必填
String (32)		对应交易达到成功状态的时间，格式为 YYYY-MM-DD hh:mm:ss，时区为 UTC+8。
Payment Time必填
String (32)		对应交易达到成功状态的时间，格式为 hh:mm:ss，时区为 UTC+8。
Product Name必填
String (32)		Waffo 与商户签约的支付产品。
  • ONE_TIME_PAYMENT：One Time Payment 产品
Forex Currency Pair可选
String (16)		外汇 Settlement 过程中的 currency pair 使用斜杠分隔两个币种，并采用 ISO 4217 定义的 3 位币种代码表示（例如 USD/HKD）。具体 currency pair 按以下规则确定：
  • 如果 Settlement Currency 不等于 Order Currency，则表示为 Settlement Currency/Order Currency。
  • 如果 Settlement Currency 不等于 Fee Currency（且上一条件不适用），则表示为 Settlement Currency/Fee Currency。

如果以上条件均不适用（即不涉及外汇），则为空。
Forex Rate可选
String (24) 		Settlement 过程中 Forex Currency Pair 对应的外汇汇率，由外汇合作方提供。
当 Forex Currency Pair 为空时，该字段为空。
Fee Amount必填
String (24) 		Waffo 收取的处理费金额。
Fee Amount (Settlement Currency)必填
String (24) 		Waffo 收取的处理费金额，以 Settlement currency 表示。
Fee Currency必填
String (3)		费用金额的币种，使用 ISO 4217 定义的 3 位币种代码。
VAT Amount可选
String (24) 		该交易适用时的增值税金额。
VAT Amount (Settlement Currency)可选
String (24) 		该交易适用时的增值税金额，以 Settlement currency 表示。
VAT Currency可选
String (3)		增值税金额的币种，使用 ISO 4217 定义的 3 位币种代码。
WHT Amount可选
String (24) 		该交易适用时的预提税金额。
WHT Amount (Settlement Currency)可选
String (24) 		该交易适用时的预提税金额，以 Settlement currency 表示。
WHT Currency可选
String (3)		预提税金额的币种，使用 ISO 4217 定义的 3 位币种代码。
Settlement Amount必填
String (24) 		对应币种下的净 Settlement amount。
Settlement Currency必填
String (3)		Settlement amount 的币种，使用 ISO 4217 定义的 3 位币种代码。
示例
Text

​
Settlement Summary Report

Settlement Summary Report 包含一个 Settlement 周期内，Settlement currency 和净 Settlement amount 相同的所有交易汇总。 该报表会在收到 Settlement 银行回单后的次日生成。如果 Settlement date 没有净 Settlement，则不会生成 Settlement Summary Report。如果你需要无交易的空报表，请联系技术支持团队进行配置。 获取方式
  • 从 Merchant Portal 查询或下载。
  • 通过 SFTP Server\settlements\\{settlement date}\ 下载
  • 文件名：settlement_summary_{merchant id}_{settlement batch id}_{settlement date}_{settlement currency}.csv
    • merchant id：Waffo 分配的唯一标识，用于识别商户。
    • settlement batch id：Waffo 分配的唯一标识，用于识别一个 Settlement 周期内的一笔 Settlement。
    • settlement date：Settlement 文件生成日期，格式为 YYYYMMDD，时区为 UTC+8。
    • settlement currency：Settlement amount 的币种。
字段
字段类型描述
Merchant Id必填
String (64)		Waffo 分配的唯一标识，用于识别商户。
Settlement Batch Id必填
String (64)		Waffo 分配的唯一标识，用于识别一个 Settlement 周期内的一笔 Settlement。
Settlement Date必填
String (16)		Settlement 文件生成日期，格式为 YYYY-MM-DD，时区为 UTC+8。
Transaction Type必填
String (32)		交易类型。
  • TOTAL：表示所有交易。
  • PAYMENT：表示支付交易。
  • REFUND：表示退款交易。
  • CHARGEBACK：表示退款 Chargeback。
Transaction Count必填
String (16)		指定交易类型的交易总数。
Fee Amount (Settlement Currency)必填
String (24) 		Waffo 收取的处理费金额，以 Settlement currency 表示。
VAT Amount (Settlement Currency)可选
String (24) 		该交易适用时的增值税金额，以 Settlement currency 表示。
WHT Amount (Settlement Currency)可选
String (24) 		该交易适用时的预提税金额，以 Settlement currency 表示。
Settlement Amount必填
String (24) 		指定交易类型下所有交易的净 Settlement 总金额。
Settlement Currency必填
String (3)		Settlement amount 的币种，使用 ISO 4217 定义的 3 位币种代码。
示例
Text