> ## 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 は Reconciliation 用に取引レポートと Settlement レポートを提供します。このページでは、各レポートの定義、取得方法、Reconciliation での利用方法を説明します。

> すべてのレポートファイルは UTF-8 エンコードの CSV（Comma-Separated Values）形式です。
>
> 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 Product</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 Product</li></ul></td></tr><tr><td>Forex Currency Pair</td><td>任意<br />String (16)</td><td>外貨 Settlement プロセスの currency pair は、2 つの通貨をスラッシュで区切り、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
```