> ## Documentation Index
> Fetch the complete documentation index at: https://waffo.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Reconciliation reports

> Waffo Reconciliation reports 的定义、CSV 字段、文件命名和示例。

## 概述

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。

**字段**

<table><colgroup><col /><col /><col /></colgroup><thead><tr><th><b>字段</b></th><th>类型</th><th>描述</th></tr></thead><tbody><tr><td>Merchant Id</td><td>必填 <br />String (64)</td><td>Waffo 分配的唯一标识，用于识别商户。</td></tr><tr><td>Sub Merchant Id</td><td>可选 <br />String (64)</td><td>Waffo 分配的唯一标识，用于识别直接向用户提供服务或商品的二级商户。</td></tr><tr><td>Order Id</td><td>必填 <br />String (32)</td><td>Waffo 分配的唯一标识，用于识别交易或 Chargeback。<ul><li>当 'Transaction Type' 为 <code>PAYMENT</code> 时，表示支付交易 ID。</li><li>当 'Transaction Type' 为 <code>REFUND</code> 时，表示退款交易 ID。</li><li>当 'Transaction Type' 为 <code>CHARGEBACK</code> 时，表示 Chargeback ID。</li></ul></td></tr><tr><td>Merchant Order Id</td><td>可选<br />String (32)</td><td>商户分配的唯一标识，用于识别交易。</td></tr><tr><td>Payment Request Id</td><td>可选<br />String (32)</td><td>商户分配的唯一标识，用于识别交易支付请求。</td></tr><tr><td>Original Order Id</td><td>可选<br />String (32)</td><td>原交易的唯一标识。<ul><li>当 'Transaction Type'<em> </em>为 <code>PAYMENT</code> 时，该字段为空。</li><li>当 'Transaction Type'<em> </em>为 <code>REFUND</code> 或 <code>CHARGEBACK</code> 时，表示原支付交易 ID。</li></ul></td></tr><tr><td>Order Amount</td><td>必填<br />String (24) </td><td>对应币种下的交易金额。</td></tr><tr><td>Order Currency</td><td>必填<br />String (3)</td><td>交易金额的币种，使用 ISO 4217 定义的 3 位币种代码。</td></tr><tr><td>Transaction Type</td><td>必填<br />String (32)</td><td>交易类型。<ul><li><code>PAYMENT</code>：表示支付交易。</li><li><code>REFUND</code>：表示退款交易。</li><li><code>CHARGEBACK</code>：表示 Chargeback。</li></ul></td></tr><tr><td>Payment Method</td><td>必填<br />String (32)</td><td>处理支付所用的 payment method。请参考 API 规范。</td></tr><tr><td>Payment Option</td><td>可选<br />String (32)</td><td>Payment option 表示 payment method 下用于处理支付的子方式。例如使用 DANA balance 支付时，Payment option 为 balance。<br />如果没有 payment option，则为空。</td></tr><tr><td>Payment Request Datetime</td><td>必填<br />String (32)</td><td>Waffo 接收商户支付请求的时间，格式为 YYYY-MM-DD hh:mm:ss，时区为 UTC+8。</td></tr><tr><td>Payment Date</td><td>必填<br />String (32)</td><td>对应交易达到成功状态的日期，格式为 YYYY-MM-DD，时区为 UTC+8。</td></tr><tr><td>Payment Time</td><td>必填<br />String (32)</td><td>对应交易达到成功状态的时间，格式为 hh:mm:ss，时区为 UTC+8。</td></tr><tr><td>Order Description</td><td>可选<br />String (128)</td><td>交易描述。</td></tr><tr><td>Product Name</td><td>必填<br />String (32)</td><td>Waffo 与商户签约的支付产品。<ul><li><code>ONE\_TIME\_PAYMENT</code>：One Time Payment 产品</li></ul></td></tr><tr><td>Merchant User Id</td><td>可选<br />String (64)</td><td>商户分配的唯一标识，用于识别自己的用户。</td></tr></tbody></table>

**示例**

