部分売上が発生した支払いは、KOMOJU管理画面・レポート・新バージョンのAPIで「全額売上+部分返金」ではなく単一の「部分売上」として表示されます。
表示仕様の対象範囲
本仕様は、以下の4つの画面・ファイル・APIに適用されます。
- ①取引詳細画面
- ②取引一覧ファイル
- ③精算レポートファイル
- ④API(バージョンにより表示形式が異なります)
①取引詳細画面
部分売上が適用された支払いは、KOMOJU管理画面の取引詳細画面で「部分返金あり」ではなく「部分入金」というステータスで表示されます。
取引詳細画面には、以下の2つの項目が表示されます。
- 合計承認金額:オーソリ(仮売上)時点の金額
- 確定金額:実際に部分売上を行った金額
例:30,000円のオーソリ後に25,000円を部分売上した場合の表示
②取引一覧ファイル
KOMOJU管理画面の「取引」ページからダウンロードできるファイルには、「確定金額」項目が含まれます。
- 金額:オーソリ金額が記載されます。
- 確定金額:部分売上金額が記載されます。
部分売上額は「Amount refunded cents」項目には記載されません。部分売上に関する金額は「確定金額」項目のみをご参照ください。
例:30,000円のオーソリ後に25,000円を部分売上した場合の表示
③精算レポートファイル
KOMOJU管理画面の「精算」>「レポート」からダウンロードできるファイルでは、部分売上が発生した取引は1行にまとめられ、売上金額のみが表示されます。
④API
KOMOJU APIをご利用の場合、部分売上の表示形式はAPIバージョンによって異なります。
| APIバージョン | 部分売上の表示形式 |
|---|---|
| v2024-07-15(サポート終了) | 「全額売上+部分返金」として表示されます。 |
| v2025-01-28 | 部分売上額は新しい「captures」項目に表示されます。 |
APIバージョンについて
v2024-07-15は2026年2月をもってサポートを終了しています。まだv2024-07-15をご利用の場合は、新バージョン(v2025-01-28)へ速やかに移行してください。
移行の際は、変更履歴で全ての変更内容をご確認のうえ行ってください。