移行パターンC ファイル仕様
概要
移行パターンCは、既存のSFTP一括オーソリ（カード番号版）から移行する際に、従来のファイル形式を維持したまま利用できる互換モードです。
以下の流れでファイル処理が進みます。
- SFTP
- 管理画面
処理の流れ（SFTP）：
- 加盟店様が準備：複数の決済データを CSV/TXT で作成
- ファイルをアップロード：SFTP でアップロードファイルと OK ファイルを送信
- システムが取込検証：ファイル形式の検証と仮登録を実施 → 取込結果ファイルで通知
- 決済を実行：仮登録されたデータを基に実際の決済処理 → 売上結果ファイルで返却
処理の流れ（管理画面）：
- 加盟店様が準備：複数の決済データを CSV/TXT で作成
- ファイルをアップロード：管理画面でアップロードファイルのみ送信
- システムが取込検証：ファイル形式の検証を実施（通知なし）
- 決済を実行：登録されたデータを基に実際の決済処理 → 売上結果ファイルで返却
- PCIDSSに準拠している加盟店様のみ利用できます
- SFTPサーバーを利用する場合は、SFTPファイル連携の流れを参照してください
ファイル形式と仕様
アップロードファイル
SFTPサーバーへアップロードする場合、以下の2つのファイルを配置してください：
- 後述の命名規則により命名された、データファイル
- 配置完了を表す OK ファイル（完了通知ファイル）
格納イメージ：
ホームディレクトリ
├ bulk_c_multi_0000000000001_20211105_01.txt.gz
└ bulk_c_multi_0000000000001_20211105_01.txt.gz.ok
命名規則
- SFTP
- 管理画面
bulk_c_multi_[ショップID]_[処理指定日YYYYMMDD]_[通番].[拡張子]
| 項目 | 説明 | 例 |
|---|---|---|
| モード | ファイルモードを表す識別子 | c_multi（移行パターンC） |
| ショップID | 加盟店様のショップID | shopid0000001 |
| 処理指定日 | 決済を実行する日付（YYYYMMDD） | 20220831 |
| 通番 | 同日の再アップロード時にカウントアップ | 01, 02, ... |
同じ処理指定日に再アップロードする場合、通番を01→02→03...とカウントアップしてください。
ファイル名に制限はありません
ファイル名は任意の名称を指定できます。
拡張子
.txt.gzまたは.csv.gz（SFTP）.txtまたは.csv（管理画面）
SFTP では、.txt または .csvをgzip形式で圧縮します。
管理画面 では、圧縮せずにアップロードしてください。
OK ファイル
- SFTP
- 管理画面
アップロードファイルの送信完了を示すために、アップロードファイル名に.okを付与したファイルを送信します。ファイルの中身は空です。
例：ショップID
0000000000001で2021年11月5日処理指定の場合
bulk_c_multi_0000000000001_20211105_01.txt.gz
bulk_c_multi_0000000000001_20211105_01.txt.gz.ok
OK ファイルは、アップロード処理の完了をシステムに知らせるシグナルです。アップロードファイルと同時に送信してください。
OK ファイルのアップロードは不要です。アップロードファイルのみで処理が開始されます。
ファイル仕様
基本フォーマット
- 区切り文字：
,（カンマ） - 項目の括り：全項目を
"（ダブルクォート）で括る - 改行コード：CRLF推奨（LFでアップロードした場合もCRLFで返却されます）
| No | 項目名 | 桁数 | 必須 | 説明 |
|---|---|---|---|---|
| 1 | フォーマットバージョン | 3 | ✔ | 予約項目001を設定してください。 |
| 2 | ショップID | 13 | ✔ | 加盟店様を識別するID 当サービス契約時に発行される値 |
| 3 | オーダーID | 27 | ✔ | 加盟店様が取引を識別するためのID オーソリ処理にて、指定したオーダーIDが利用されます。 他機能も含め必ずユニークな値にしてください。 半角英数字、 -（ハイフン）が利用可能です。 |
| 4 | 処理区分 | - | 通常は省略してください。 対象取引に対して行う処理の種別 設定する際は CAPTURE（即時売上）のみ設定可能です。 | |
| 5 | 商品コード | 7 | 通常は省略してください。 カード会社との間の契約にて使用する商品コードが決められた場合のみ設定してください。 （省略した際は、 0000990を使用して処理します。） | |
| 6 | 利用金額 | 7 | ✔ | 商品・サービスに対する金額 税送料を指定していない場合は、決済金額です。 税送料を指定している場合は、利用金額＋税送料が決済金額です。 |
| 7 | 税送料 | 7 | 商品とは異なる送料等の金額 税送料が利用金額に含まれる場合、値の設定は不要です。 | |
| 8 | 支払方法 | 1 | ✔ | 1（一括払い）を設定してください。 |
| 9 | 支払回数 | - | ""固定※未使用項目 | |
| 10 | カード種別 | - | ""固定※未使用項目 | |
| 11 | カード番号 | 16 | ✔ | 決済を行うカード番号 |
| 12 | 未使用 | 4 | ""固定 | |
| 13 | 有効期限 | 4 | ✔ | 決済を行うカードの有効期限YYMM形式 |
| 14 | 加盟店自由項目1 | 100 | 加盟店様が自由に使用できる項目 半角英数記号（ ^ ` { | } ~ & < > " ' 除く）と全角文字が使用可能です。桁は全角文字が含まれない場合の上限です。 | |
| 15 | 加盟店自由項目2 | 100 | 同上 | |
| 16 | 加盟店自由項目3 | 100 | 同上 | |
| 17 | 未使用 | - | ""固定 | |
| 18 | 取引ID | 32 | 結果用項目""固定 | |
| 19 | 取引パスワード | 32 | 結果用項目""固定 | |
| 20 | トランザクションID | 28 | 結果用項目""固定 | |
| 21 | 承認番号 | 7 | 結果用項目""固定 | |
| 22 | 仕向先コード | 7 | 結果用項目""固定 | |
| 23 | エラーコード | 3 | 結果用項目""固定 | |
| 24 | エラー詳細コード | 9 | 結果用項目""固定 | |
| 25 | 処理日時 | 14 | 結果用項目""固定 |
必須記号
- ✔：必須
- 空白：省略可能
取込結果ファイル
SFTP でのみ、ファイル取込後の検証結果が結果ファイルで通知されます。
管理画面 からのアップロードでは、ファイル取込結果の通知はありません。
ホームディレクトリからファイルをGETしてください。
取込結果ファイルは、以下の2つのファイルが配置されます：
- 後述の命名規則により命名された、データファイル
- 配置完了を表す OK ファイル（完了通知ファイル）
格納イメージ：
ホームディレクトリ
├ Ibulk_c_multi_0000000000001_20211105_01.txt.gz
└ Ibulk_c_multi_0000000000001_20211105_01.txt.gz.ok
取込結果ファイルの取得が完了したら、原則としてSFTPサーバーから削除してください。
命名規則
I + (アップロードファイル名).[拡張子]
OK ファイル
I + (ファイル名) + .ok
例：
bulk_c_multi_0000000000001_20211105_01.txt.gzをアップロードした場合
Ibulk_c_multi_0000000000001_20211105_01.txt.gz
Ibulk_c_multi_0000000000001_20211105_01.txt.gz.ok
ファイル仕様
基本フォーマット
- 区切り文字：
,（カンマ） - 項目の括り：全項目を
"（ダブルクォート）で括る - 改行コード：CRLF
| No | 項目名 | 桁数 | 説明 |
|---|---|---|---|
| 1 | レコード通番 | 7 | アップロードファイルでの行番号 |
| 2 | エラーコード | 3 | 発生したエラーコード 取込に失敗した場合に設定されます。 |
| 3 | エラー詳細コード | 9 | 発生したエラー詳細コード 取込に失敗した場合に設定されます。 |
売上結果ファイル
ホームディレクトリからファイルをGETしてください。
売上結果ファイルは、以下の2つのファイルが配置されます：
- 後述の命名規則により命名された、データファイル
- 配置完了を表す OK ファイル（完了通知ファイル）
格納イメージ：
ホームディレクトリ
├ Rbulk_c_multi_0000000000001_20211105_01.txt.gz
└ Rbulk_c_multi_0000000000001_20211105_01.txt.gz.ok
売上結果ファイルの取得が完了したら、原則としてSFTPサーバーから削除してください。
命名規則
R + (アップロードファイル名).[拡張子]
OK ファイル
R + (ファイル名) + .ok
※通番は01固定です。
例：
bulk_c_multi_0000000000001_20211105_01.txt.gzをアップロードした場合
Rbulk_c_multi_0000000000001_20211105_01.txt.gz
Rbulk_c_multi_0000000000001_20211105_01.txt.gz.ok
ファイル仕様
基本フォーマット
- 区切り文字：
,（カンマ） - 項目の括り：全項目を
"（ダブルクォート）で括る - 改行コード：CRLF
| No | 項目名 | 桁数 | 説明 |
|---|---|---|---|
| 1 | ショップID | 13 | アップロード時に指定した値 |
| 2 | オーダーID | 27 | アップロード時に指定した値 |
| 3 | 取引状態 | - | 取引の状態UNPROCESSED：決済失敗CAPTURE：決済成功取込エラーの場合はエラーによって以下の結果を返します。 ・入力フォーマットエラーやカードが見つからない場合：空文字または CAPTURE・請求停止対象カードが指定された場合： CAPTURE |
| 4 | 商品コード | 7 | アップロード時に指定した値 |
| 5 | 利用金額 | 7 | アップロード時に指定した値 |
| 6 | 税送料 | 7 | アップロード時に指定した値 空の場合は 0を設定します。 |
| 7 | 支払方法 | 1 | 決済を行う際の支払方法1：一括 |
| 8 | 支払回数 | - | ""固定※未使用項目 |
| 9 | カード種別 | - | ""固定※未使用項目 |
| 10 | カード番号 | 16 | 決済に使用したカード番号 ダウンロードしたユーザーの権限に沿って伏字表記です。 |
| 11 | セキュリティコード | 4 | 伏字（****）固定※未使用項目 |
| 12 | 有効期限 | 4 | 決済に使用したカードの有効期限YYMM形式 |
| 13 | 加盟店自由項目1 | 100 | アップロード時に指定した値 |
| 14 | 加盟店自由項目2 | 100 | アップロード時に指定した値 |
| 15 | 加盟店自由項目3 | 100 | アップロード時に指定した値 |
| 16 | 利用日（YYMMDD） | 6 | 処理指定日が設定されます。 |
| 17 | 取引ID | 32 | 当サービスが取引を識別するためのID |
| 18 | 取引パスワード | 32 | 当サービスが取引を識別するためのパスワード |
| 19 | トランザクションID | 28 | 当サービスホスト機にて付番された決済の処理通番 |
| 20 | 承認番号 | 7 | カード会社にて付番された決済の承認番号 |
| 21 | 仕向先コード | 7 | データを送信したカード会社コード |
| 22 | エラーコード | 3 | 発生したエラーコード |
| 23 | エラー詳細コード | 9 | 発生したエラー詳細コード |
| 24 | 処理日時 | 14 | 処理を行った日付 書式は、 yyyymmddhhmmss形式です。 |
| 25 | レコード通番 | 7 | アップロードファイルでの行番号 |
| 26 | 状態コード | 10 | データの状態INVALID：登録エラーCOMPLETE：決済完了FAIL：決済失敗 |
注意事項
ファイル管理とセキュリティ
取込結果ファイルおよび売上結果ファイルの取得が完了したら、必ずSFTPサーバーから削除してください。