```Plain Text theme={null}
Merchant Id,Sub Merchant Id,Order Id,Merchant Order Id,Payment Request Id,Original Order Id,Order Amount,Order Currency,Transaction Type,Payment Method,Payment Option,Payment Request Datetime,Payment Date,Payment Time,Order Description,Product Name,Merchant User Id
1000000001,2000000001,A202407310821400761577,MO202407310821400601333,PR2024073108214006013332,,100.00,HKD,PAYMENT,ALIPAY,,2024-08-06 16:22:27,2024-08-06,16:22:28,Order Description1,ONE_TIME_PAYMENT,userId12345678
1000000001,2000000001,A202407310826263631579,MO202407310821400601333,PR2024073108214006013331,A202407310821400761577,10.00,HKD,REFUND,ALIPAY,,2024-08-06 16:22:04,2024-08-06,16:22:05,,ONE_TIME_PAYMENT,userId12345678
```

## 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 的币种。

**字段**

<table><colgroup><col /><col /><col /></colgroup><thead><tr><th><b>字段</b></th><th>类型</th><th>描述</th></tr></thead><tbody><tr><td>Merchant Id</td><td>必填 <br />String (64)</td><td>Waffo 分配的唯一标识，用于识别商户。</td></tr><tr><td>Sub Merchant Id</td><td>可选 <br />String (64)</td><td>Waffo 分配的唯一标识，用于识别直接向用户提供服务或商品的二级商户。</td></tr><tr><td>Settlement Batch Id</td><td>必填<br />String (64)</td><td>Waffo 分配的唯一标识，用于识别一个 Settlement 周期内的一笔 Settlement。</td></tr><tr><td>Settlement Date</td><td>必填<br />String (16)</td><td>Settlement 文件生成日期，格式为 YYYY-MM-DD，时区为 UTC+8。</td></tr><tr><td>Order Id</td><td>必填 <br />String (32)</td><td>Waffo 分配的唯一标识，用于识别交易或 Chargeback。<ul><li>当 'Transaction Type' 为 <code>PAYMENT</code> 时，表示支付交易 ID。</li><li>当 'Transaction Type' 为 <code>REFUND</code> 时，表示退款交易 ID。</li><li>当 'Transaction Type' 为 <code>CHARGEBACK</code> 时，表示 Chargeback ID。</li></ul></td></tr><tr><td>Merchant Order Id</td><td>可选<br />String (32)</td><td>商户分配的唯一标识，用于识别交易。</td></tr><tr><td>Payment Request Id</td><td>可选<br />String (32)</td><td>商户分配的唯一标识，用于识别交易支付请求。<ul><li>当 'Transaction Type' 为 <code>CHARGEBACK</code> 时，该字段为空。</li></ul></td></tr><tr><td>Original Order Id</td><td>可选<br />String (32)</td><td>原交易的唯一标识。<ul><li>当 'Transaction Type'<em> </em>为 <code>PAYMENT</code> 时，该字段为空。</li><li>当 'Transaction Type'<em> </em>为 <code>REFUND</code> 或 <code>CHARGEBACK</code> 时，表示原支付交易 ID。</li></ul></td></tr><tr><td>Order Amount</td><td>必填<br />String (24) </td><td>对应币种下的交易金额。</td></tr><tr><td>Order Amount (Settlement Currency)</td><td>必填<br />String (24) </td><td>Settlement currency 下的交易金额。</td></tr><tr><td>Order Currency</td><td>必填<br />String (3)</td><td>交易金额的币种，使用 ISO 4217 定义的 3 位币种代码。</td></tr><tr><td>Transaction Type</td><td>必填<br />String (16)</td><td>交易类型。<ul><li><code>PAYMENT</code>：表示支付交易。</li><li><code>REFUND</code>：表示退款交易。</li><li><code>CHARGEBACK</code>：表示 Chargeback。</li></ul></td></tr><tr><td>Payment Method Type</td><td>必填<br />String (32)</td><td>处理支付所用的 payment method type。请参考 API 规范。</td></tr><tr><td>Payment Method</td><td>必填<br />String (32)</td><td>处理支付所用的 payment method。请参考 API 规范。</td></tr><tr><td>Payment Option</td><td>可选<br />String (32)</td><td>Payment option 表示 payment method 下用于处理支付的子方式。例如使用 DANA balance 支付时，Payment option 为 balance。<br />如果没有 payment option，则为空。</td></tr><tr><td>Payment Request Datetime</td><td>必填<br />String (32)</td><td>Waffo 接收商户支付请求的时间，格式为 YYYY-MM-DD hh:mm:ss，时区为 UTC+8。</td></tr><tr><td>Payment Date</td><td>必填<br />String (32)</td><td>对应交易达到成功状态的时间，格式为 YYYY-MM-DD hh:mm:ss，时区为 UTC+8。</td></tr><tr><td>Payment Time</td><td>必填<br />String (32)</td><td>对应交易达到成功状态的时间，格式为 hh:mm:ss，时区为 UTC+8。</td></tr><tr><td>Product Name</td><td>必填<br />String (32)</td><td>Waffo 与商户签约的支付产品。<ul><li><code>ONE\_TIME\_PAYMENT</code>：One Time Payment 产品</li></ul></td></tr><tr><td>Forex Currency Pair</td><td>可选<br />String (16)</td><td>外汇 Settlement 过程中的 currency pair 使用斜杠分隔两个币种，并采用 ISO 4217 定义的 3 位币种代码表示（例如 USD/HKD）。具体 currency pair 按以下规则确定：<ul><li>如果 Settlement Currency 不等于 Order Currency，则表示为 <code>Settlement Currency/Order Currency</code>。</li><li>如果 Settlement Currency 不等于 Fee Currency（且上一条件不适用），则表示为 <code>Settlement Currency/Fee Currency</code>。</li></ul><br />如果以上条件均不适用（即不涉及外汇），则为空。</td></tr><tr><td>Forex Rate</td><td>可选<br />String (24) </td><td>Settlement 过程中 Forex Currency Pair 对应的外汇汇率，由外汇合作方提供。<br />当 Forex Currency Pair 为空时，该字段为空。</td></tr><tr><td>Fee Amount</td><td>必填<br />String (24) </td><td>Waffo 收取的处理费金额。</td></tr><tr><td>Fee Amount (Settlement Currency)</td><td>必填<br />String (24) </td><td>Waffo 收取的处理费金额，以 Settlement currency 表示。</td></tr><tr><td>Fee Currency</td><td>必填<br />String (3)</td><td>费用金额的币种，使用 ISO 4217 定义的 3 位币种代码。</td></tr><tr><td>VAT Amount</td><td>可选<br />String (24) </td><td>该交易适用时的增值税金额。</td></tr><tr><td>VAT Amount (Settlement Currency)</td><td>可选<br />String (24) </td><td>该交易适用时的增值税金额，以 Settlement currency 表示。</td></tr><tr><td>VAT Currency</td><td>可选<br />String (3)</td><td>增值税金额的币种，使用 ISO 4217 定义的 3 位币种代码。</td></tr><tr><td>WHT Amount</td><td>可选<br />String (24) </td><td>该交易适用时的预提税金额。</td></tr><tr><td>WHT Amount (Settlement Currency)</td><td>可选<br />String (24) </td><td>该交易适用时的预提税金额，以 Settlement currency 表示。</td></tr><tr><td>WHT Currency</td><td>可选<br />String (3)</td><td>预提税金额的币种，使用 ISO 4217 定义的 3 位币种代码。</td></tr><tr><td>Settlement Amount</td><td>必填<br />String (24) </td><td>对应币种下的净 Settlement amount。</td></tr><tr><td>Settlement Currency</td><td>必填<br />String (3)</td><td>Settlement amount 的币种，使用 ISO 4217 定义的 3 位币种代码。</td></tr></tbody></table>

