URLをクリップボードにコピーしました
直接参照URL：https://faq.gmo-pg.com/service/Detail.aspx?id=2229
| |
クレジットカード／
SFTP一括処理ファイル＜カード番号版-アップロードファイル＞
|
| |
ご注意：SFTPにて一括オーソリを行う場合のみご利用いただけるフォーマットです
| No |
項目名 |
最大
ﾊﾞｲﾄ数 |
必
須 |
使用可能文字 |
説明 |
| 1 |
フォーマットバージョン |
3 |
◎ |
【半角文字】数 |
予約項目
”001”を指定してください |
| 2 |
ショップID |
13 |
処理区分別必須項目一覧表(カード番号版)参照
※ページ下部へ |
【半角文字】英数 |
加盟店様を識別するID
当サービス契約時に、弊社より発行する値 |
| 3 |
オーダーID |
27 |
【半角文字】英数
【半角記号】- |
加盟店様が取引を識別するためのID |
| 4 |
処理区分 |
- |
【半角文字】英 |
対象取引に対して行う処理の種別
以下のいずれかを設定してください
| 表記 |
取引状態 |
説明 |
| CHECK |
有効性
チェック |
カード番号が存在するか、有効なカードであるかを確認するための処理区分 |
| AUTH |
仮売上 |
カード与信枠を確保する処理区分 |
| SALES |
実売上 |
仮売上後に売上確定し、お客様への請求を行う処理区分 |
| CAPTURE |
即時売上 |
仮売上（カード与信枠確保）と実売上（売上確定）の処理を同時に実施する処理区分 |
| VOID |
取消 |
取引をキャンセルする処理区分 |
| RETURN |
返品 |
取引をキャンセルする処理区分 |
| RETURNX |
月跨返品 |
取引をキャンセルする処理区分 |
| CANCEL |
キャンセル |
取引をキャンセルする処理区分 |
|
| 5 |
商品コード |
7 |
【半角文字】数 |
※通常は省略してください
カード会社との間の契約にて使用する商品コードが
決められた場合のみ設定してください
（省略した際は”0000990”を使用して処理します） |
| 6 |
利用金額 |
7 |
【半角文字】数 |
商品に対する金額税送料を指定していない場合は、
決済金額となります
税送料を指定している場合は利用金額+税送料が決済金額となります |
| 7 |
税送料 |
7 |
【半角文字】数 |
商品とは異なる送料等の金額 |
| 8 |
支払方法 |
1 |
【半角文字】数 |
決済を行う際の支払方法
以下のいずれかを設定してください
【1】：一括
【2】：分割
【3】：ボーナス一括
【4】：ボーナス分割
【5】：リボ |
| 9 |
支払回数 |
2 |
【半角文字】数 |
何回で支払いを行うかの回数
分割の場合は必須項目となります
ボーナス分割の場合は”2”のみ指定できます
（省略した際も、”2” として処理します） |
| 10 |
カード種別 |
- |
|
下位互換用の項目
仕向先が自動判定でよい場合は省略してください |
| 11 |
カード番号 |
16 |
【半角文字】数 |
決済を行うカード番号 |
| 12 |
セキュリティコード |
4 |
- |
この項目は利用できません
指定しないでください |
| 13 |
有効期限 |
4 |
【半角文字】数 |
決済を行うカードの有効期限
書式は、“YYMM”形式となります |
| 14 |
加盟店自由項目1 |
100 |
【半角文字】英数
【全角文字】英数か
カ漢
【半角記号】以下除くすべて（^`{|}~&<>"'）
【全角記号】すべて |
加盟店様が自由に使用する事ができる項目
※お客様には表示されません
※実売上/取消/返品/月跨返品の場合は、設定できません |
| 15 |
加盟店自由項目2 |
100 |
同上 |
同上 |
| 16 |
加盟店自由項目3 |
100 |
同上 |
同上 |
| 17 |
利用日（YYMMDD） |
6 |
【半角文字】数 |
ご利用明細に記載される日付を指定します
未設定の場合は処理日が使用されます
※西暦記載、月日が一桁の場合は前をゼロ埋めしてください
※実売上の場合、
仮売日から処理日までが指定可能です
※即時売上の場合、処理日当日の日付のみ指定可能です
※指定範囲外の値が設定された場合
エラー（E01510011）になります
※処理区分が実売上、及び即時売上でない場合に
設定するとエラー （E01510010）になります |
| 18 |
取引ID |
32 |
- |
- |
出力用項目 |
| 19 |
取引パスワード |
32 |
- |
- |
出力用項目 |
| 20 |
トランザクションID |
28 |
- |
- |
出力用項目 |
| 21 |
承認番号 |
7 |
- |
- |
出力用項目 |
| 22 |
仕向先コード |
7 |
- |
- |
出力用項目 |
| 23 |
エラーコード |
3 |
- |
- |
出力用項目 |
| 24 |
エラー詳細コード |
9 |
- |
- |
出力用項目 |
| 25 |
処理日時 |
14 |
- |
- |
出力用項目
書式は、”yyyymmddhhmmss”形式となります |
【必須項目の記号 ◎：必須 ●：条件により必須 空白：省略可能 -：出力時】
処理区分別必須項目一覧表(カード番号版)
| No |
項目名 |
桁 |
処理区分 |
有効性
チェック |
仮売上
即時売上 |
実売上 |
取消
返品
月跨り返品
キャンセル |
| 1 |
ショップID |
13 |
◎ |
◎ |
◎ |
◎ |
| 2 |
オーダーID |
27 |
◎ |
◎ |
◎ |
◎ |
| 3 |
処理区分 |
- |
◎ |
◎ |
◎ |
◎ |
| 4 |
商品コード |
7 |
|
|
- |
- |
| 5 |
利用金額 |
7 |
- |
◎ |
- |
- |
| 6 |
税送料 |
7 |
- |
|
- |
- |
| 7 |
支払方法 |
- |
- |
◎ |
- |
- |
| 8 |
支払回数 |
2 |
- |
● |
- |
- |
| 9 |
カード種別 |
- |
|
|
- |
- |
| 10 |
カード番号 |
16 |
◎ |
◎ |
- |
- |
| 11 |
セキュリティコード |
4 |
|
|
- |
- |
| 12 |
有効期限 |
4 |
◎ |
◎ |
- |
- |
| 13 |
加盟店自由項目1 |
100 |
|
|
- |
- |
| 14 |
加盟店自由項目2 |
100 |
|
|
- |
- |
| 15 |
加盟店自由項目3 |
100 |
|
|
- |
- |
| 16 |
利用日 |
6 |
- |
|
|
- |
【必須項目の記号 ◎：必須 ●：条件により必須 空白：省略可能 -：入力不可】
＜注意＞
●オーダーIDについて
・新規に有効性チェック/仮売上/即時売上を行う場合は、
既存取引と重複しないオーダーIDを指定してください。
・既存取引のオーダーIDを指定して有効性チェック/仮売上/即時売上を行った場合は、
「再オーソリ」として扱われます
「再オーソリ」として扱われた場合、既存取引のカード情報(カード番号、有効期限)が使用され、
ファイルで指定した値は無視されますので、ご注意ください。
再オーソリ時の必須項目は上記の表の再オーソリと記載された箇所を参照ください。
・実売上/取消/返品/月跨り返品を行う場合は、対象の既存取引のオーダーIDを指定してください。
●金額変更について
・金額変更は、一括処理では実施いただけませんので、
管理画面もしくは API にて 1 件ずつ実施ください。
|
