Reconciliation reports

概要

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 です。

フィールド

フィールド	タイプ	説明
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 Product
Merchant User Id	任意 String (64)	加盟店が自社ユーザーを識別するために割り当てる一意の識別子です。

例

Text

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 の通貨です。

フィールド

フィールド	タイプ	説明
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 Product
Forex Currency Pair	任意 String (16)	外貨 Settlement プロセスの currency pair は、2 つの通貨をスラッシュで区切り、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

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 の通貨です。

フィールド

フィールド	タイプ	説明
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

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

はじめに

コアコンセプト

インテグレーション

Webhook

SDK

ツールとリファレンス

概要

SFTP アクセスを有効化する

Transaction Details Report

Settlement Details Report

Settlement Summary Report

​概要

​SFTP アクセスを有効化する

​Transaction Details Report

​Settlement Details Report

​Settlement Summary Report

概要

SFTP アクセスを有効化する

Transaction Details Report

Settlement Details Report

Settlement Summary Report