**示例**

```Plain Text theme={null}
Merchant Id,Sub Merchant Id,Settlement Batch Id,Settlement Date,Order Id,Merchant Order Id,Payment Request Id,Original Order Id,Order Amount,Order Amount (Settlement Currency),Order Currency,Transaction Type,Payment Method Type,Payment Method,Payment Option,Payment Request Datetime,Payment Date,Payment Time,Product Name,Forex Currency Pair,Forex Rate,Fee Amount,Fee Amount (Settlement Currency),Fee Currency,VAT Amount,VAT Amount (Settlement Currency),VAT Currency,WHT Amount,WHT Amount (Settlement Currency),WHT Currency,Settlement Amount,Settlement Currency
1000000001,2000000001,S2024073108214,2020-08-08,A202407310821400761571,MO202407310821400601331,PR2024073108214006013331,,100.00,100.00,USD,PAYMENT,EWALLET,ALIPAY,,2024-08-06 16:21:00,2024-08-06,16:21:00,ONE_TIME_PAYMENT,,,1.00,1.00,USD,,,,,,,99.00,USD
1000000001,2000000001,S2024073108214,2020-08-08,A202407310826263631572,MO202407310821400601332,PR2024073108214006013332,A202407310821400761571,10.00,10.00,USD,REFUND,EWALLET,ALIPAY,,2024-08-06 16:22:00,2024-08-06,16:22:00,ONE_TIME_PAYMENT,,,0.00,0.00,USD,,,,,,,-10.00,USD
1000000001,2000000001,S2024073108214,2020-08-08,A202407310821400761573,MO202407310821400601333,PR2024073108214006013333,,100.00,12.83,HKD,PAYMENT,EWALLET,ALIPAY,,2024-08-06 16:23:00,2024-08-06,16:23:00,ONE_TIME_PAYMENT,USD/HKD,7.79217921,1.00,0.12,HKD,,,,,,,12.71,USD
1000000001,2000000001,S2024073108214,2020-08-08,A202407310826263631584,MO202407310821400601334,PR2024073108214006013334,A202407310821400761573,10.00,1.28,HKD,REFUND,EWALLET,ALIPAY,,2024-08-06 16:24:00,2024-08-06,16:24:00,ONE_TIME_PAYMENT,USD/HKD,7.79217921,0.00,0.00,HKD,,,,,,,-1.28,USD
```

