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 |
有効性
チェック |
カード番号が存在するか、有効なカードであるかを確認するための処理区分 |
SAUTH |
簡易
オーソリ |
仮売上と同等の処理ではあるが、実売上にすることはできず、加盟店様でカード会社への
売上伝送を行う必要性がある処理区分 |
AUTH |
仮売上 |
カード与信枠を確保する処理区分 |
SALES |
実売上 |
仮売上後に売上確定し、お客様への請求を行う処理区分 |
CAPTURE |
即時売上 |
仮売上(カード与信枠確保)と実売上(売上確定)の処理を同時に実施する処理区分 |
VOID |
取消 |
取引をキャンセルする処理区分 |
RETURN |
返品 |
取引をキャンセルする処理区分 |
RETURNX |
月跨返品 |
取引をキャンセルする処理区分 |
|
5 |
商品コード |
7 |
【半角文字】数 |
※通常は省略してください
カード会社との間の契約にて使用する商品コードが
決められた場合のみ設定してください
(省略した際は”0000990”を使用して処理します) |
6 |
利用金額 |
7 |
【半角文字】数 |
商品に対する金額税送料を指定していない場合は、
決済金額となります
税送料を指定している場合は利用金額+税送料が決済金額となります |
7 |
税送料 |
7 |
【半角文字】数 |
商品とは異なる送料等の金額 |
8 |
支払方法 |
1 |
【半角文字】数 |
決済を行う際の支払方法
以下のいずれかを設定してください
【1】:一括
【2】:分割
【3】:ボーナス一括
【4】:ボーナス分割
【5】:リボ |
9 |
支払回数 |
2 |
【半角文字】数 |
何回で支払いを行うかの回数
分割の場合は必須項目となります |
10 |
カード種別 |
- |
|
下位互換用の項目
仕向先が自動判定でよい場合は省略してください |
11 |
カード番号 |
16 |
【半角文字】数 |
決済を行うカード番号 |
12 |
セキュリティコード |
4 |
- |
この項目は利用できません
指定しないでください |
13 |
有効期限 |
4 |
【半角文字】数 |
決済を行うカードの有効期限
書式は、“YYMM”形式となります |
14 |
加盟店自由項目1 |
100 |
【半角文字】英数
【全角文字】英数か
カ漢
【半角記号】以下除くすべて(^`{|}~&<>"')
【全角記号】すべて |
加盟店様が自由に使用する事ができる項目
※お客様には表示されません
※実売上/取消/返品/月跨返品/再オーソリの場合は、設定しても反映されません |
15 |
加盟店自由項目2 |
100 |
同上 |
同上 |
16 |
加盟店自由項目3 |
100 |
同上 |
同上 |
17 |
利用日(YYMMDD) |
6 |
【半角文字】数 |
ご利用明細に記載される日付を指定します
未設定の場合は処理日が使用されます
※西暦記載、月日が一桁の場合は前をゼロ埋めしてください
※実売上の場合、
仮売日から処理日までが指定可能です
※即時売上の場合、
31 日前から処理日までが指定可能です
(処理日が 2017/06/12 の場合、
170512から 170612まで指定可能)
※指定範囲外の値が設定された場合
エラー(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 |
処理区分 |
8 |
◎ |
◎ |
◎ |
◎ |
◎ |
◎ |
4 |
商品コード |
7 |
|
|
- |
- |
- |
- |
5 |
利用金額 |
7 |
- |
◎ |
- |
- |
- |
◎ |
6 |
税送料 |
7 |
- |
|
- |
- |
- |
- |
7 |
支払方法 |
1 |
- |
◎ |
- |
- |
- |
◎ |
8 |
支払回数 |
2 |
- |
● |
- |
- |
- |
● |
9 |
カード種別 |
- |
|
|
- |
- |
- |
- |
10 |
カード番号 |
16 |
◎ |
◎ |
- |
- |
- |
- |
11 |
セキュリティコード |
4 |
|
|
- |
- |
- |
- |
12 |
有効期限 |
4 |
◎ |
◎ |
- |
- |
- |
- |
13 |
加盟店自由項目1 |
100 |
|
|
- |
- |
- |
- |
14 |
加盟店自由項目2 |
100 |
|
|
- |
- |
- |
- |
15 |
加盟店自由項目3 |
100 |
|
|
- |
- |
- |
- |
16 |
利用日 |
6 |
- |
|
|
- |
|
|
【必須項目の記号 ◎:必須 ●:条件により必須 空白:省略可能 -:入力不可】
注意事項)オーダーIDについて
・新規に有効性チェック/仮売上/即時売上を行う場合は、既存取引と重複しないオーダーIDを指定してください。
・既存取引のオーダーIDを指定して有効性チェック/仮売上/即時売上を行った場合は、
「再オーソリ」として扱われます
「再オーソリ」として扱われた場合、既存取引のカード情報(カード番号、有効期限)が使用され、
ファイルで指定した値は無視されますので、ご注意ください。
再オーソリ時の必須項目は上記の表の再オーソリと記載された箇所を参照ください。
・実売上/取消/返品/月跨り返品を行う場合は、対象の既存取引のオーダーIDを指定してください。
|