Markdownをコピー
SFTP取引情報配信 概要
はじめに
PGマルチペイメントサービスの取引情報ファイルを日次/月次でSFTPサーバに配信する機能について説明します。
オプション契約が必要です
本機能を利用するには、取引情報配信およびSFTPサーバのオプション契約が必要です。
SFTPの申込についてはこちらを参照してください。
機能概要
- 管理画面から配信条件(対象取引、配信周期)を設定できます。
- ショップおよびサイトで本機能を利用できます。
※サイト管理画面にて設定した場合は、配下の全ショップの取引が配信対象となります。 - 取引情報は、日次もしくは月次単位で配信します。
※払込票のみ当日を指定可能です。 - 取引情報は、弊社SFTPサーバの加盟店様アカウントに配置します。
ファイル仕様
ファイル配信タイミング
| 配信周期 | 説明 |
|---|---|
| 日次 | 前日分の取引情報ファイルを配置します。 |
| 月次 | 前月分の取引情報ファイルを毎月3日18時までに配置します。 |
| 当日 | (払込票のみ指定可能)当日分の取引情報ファイルを19時までに配置します。 |
※ 取引情報ファイルのSFTPサーバへの配置タイミングは、ログデータ量に応じて前後します。
ファイル配信方式
SFTPを用いてファイル授受を行います。
弊社SFTPサーバの所定のフォルダに配置した取引情報ファイルを取得してください。
備考
SFTPサーバへの接続方法についてはこちらを参照してください。
- ファイルはショップ/サイト毎に出力されます。
- 加盟店様のSFTPアカウントのホームディレクトリに配置します。
- ZIP圧縮して配置します。
- 配置完了時に、ファイル配置完了を示すOKファイルを配置します。OKファイルが配置されてから、取引情報ファイルを取得してください。
- 配信対象のデータが0件の場合も、ヘッダ行のみのファイルを配置します。
- SFTPサーバに配置された取引情報ファイルは、加盟店様でダウンロード完了後にSFTPサーバから削除してください。
ファイル命名規則
- 圧縮前
[ショップID or サイトID]_[決済種別]_[条件No.]_[周期]_[対象年月日].csv
- ZIP圧縮後
[ショップID or サイトID]_[決済種別]_[条件No.]_[周期]_[対象年月日].zip
- okファイル(0バイトファイル)
[ショップID or サイトID]_[決済種別]_[条件No.]_[周期]_[対象年月日].zip.ok
例:ショップID
0009999099999、2024年12月31日にファイルを作成
0009999099999_multi_01_d_20241231.zip
0009999099999_multi_01_d_20241231.zip.ok
| 項目 | 説明 |
|---|---|
| ショップID or サイトID | 対象のショップID or サイトID |
| 決済種別 | multi:マルチ(全決済)credit:クレジットカードvirtualaccount:バーチャル口座paymentvaucher:払込票 |
| 条件No. | 管理画面で設定した条件No.(01 or 02) |
| 周期 | d:日次m:月次t:当日 |
| 対象年月日 | 出力対象の年月日 日次の場合: yyyymmdd月次の場合: yyyymm |
ファイルフォーマット
ファイルは、「可変長カンマ区切りCSV」形式で出力します。
- 区切り文字:,(カンマ)
- 文字コード:Shift-JIS
- 改行コード:LF
CSVファイルの項目については、各決済手段のページを参照してください。