## 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 的币种。

**字段**

<table><colgroup><col /><col /><col /></colgroup><thead><tr><th><b>字段</b></th><th>类型</th><th>描述</th></tr></thead><tbody><tr><td>Merchant Id</td><td>必填 <br />String (64)</td><td>Waffo 分配的唯一标识，用于识别商户。</td></tr><tr><td>Settlement Batch Id</td><td>必填<br />String (64)</td><td>Waffo 分配的唯一标识，用于识别一个 Settlement 周期内的一笔 Settlement。</td></tr><tr><td>Settlement Date</td><td>必填<br />String (16)</td><td>Settlement 文件生成日期，格式为 YYYY-MM-DD，时区为 UTC+8。</td></tr><tr><td>Transaction Type</td><td>必填<br />String (32)</td><td>交易类型。<ul><li><code>TOTAL</code>：表示所有交易。</li><li><code>PAYMENT</code>：表示支付交易。</li><li><code>REFUND</code>：表示退款交易。</li><li><code>CHARGEBACK</code>：表示退款 Chargeback。</li></ul></td></tr><tr><td>Transaction Count</td><td>必填<br />String (16)</td><td>指定交易类型的交易总数。</td></tr><tr><td>Fee Amount (Settlement Currency)</td><td>必填<br />String (24) </td><td>Waffo 收取的处理费金额，以 Settlement currency 表示。</td></tr><tr><td>VAT Amount (Settlement Currency)</td><td>可选<br />String (24) </td><td>该交易适用时的增值税金额，以 Settlement currency 表示。</td></tr><tr><td>WHT Amount (Settlement Currency)</td><td>可选<br />String (24) </td><td>该交易适用时的预提税金额，以 Settlement currency 表示。</td></tr><tr><td>Settlement Amount</td><td>必填<br />String (24) </td><td>指定交易类型下所有交易的净 Settlement 总金额。</td></tr><tr><td>Settlement Currency</td><td>必填<br />String (3)</td><td>Settlement amount 的币种，使用 ISO 4217 定义的 3 位币种代码。</td></tr></tbody></table>

**示例**

```Plain Text theme={null}
Merchant Id,Settlement Batch Id,Settlement Date,Transaction Type,Transaction Count,Fee Amount (Settlement Currency),VAT Amount (Settlement Currency),WHT Amount (Settlement Currency),Settlement Amount,Settlement Currency
1000000001,S2024073108214,2020-08-08,TOTAL,100,1.12,1.12,,90.42,USD
1000000001,S2024073108214,2020-08-08,PAYMENT,97,1.00,1.12,,111.70,USD
1000000001,S2024073108214,2020-08-08,REFUND,2,,,,-11.28,USD
1000000001,S2024073108214,2020-08-08,CHARGEBACK,1,0.12,,,-10.00,USD
```