1. クレジットカード決済とは
1.1. クレジットカード決済とは
クレジットカード決済とは、エンドユーザーが所有するクレジットカードで決済するサービスです。
2. インターフェイス概要
2.1. 利用可能なインターフェイス
クレジットカード決済で利用できるインターフェイスは、「オンライン」「バッチ」「ファイル伝送」「加盟店管理画面」です。
2.2. 利用可能な取引
2.2.1. 課金方式
クレジットカード決済で利用できる課金方式は、「都度課金」と「継続課金」です。
都度課金:利用者が商品・サービスを購入するたびに決済を実行する課金方式
継続課金:利用者の同意のもとカード情報を登録し、事業者が後から任意のタイミングで決済を実行できる課金方式

2.2.2. 取引区分
クレジットカード決済で利用できる取引区分は、「Master電文」「Process電文」「売上障害取消電文」「会員情報登録電文」です。
Master電文:新規取引を開始するための取引区分
Process電文:Master電文の後続処理として利用する取引区分
売上障害取消電文:通信障害などにより、処理結果が確認できなかった場合に利用する取引区分
会員情報登録電文:カード情報と会員ID/会員パスワードを紐付ける取引区分
3Dセキュア認証カード決済Master電文及び、三者間画面サービスカード決済Master電文の場合、売上障害取消電文は利用できません。
2.3. トークン決済機能・リンク型画面決済(三者間)機能
エンドユーザーのカード情報を加盟店システム環境内にて処理・保存・通過させない、情報漏えい防止を目的としたセキュアな決済機能です。非対面決済業者はトークン決済機能またはリンク型画面決済(三者間)機能のいずれかの実装、もしくはPCI-DSS への準拠が必要です。
リンク型画面決済の仕様は契約後に加盟店管理画面より確認可能となります。
2.4. カード情報保持機能
加盟店が採番する会員IDに紐づけてカード情報を登録するオプション機能です。カード情報の登録以降は会員IDと会員パスワードを送信することで与信、売上等の処理が可能です。カード情報は事業者単位もしくは店舗単位で保持します。
カード情報保持単位は利用開始後に変更できません。変更する場合は新しい契約設定が必要です。

2.5. 利用可能なバッチ処理
2.5.1. 売上データ送信処理
一定の処理サイクルでカード会社へ売上データを送信する処理です。月次と日次の処理サイクルが選択可能です。
既定の締め日の23:59:59までにe-SCOTTで締め処理が完了した「売上計上済み」の売上データをカード会社へ送信します。
締め処理が実施される時間までに取消処理が完了した取引は売上データ作成の対象外となります。
2.5.2. 洗替処理
毎月5日時点で当社が保持しているカード情報をカード会社に送信し、最新の状態に更新する処理です。
ステータスが「有効」または「Login回数無効」かつ、洗替使用区分が「1」(洗替する)のカード情報について、e-SCOTTが自動で有効性チェックデータを作成し、カード会社へ送信します。
有効性チェック結果は加盟店管理画面または返戻されるファイルで確認することができます。
| 有効性チェック結果 | 説明 |
|---|---|
| カード情報変更 | カード番号、有効期限のいずれかまたは両方が変更された状態です。 |
| カード無効 | クレジットカードが無効な状態です。次月以降は洗替対象外となります。 |
2.5.3. 支払明細データ返戻処理
加盟店とカード会社との契約が当社を介した包括契約(加盟代行契約)の場合、支払明細データの返戻および加盟店管理画面への反映が可能です。
2.6. 3Dセキュア
3D セキュアは、カード会社が提供する非対面での本人認証サービスです。
→ 3Dセキュアサービス
2.7. 認証アシスト
認証アシストサービスはカード不正利用の防止を目的としたe-SCOTT独自の本人認証サービスです。対象となる認証項目から加盟店が任意に指定した項目について、カード会社が保持する情報と照合し、結果を返戻します。
認証アシストサービスが使用可能なカード会社の条件は以下の通りです。
e-SCOTTが直接接続しているカード会社であること
加盟店が指定した認証項目に対応しているカード会社であること
加盟店が契約しているカード会社であること
| 認証項目名 | 認証結果を返戻する電文項目名 | |
|---|---|---|
| 標準認証項目 | セキュリティコード | 認証結果1 |
| カナ氏名(姓) | 認証結果2 | |
| カナ氏名(名) | 認証結果3 | |
| 生年月日 | 認証結果4 | |
| 電話番号下4桁 | 認証結果5 | |
| 拡張認証項目 | 性別 | 認証結果6 |
| 生年月日の年 | 認証結果7 | |
| 郵便番号 | 認証結果8 | |
| 銀行口座番号上4桁 | 認証結果9 | |
| 銀行口座番号下4桁 | 認証結果10 | |
| カード名義 | 認証結果11 | |
拡張認証項目はJCB、UCSのみ使用可能です。
拡張認証項目はトークン決済機能には対応していません。
3. インターフェイス詳細
3.1. API一覧
クレジットカード決済のAPIは下記のとおりです。
| 処理区分 | コード値 | 説明 | 電文種類 | 取引ステータスの遷移 | 可能な後続処理 | |
|---|---|---|---|---|---|---|
| 遷移前 | 遷移後 | |||||
| カードチェック | 1Check | カードの有効性を確認(入会オーソリ)する機能 | Master電文 | ‐ | カードチェック済 | 「取引参照」 |
| 与信 | 1Auth | カードの与信枠を確保(売上オーソリ)する機能 | Master電文 | ‐ | 与信済 |
「売上計上」
「利用額変更」 「取消」 「再オーソリ」 「取引参照」 |
| 与信売上計上 | 1Gathering | 与信枠確保と同時に与信の確定を行う機能 | Master電文 | ‐ | 売上計上処理済 |
「利用額変更」
「取消」 「再オーソリ」 「取引参照」 |
| 売上計上 | 1Capture | 与信を確定する機能 | Process電文 | 与信済 | 売上計上処理済 |
「利用額変更」
「取消」 「再オーソリ」 「取引参照」 |
| 利用額変更 | 1Change | 与信済の取引に対し、金額を変更する機能 | Process電文 | 与信済 | 与信済 |
「売上計上」
「利用額変更」 「取消」 「再オーソリ」 「取引参照」 |
|
売上計上処理済
カード会社計上済 |
売上計上処理済 |
「利用額変更」
「取消」 「再オーソリ」 「取引参照」 |
||||
| 取消 | 1Delete | 元取引を取り消す機能 | Process電文 |
与信済
売上計上処理済 オーソリなしデータ登録済み |
取消処理済 |
「再オーソリ」
「取引参照」 |
| カード会社計上済 | 返品処理済 | |||||
| 取引参照 | 1Search | 取引の状態を確認する機能 | Process電文 |
カードチェック済
与信済 売上計上処理済 取消処理済 NG 返品処理済 障害取消済 |
‐ | ‐ |
| 再オーソリ | 1ReAuth | 元取引のカード情報で再度与信枠を確保する機能 | Process電文 |
「与信」
※1 |
与信済 |
「売上計上」
「利用額変更」 「取消」 「再オーソリ」 「取引参照」 |
|
「与信売上計上」
※1 |
売上計上処理済 |
「利用額変更」
「取消」 「再オーソリ」 「取引参照」 |
||||
| 売上障害取消 | 1Recover | 障害発生時等に元取引を取り消す機能 | 売上障害取消電文 |
与信済
売上計上処理済 |
取消処理済 |
「再オーソリ」
「取引参照」 |
| 処理区分 | コード値 | 説明 | 電文種類 | 会員ステータスの遷移 | 可能な後続処理 | ||
|---|---|---|---|---|---|---|---|
| 遷移前 | 遷移後 | ||||||
| 会員新規 | 4MemAdd | e-SCOTTにカード情報を登録する機能。 | 会員情報登録電文 | ‐ | 有効 |
「会員更新」
「会員無効」 「会員参照」 |
|
| 会員更新 | 4MemChg | カード情報を更新する機能。 | 会員情報登録電文 |
有効
カード無効 |
有効 |
「会員更新」
「会員無効」 「会員参照」 |
|
| 会員無効 | 4MemInval | カード情報を「会員無効」(Master電文及び再オーソリ利用不可)にする処理。 | 会員情報登録電文 |
有効
カード無効 会員無効 |
会員無効 |
「会員無効解除」
「会員削除」 「会員参照」 |
|
| 会員参照 | 会員参照 | 4MemRef | カード情報を参照する処理。 | 会員情報登録電文 |
有効
カード無効 Login回数無効 会員無効 |
‐ | ‐ |
| 会員参照(マスキング) | 4MemRefM | カード情報を参照する処理(マスキングして返戻)。 | 会員情報登録電文 | ||||
| 会員参照(同一カード番号返戻) | 4MemRefMulti | カード情報を参照する処理(同一カード番号の会員IDを返戻)。 | 会員情報登録電文 | ||||
| トークン会員参照 | 4MemRefToken | トークンからカード情報を参照する処理(同一カード番号の会員IDを返戻)。 | 会員情報登録電文 | ||||
| 会員無効解除 | 4MemUnInval |
無効状態のカード情報を「有効」にする処理。
有効化できない場合は「カード無効」にする。 |
会員情報登録電文 |
カード無効
Login回数無効 会員無効 |
有効 |
「会員更新」
「会員無効」 「会員参照」 |
|
| カード無効 |
「会員更新」
「会員無効」 「会員無効解除」 「会員参照」 |
||||||
| 会員削除 | 4MemDel | 「会員無効」のカード情報を削除する処理。 | 会員情報登録電文 | 会員無効 | 会員削除 | ‐ | |
3.2. 処理フロー
クレジットカード決済の処理フローについて、処理区分ごとに説明します。
3.2.1. 1Check(カードチェック)
処理フロー
①~④の順序で1Check(カードチェック)の処理が行われます。

処理内容
| No | 処理内容 | 加盟店側実装 |
|---|---|---|
| ① | Master電文に必要項目をセットし、加盟店からe-SCOTTに送信します。 | ○ |
| ② | 加盟店から送信されたMaster電文をもとに、e-SCOTTからカード会社に承認要求を行います。 | |
| ③ | カード会社からの応答をもとに、e-SCOTTで取引情報の更新を行います。 | |
| ④ | 処理結果およびプロセスID・プロセスパスワードをe-SCOTTから加盟店に応答します。 | ○ |
3.2.2. 1Auth(与信)
3.2.3. 1Gathering(与信売上計上)
3.2.4. 1Capture(売上計上)
処理フロー
①~⑦の順序で1Capture(売上計上)の処理が行われます。
処理内容
| No | 処理内容 | 加盟店側実装 |
|---|---|---|
| ① | Process電文に必要項目をセットし、加盟店からe-SCOTTに送信します。 | ○ |
| ② | 加盟店から送信されたProcess電文をもとに、e-SCOTTで取引情報の更新を行います。 | |
| ③ | 処理結果をe-SCOTTから加盟店に応答します。 | ○ |
| ④ | 売上締日等のタイミングでe-SCOTTがバッチ処理で売上データ(バッチデータ)を生成します。 | |
| ⑤ | e-SCOTTが該当の取引情報の更新を行います。 | |
| ⑥ | e-SCOTTからカード会社にバッチデータの送信を行います。 | |
| ⑦ | バッチデータの処理結果は、e-SCOTTの加盟店管理画面で参照可能です。 |
3.2.5. 1Change(利用額変更)
処理フロー
3.2.4 1Capture(売上計上)と同様の処理が行われます。
処理内容
3.2.4 1Capture(売上計上)と同様の処理内容です。
元取引のステータスが「カード会社計上済」の場合、「返品処理済」レコードが作成されます。
3.2.6. 1Delete(取消)
処理フロー
3.2.4 1Capture(売上計上)と同様の処理が行われます。
処理内容
3.2.4 1Capture(売上計上)と同様の処理内容です。
元取引のステータスが「カード会社計上済」の場合、「返品処理済」レコードが作成されます。
3.2.7. 1Search(取引参照)
3.2.8. 1ReAuth(再オーソリ)
3.2.9. 1Recover(売上障害取消)
処理フロー
①~④の順序で1Recover(売上障害取消)の処理が行われます。

処理内容
| No | 処理内容 | 加盟店側実装 |
|---|---|---|
| ① | 売上障害取消電文に必要項目をセットし、加盟店からe-SCOTTに送信します。 | ○ |
| ② | 加盟店から送信された売上障害取消電文をもとに、e-SCOTTからカード会社に承認要求を行います。 | |
| ③ | カード会社からの応答をもとに、e-SCOTTで取引情報の更新を行います。 | |
| ④ | 処理結果をe-SCOTTから加盟店に応答します。 | ○ |
3.2.10. 4MemAdd(会員新規)
処理フロー
①~④の順序で4MemAdd(会員新規) の処理が行われます

処理内容
| No. | 処理内容 | 加盟店側実装 |
|---|---|---|
| ① | 会員情報登録電文に必要項目をセットし、加盟店からe-SCOTTに送信します。 | ○ |
| ② | 加盟店から送信された会員情報登録電文をもとに、e-SCOTTからカード会社に承認要求を行います。 | |
| ③ | カード会社からの応答をもとに、e-SCOTTで取引情報の更新を行います。 | |
| ④ | 処理結果をe-SCOTTから加盟店に応答します。 | ○ |
3.2.11. 4MemChg(会員更新)
3.2.12. 4MemInval(会員無効)
3.2.13. 4MemRef(会員参照)
3.2.14. 4MemRefM(会員参照(マスキング))
3.2.15. 4MemRefMulti(会員参照(同一カード番号返戻))
3.2.16. 4MemRefToken(トークン会員参照)
3.2.17. 4MemUnInval(会員無効解除)
3.2.18. 4MemDel(会員削除)
3.3. API仕様
e-SCOTTのAPI仕様について説明します。
3.3.1. 接続先URL
Master電文・Process電文・売上障害取消電文・会員情報登録電文の接続先URLは、下記のとおりです。
| 環境 | 接続先URL |
|---|---|
| テスト環境 | 契約後に管理画面から確認してください |
| 本番環境 |
POST電文の通知先URLは、下記のとおりです。
| 電文種別 | 通知先URL |
|---|---|
| オンライン取引 Master電文 | 電文項目の「POST用URL」に設定したURL |
| 会員情報登録電文 | |
| 与信済ステータス取引自動取消 | 管理画面にて設定したURL |
3.3.2. Master電文項目定義
1Check(カードチェック)、1Auth(与信)、1Gathering(与信売上計上)の電文項目は下記のとおりです。
3.3.2.1. カードチェック(1Check)
リクエストパラメーター
◎:必須/○:任意(条件付き必須の場合は注釈あり) /-:セット不要
| 項目名 | パラメーター名 | 桁数 | 形式 | データ型 | 説明 | 設定要領 |
|---|---|---|---|---|---|---|
| 接続ID | MerchantId | 8 | 固定長 | 半角英数字 | e-SCOTTが加盟店を識別するID(SP.LINKSが発番)。 | ◎ |
| 接続パスワード | MerchantPass | 64 | 固定 | 半角英数字記号大文字小文字 | e-SCOTTが加盟店を認証するパスワード(加盟店が加盟店管理画面で発番)。 | ◎ |
| 取引日付 | TransactionDate | 8 | 固定 | 半角数字(YYYYMMDD) | 当日以前をセットしてください。 | ◎ |
| 処理区分 | OperateId | - | 可変長 | 半角英数字 | →API一覧 | ◎ |
| 加盟店自由領域1 | MerchantFree1 | 64 | 可変 | 全半角文字 |
加盟店が自由に使用できる項目。 半角の「&」「<」「>」「"」「'」 はセットしないでください。 エンドユーザ氏名、電話番号などの個人情報はセットしないでください。 |
〇 |
| 加盟店自由領域2 | MerchantFree2 | 64 | 可変 | 全半角文字 | 〇 | |
| 加盟店自由領域3 | MerchantFree3 | 64 | 可変 | 全半角文字 | 〇 | |
| 店舗コード | TenantId | 4 | 固定 | 半角数字 |
→店舗コード セットしない場合は「0001」として扱います。 |
〇 ※2 |
| 会員ID | KaiinId | 6~32 | 範囲 | 半角英数字 | カード情報に紐づくID。 |
〇 ※1 |
| 会員パスワード | KaiinPass | 6~12 | 範囲 | 半角英数字 | 会員IDに紐づくパスワード。 |
〇 ※1 |
| カード番号 | CardNo | 11~16 | 範囲 | 半角数字 |
クレジットカード番号。 PCIDSSに準拠していない場合、使用できません。 |
〇 ※1※7 |
| カード有効期限 | CardExp | 4 | 固定 | 半角数字(YYMM) | クレジットカード有効期限。 |
〇 ※1※7 |
| セキュリティコード | SecCd | 3~4 | 範囲 | 半角数字 | 認証アシスト項目。 |
〇 ※3 |
| カナ氏名(姓) | KanaSei | 15 | 可変 | 半角カナ |
〇 ※3 |
|
| カナ氏名(名) | KanaMei | 15 | 可変 | 半角カナ |
〇 ※3 |
|
| 生月日 | BirthDay | 4 | 固定 | 半角数字(MMDD) |
〇 ※3 |
|
| 電話番号 | TelNo | 4 | 固定 | 半角数字 |
〇 ※3 |
|
| 性別 | Sex | 1 | 固定 | 半角英字 |
〇 ※3 |
|
| 生年月日の年 | BirthYear | 4 | 固定 | 半角数字(YYYY) |
〇 ※3 |
|
| 郵便番号 | Postal | 7 | 固定 | 半角数字 |
〇 ※3 |
|
| 銀行口座番号上4桁 | AcntNo1 | 4 | 固定 | 半角数字 |
〇 ※3 |
|
| 銀行口座番号下4桁 | AcntNo2 | 4 | 固定 | 半角数字 |
〇 ※3 |
|
| カード名義 | CardMei | 26 | 可変 | 半角英字記号 |
〇 ※3 |
|
| 3Dメッセージバージョン番号 | MessageVersionNo3D | 10 | 可変 | 半角英数字記号 | 3Dセキュア関連項目。 |
〇 ※4 |
| エンコード済XID | EncodeXId3D | 28 | 可変 | 半角英数字記号 |
〇 ※4 |
|
| ステータス | TransactionStatus3D | 1 | 固定 | 半角英数字 |
〇 ※4 |
|
| CAVV | CAVV3D | 28 | 可変 | 半角英数字記号 |
〇 ※4 |
|
| ECI | ECI3D | 2 | 固定 | 半角英数字 |
〇 ※4 |
|
| カード番号(3D) | PANCardNo3D | 19 | 可変 | 半角英数字 |
〇 ※4※5 |
|
| トークン | Token | 32 | 固定 | 半角英数字 | カード情報の代わりとなる識別子。 |
〇 ※1 |
| POST用URL | PostUrl | 500 | 可変 | 半角英数字記号 | POST電文の送信先URL。 | 〇 |
| 処理番号 | ProcNo | 7 | 固定 | 半角数字 |
加盟店が取引を識別するための番号(加盟店が採番)。 取引日付、店舗コード単位で一意の番号をセットしてください。 |
〇 ※6 |
| DSトランザクションID | DSTransactionId | 36 | 可変 | 半角英数字記号 | 3Dセキュア関連項目。 |
〇 ※4 |
| 3DSサーバートランザクションID | ThreeDSServerTransactionId | 36 | 可変 | 半角英数字記号 |
〇 ※4 |
|
| ブランドトークン | BdToken | 11~16 | 範囲 | 半角数字 | ブランドトークン項目。 | 〇 |
| ブランドトークン有効期限 | BdTokenExp | 4 | 固定 | 半角数字(YYMM) |
〇 ※7 |
|
| クリプトグラム | Cryptogram | 28 | 可変 | 半角英数字記号 |
〇 ※8 |
|
| ブランドトークンECI | BdTokenEci | 2 | 固定 | 半角数字 |
〇 ※8 |
|
| POSエントリーモード | PosEntryMode | 2 | 固定 | 半角数字 |
ブランドトークン項目。 →POSエントリーモード |
〇 ※7 |
| トークンリクエスタID | TokenRequestorId | 11 | 可変 | 半角数字 | ブランドトークン項目。 |
〇 ※9 |
BODY部サンプル
カードチェック(1Check)リクエスト
MerchantId=12346578&MerchantPass=abc123AB&OperateId=1Check&TransactionDate=20210301&KaiinId=abcdef&KaiinPass=abcdefレスポンスパラメーター
◎:必須/○:任意(条件付き必須の場合は注釈あり) /-:セット不要
| 項目名 | パラメーター名 | 桁数 | 形式 | データ型 | 説明 | 設定要領 |
|---|---|---|---|---|---|---|
| 処理通番 | TransactionId | 12 | 固定 | 半角数字 | 処理を識別するコード(e-SCOTTが自動採番)。 | ◎ |
| 取引日付 | TransactionDate | 8 | 固定 | 半角数字(YYYYMMDD) | リクエスト時にセットした値を応答します。 | ◎ |
| 処理区分 | OperateId | - | 可変長 | 半角英数字 | リクエスト時にセットした値を応答します。 | ◎ |
| 加盟店自由領域1 | MerchantFree1 | 64 | 可変 | 全半角文字 | リクエスト時にセットした値を応答します。 | 〇 |
| 加盟店自由領域2 | MerchantFree2 | 64 | 可変 | 全半角文字 | リクエスト時にセットした値を応答します。 | 〇 |
| 加盟店自由領域3 | MerchantFree3 | 64 | 可変 | 全半角文字 | リクエスト時にセットした値を応答します。 | 〇 |
| プロセスID | ProcessId | 32 | 固定 | 半角英数字 | 取引を識別するコード(e-SCOTTが自動採番)。 |
〇 ※1 |
| プロセスパスワード | ProcessPass | 32 | 固定 | 半角英数字 | 取引を識別するパスワード(e-SCOTTが自動採番)。 |
〇 ※1 |
| 処理結果コード | ResponseCd | 200 | 可変 | 半角英数字記号 |
→レスポンスコード 1コード3Byte。コードが複数ある場合はパイプ「|」区切りでセットします。 |
◎ |
| カード会社コード | CompanyCd | 2 | 固定 | 半角英数字 | カード会社を識別するコード。 |
〇 ※1 |
| 承認番号 | ApproveNo | 7 | 可変 | 半角英数字スペース | カード会社発番の承認番号。 |
〇 ※1 |
| 認証結果1 | McSecCd | 1 | 固定 | 半角数字 |
認証アシスト項目の認証結果。 →認証結果一覧 |
〇 ※2 |
| 認証結果2 | McKanaSei | 1 | 固定 | 半角数字 |
〇 ※2 |
|
| 認証結果3 | McKanaMei | 1 | 固定 | 半角数字 |
〇 ※2 |
|
| 認証結果4 | McBirthDay | 1 | 固定 | 半角数字 |
〇 ※2 |
|
| 認証結果5 | McTelNo | 1 | 固定 | 半角数字 |
〇 ※2 |
|
| 認証結果6 | McSex | 1 | 固定 | 半角数字 |
〇 ※2 |
|
| 認証結果7 | McBirthYear | 1 | 固定 | 半角数字 |
〇 ※2 |
|
| 認証結果8 | McPostal | 1 | 固定 | 半角数字 |
〇 ※2 |
|
| 認証結果9 | McAcntNo1 | 1 | 固定 | 半角数字 |
〇 ※2 |
|
| 認証結果10 | McAcntNo2 | 1 | 固定 | 半角数字 |
〇 ※2 |
|
| 認証結果11 | McCardMei | 1 | 固定 | 半角数字 |
〇 ※2 |
|
| 処理番号 | ProcNo | 7 | 固定 | 半角数字 | リクエスト時にセットした値を応答します。 | 〇 |
| ブランドトークン | BdToken | 11~16 | 範囲 | 半角数字 | リクエスト時にセットした値を応答します。 | 〇 |
| ブランドトークン有効期限 | BdTokenExp | 4 | 固定 | 半角数字(YYMM) | リクエスト時にセットした値を応答します。 |
〇 ※3 |
| クリプトグラム | Cryptogram | 28 | 可変 | 半角英数字記号 | リクエスト時にセットした値を応答します。 |
〇 ※4 |
| ブランドトークンECI | BdTokenEci | 2 | 固定 | 半角数字 | リクエスト時にセットした値を応答します。 |
〇 ※4 |
| ブランドトークン仕向判定結果 | BdTokenResponceCd | 1 | 固定 | 半角数字 |
ブランドトークン項目。 →ブランドトークン仕向判定結果 |
〇 ※5 |
| POSエントリーモード | PosEntryMode | 2 | 固定 | 半角数字 | リクエスト時にセットした値を応答します。 |
〇 ※3 |
| ブランドトークントランザクションID(TID) | TransactionIdentifier | 16 | 可変 | 半角英数字記号 | ブランドトークン項目。 |
〇 ※5※6 |
| トークンリクエスタID | TokenRequestorId | 11 | 可変 | 半角数字 | リクエスト時にセットした値を応答します。 |
〇 ※7 |
BODY部サンプル
カードチェック(1Check)レスポンス
TransactionId=1000000000123&TransactionDate=20090101&OperateId=1Check&ProcessId=abcdd12345678ABCDEFG123456789abc&ProcessPass=12345678abcdefghi9876543210ABCDE&ResponseCd=OK&CompanyCd=Y2&ApproveNo=12345673.3.2.2. 与信(1Auth)
リクエストパラメーター
◎:必須/○:任意(条件付き必須の場合は注釈あり) /-:セット不要
| 項目名 | パラメーター名 | 桁数 | 形式 | データ型 | 説明 | 設定要領 |
|---|---|---|---|---|---|---|
| 接続ID | MerchantId | 8 | 固定長 | 半角英数字 | e-SCOTTが加盟店を識別するID(SP.LINKSが発番)。 | ◎ |
| 接続パスワード | MerchantPass | 64 | 固定 | 半角英数字記号大文字小文字 | e-SCOTTが加盟店を認証するパスワード(加盟店が加盟店管理画面で発番)。 | ◎ |
| 取引日付 | TransactionDate | 8 | 固定 | 半角数字(YYYYMMDD) | 当日以前をセットしてください。 | ◎ |
| 処理区分 | OperateId | - | 可変長 | 半角英数字 | →API一覧 | ◎ |
| 加盟店自由領域1 | MerchantFree1 | 64 | 可変 | 全半角文字 |
加盟店が自由に使用できる項目。 半角の「&」「<」「>」「"」「'」 はセットしないでください。 エンドユーザ氏名、電話番号などの個人情報はセットしないでください。 |
〇 |
| 加盟店自由領域2 | MerchantFree2 | 64 | 可変 | 全半角文字 | 〇 | |
| 加盟店自由領域3 | MerchantFree3 | 64 | 可変 | 全半角文字 | 〇 | |
| 店舗コード | TenantId | 4 | 固定 | 半角数字 |
→店舗コード セットしない場合は「0001」として扱います。 |
〇 ※2 |
| 会員ID | KaiinId | 6~32 | 範囲 | 半角英数字 | カード情報に紐づくID。 |
〇 ※1 |
| 会員パスワード | KaiinPass | 6~12 | 範囲 | 半角英数字 | 会員IDに紐づくパスワード。 |
〇 ※1 |
| カード番号 | CardNo | 11~16 | 範囲 | 半角数字 |
クレジットカード番号。 PCIDSSに準拠していない場合、使用できません。 |
〇 ※1※9 |
| カード有効期限 | CardExp | 4 | 固定 | 半角数字(YYMM) | クレジットカード有効期限。 |
〇 ※1※9 |
| 支払区分 | PayType | 2 | 固定 | 半角数字 | →支払区分 | ◎ |
| 利用金額 | Amount | 8 | 可変 | 半角数字 |
利用金額。 「1(1円)」以上をセットしてください。 |
◎ |
| セキュリティコード | SecCd | 3~4 | 範囲 | 半角数字 | 認証アシスト項目。 |
〇 ※3 |
| カナ氏名(姓) | KanaSei | 15 | 可変 | 半角カナ |
〇 ※3 |
|
| カナ氏名(名) | KanaMei | 15 | 可変 | 半角カナ |
〇 ※3 |
|
| 生月日 | BirthDay | 4 | 固定 | 半角数字(MMDD) |
〇 ※3 |
|
| 電話番号 | TelNo | 4 | 固定 | 半角数字 |
〇 ※3 |
|
| 性別 | Sex | 1 | 固定 | 半角英字 |
〇 ※3 |
|
| 生年月日の年 | BirthYear | 4 | 固定 | 半角数字(YYYY) |
〇 ※3 |
|
| 郵便番号 | Postal | 7 | 固定 | 半角数字 |
〇 ※3 |
|
| 銀行口座番号上4桁 | AcntNo1 | 4 | 固定 | 半角数字 |
〇 ※3 |
|
| 銀行口座番号下4桁 | AcntNo2 | 4 | 固定 | 半角数字 |
〇 ※3 |
|
| カード名義 | CardMei | 26 | 可変 | 半角英字記号 |
〇 ※3 |
|
| 3Dメッセージバージョン番号 | MessageVersionNo3D | 10 | 可変 | 半角英数字記号 | 3Dセキュア関連項目。 |
〇 ※4 |
| エンコード済XID | EncodeXId3D | 28 | 可変 | 半角英数字記号 |
〇 ※4 |
|
| ステータス | TransactionStatus3D | 1 | 固定 | 半角英数字 | 3Dセキュア関連項目。 |
〇 ※4 |
| CAVV | CAVV3D | 28 | 可変 | 半角英数字記号 |
〇 ※4 |
|
| ECI | ECI3D | 2 | 固定 | 半角英数字 |
〇 ※4 |
|
| カード番号(3D) | PANCardNo3D | 19 | 可変 | 半角英数字 |
〇 ※4※5 |
|
| トークン | Token | 32 | 固定 | 半角数字 | カード情報の代わりとなる識別子。 |
〇 ※1 |
| POST用URL | PostUrl | 500 | 固定 | 半角数字 | POST電文の送信先URL。 | 〇 |
| 処理番号 | ProcNo | 7 | 固定 | 半角数字 |
加盟店が取引を識別するための番号(加盟店が採番)。 取引日付、店舗コード単位で一意の番号をセットしてください。 |
〇 ※6 |
| オーソリ会員登録同時実行フラグ | AuthKaiinAddFlg | 1 | 固定 | 半角数字 |
オーソリ会員登録同時実行を行う場合に使用するフラグ。 「会員ID/会員パスワード」にセットした値で会員登録を行います。 |
〇 ※7 |
| 会員ID自動採番利用フラグ | KaiinIdAutoRiyoFlg | 1 | 固定 | 半角数字 |
オーソリ会員登録同時実行利用時、会員IDをe-SCOTTで自動採番する場合に使用するフラグ。 利用時は「会員ID」にはブランクをセットしてください。 |
〇 |
| DSトランザクションID | DSTransactionId | 36 | 可変 | 半角英数字記号 | 3Dセキュア関連項目。 |
〇 ※4 |
| 3DSサーバートランザクションID | ThreeDSServerTransactionId | 36 | 可変 | 半角英数字記号 |
〇 ※4 |
|
| ユーザ請求先住所情報 | BillingAddress1 | 50 | 可変 | 半角英数字記号 | 3Dセキュア認証項目。 |
〇 ※8 |
| ユーザ都市 | BillingCity | 50 | 可変 | 半角英数字記号 |
〇 ※8 |
|
| ユーザ国名コード | BillingCountryCode | 3 | 可変 | 半角数字 |
〇 ※8 |
|
| ユーザ郵便番号 | BillingPostalCode | 16 | 可変 | 半角英数字記号 |
〇 ※8 |
|
| ユーザフルネーム | BillingFullName | 2~45 | 可変 | 半角英数字記号スペース |
〇 ※8 |
|
| ユーザEメール | BillingEmail | 254 | 可変 | 半角英数字記号 |
〇 ※8 |
|
| ユーザ電話番号 | BillingPhoneNumber | 20 | 可変 | 半角数字記号 |
〇 ※8 |
|
| ユーザ携帯電話番号 | BillingMobilePhone | 25 | 可変 | 半角数字記号 |
〇 ※8 |
|
| ブランドトークン | BdToken | 11~16 | 範囲 | 半角数字 | ブランドトークン項目。 | 〇 |
| ブランドトークン有効期限 | BdTokenExp | 4 | 固定 | 半角数字(YYMM) |
〇 ※9 |
|
| クリプトグラム | Cryptogram | 28 | 可変 | 半角英数字記号 |
〇 ※10 |
|
| ブランドトークンECI | BdTokenEci | 2 | 固定 | 半角数字 |
〇 ※10 |
|
| POSエントリーモード | PosEntryMode | 2 | 固定 | 半角数字 |
ブランドトークン項目。 →POSエントリーモード |
〇 ※9 |
| ブランドトークントランザクションID(TID) | TransactionIdentifier | 16 | 可変 | 半角英数字記号 | ブランドトークン項目。 |
〇 ※11 |
| トークンリクエスタID | TokenRequestorId | 11 | 可変 | 半角数字 |
〇 ※12 |
|
| ブランドトークン取引種別 | BdTokenTransactionType | 1 | 固定 | 半角数字 |
ブランドトークン項目。 →ブランドトークン取引種別 |
〇 |
BODY部サンプル
与信(1Auth)リクエスト
MerchantId=12346578&MerchantPass=abc123AB&TransactionDate=20090101&OperateId=1Auth&KaiinId=abcdef&KaiinPass=abcdef&PayType=01&Amount=3000レスポンスパラメーター
◎:必須/○:任意(条件付き必須の場合は注釈あり) /-:セット不要
| 項目名 | パラメーター名 | 桁数 | 形式 | データ型 | 説明 | 設定要領 |
|---|---|---|---|---|---|---|
| 処理通番 | TransactionId | 12 | 固定 | 半角数字 | 処理を識別するコード(e-SCOTTが自動採番)。 | ◎ |
| 取引日付 | TransactionDate | 8 | 固定 | 半角数字(YYYYMMDD) | リクエスト時にセットした値を応答します。 | ◎ |
| 処理区分 | OperateId | - | 可変長 | 半角英数字 | リクエスト時にセットした値を応答します。 | ◎ |
| 加盟店自由領域1 | MerchantFree1 | 64 | 可変 | 全半角文字 | リクエスト時にセットした値を応答します。 | 〇 |
| 加盟店自由領域2 | MerchantFree2 | 64 | 可変 | 全半角文字 | リクエスト時にセットした値を応答します。 | 〇 |
| 加盟店自由領域3 | MerchantFree3 | 64 | 可変 | 全半角文字 | リクエスト時にセットした値を応答します。 | 〇 |
| プロセスID | ProcessId | 32 | 固定 | 半角英数字 | 取引を識別するコード(e-SCOTTが自動採番)。 |
〇 ※1 |
| プロセスパスワード | ProcessPass | 32 | 固定 | 半角英数字 | 取引を識別するパスワード(e-SCOTTが自動採番)。 |
〇 ※1 |
| 処理結果コード | ResponseCd | 200 | 可変 | 半角英数字記号 |
→レスポンスコード 1コード3Byte。コードが複数ある場合はパイプ「|」区切りでセットします。 |
◎ |
| 会員ID | KaiinId | 6~32 | 範囲 | 半角英数字 | カード情報に紐づくID。 |
〇 ※2※4 |
| カード会社コード | CompanyCd | 2 | 固定 | 半角英数字 | カード会社を識別するコード。 |
〇 ※1 |
| 承認番号 | ApproveNo | 7 | 可変 | 半角英数字 | カード会社発番の承認番号。 |
〇 ※1 |
| 認証結果1 | McSecCd | 1 | 固定 | 半角英数字 |
認証アシスト項目の認証結果。 →認証結果一覧 |
〇 ※3 |
| 認証結果2 | McKanaSei | 1 | 固定 | 半角英数字 |
〇 ※3 |
|
| 認証結果3 | McKanaMei | 1 | 固定 | 半角英数字 |
〇 ※3 |
|
| 認証結果4 | McBirthDay | 1 | 固定 | 半角英数字 |
〇 ※3 |
|
| 認証結果5 | McTelNo | 1 | 固定 | 半角英数字 |
〇 ※3 |
|
| 認証結果6 | McSex | 1 | 固定 | 半角英数字 |
〇 ※3 |
|
| 認証結果7 | McBirthYear | 1 | 固定 | 半角英数字 |
〇 ※3 |
|
| 認証結果8 | McPostal | 1 | 固定 | 半角英数字 |
〇 ※3 |
|
| 認証結果9 | McAcntNo1 | 1 | 固定 | 半角英数字 |
〇 ※3 |
|
| 認証結果10 | McAcntNo2 | 1 | 固定 | 半角英数字 |
〇 ※3 |
|
| 認証結果11 | McCardMei | 1 | 固定 | 半角英数字 |
〇 ※3 |
|
| 処理番号 | ProcNo | 7 | 固定 | 半角数字 |
加盟店が取引を識別するための番号(加盟店が採番)。 取引日付、店舗コード単位で一意の番号をセットしてください。 |
〇 |
| ブランドトークン | BdToken | 11~16 | 範囲 | 半角数字 | ブランドトークン項目。 | 〇 |
| ブランドトークン有効期限 | BdTokenExp | 4 | 固定 | 半角数字(YYMM) |
〇 ※5 |
|
| クリプトグラム | Cryptogram | 28 | 可変 | 半角英数字記号 |
〇 ※6 |
|
| ブランドトークンECI | BdTokenEci | 2 | 固定 | 半角数字 |
〇 ※6 |
|
| ブランドトークン仕向判定結果 | BdTokenResponceCd | 1 | 固定 | 半角数字 |
ブランドトークン項目。 →ブランドトークン仕向判定結果 |
〇 ※7 |
| POSエントリーモード | PosEntryMode | 2 | 固定 | 半角数字 |
ブランドトークン項目。 →POSエントリーモード |
〇 ※5 |
| ブランドトークントランザクションID(TID) | TransactionIdentifier | 16 | 可変 | 半角英数字記号 | ブランドトークン項目。 |
〇 ※7※8 |
| トークンリクエスタID | TokenRequestorId | 11 | 可変 | 半角数字 |
〇 ※9 |
|
| ブランドトークン取引種別 | BdTokenTransactionType | 1 | 固定 | 半角数字 |
ブランドトークン項目。 →ブランドトークン取引種別 |
〇 |
BODY部サンプル
与信(1Auth)レスポンス
TransactionId=1000000000123&TransactionDate=20090101&OperateId=1Auth&ProcessId=abcdd12345678ABCDEFG123456789abc&ProcessPass=12345678abcdefghi9876543210ABCDE&ResponseCd=OK&CompanyCd=Y2&ApproveNo=12345673.3.2.3. 与信売上計上(1Gathering)
リクエストパラメーター
◎:必須/○:任意(条件付き必須の場合は注釈あり) /-:セット不要
| 項目名 | パラメーター名 | 桁数 | 形式 | データ型 | 説明 | 設定要領 |
|---|---|---|---|---|---|---|
| 接続ID | MerchantId | 8 | 固定長 | 半角英数字 | e-SCOTTが加盟店を識別するID(SP.LINKSが発番)。 | ◎ |
| 接続パスワード | MerchantPass | 64 | 固定 | 半角英数字記号大文字小文字 | e-SCOTTが加盟店を認証するパスワード(加盟店が加盟店管理画面で発番)。 | ◎ |
| 取引日付 | TransactionDate | 8 | 固定 | 半角数字(YYYYMMDD) | 当日以前をセットしてください。 | ◎ |
| 処理区分 | OperateId | - | 可変長 | 半角英数字 | →API一覧 | ◎ |
| 加盟店自由領域1 | MerchantFree1 | 64 | 可変 | 全半角文字 |
加盟店が自由に使用できる項目。 半角の「&」「<」「>」「"」「'」 はセットしないでください。 エンドユーザ氏名、電話番号などの個人情報はセットしないでください。 |
〇 |
| 加盟店自由領域2 | MerchantFree2 | 64 | 可変 | 全半角文字 | 〇 | |
| 加盟店自由領域3 | MerchantFree3 | 64 | 可変 | 全半角文字 | 〇 | |
| 店舗コード | TenantId | 4 | 固定 | 半角数字 |
→店舗コード セットしない場合は「0001」として扱います。 |
〇 ※2 |
| 会員ID | KaiinId | 6~32 | 範囲 | 半角英数字 | カード情報に紐づくID。 |
〇 ※1 |
| 会員パスワード | KaiinPass | 6~12 | 範囲 | 半角英数字 | 会員IDに紐づくパスワード。 |
〇 ※1 |
| カード番号 | CardNo | 11~16 | 範囲 | 半角数字 |
クレジットカード番号。 PCIDSSに準拠していない場合、使用できません。 |
〇 ※1※9 |
| カード有効期限 | CardExp | 4 | 固定 | 半角数字(YYMM) | クレジットカード有効期限。 |
〇 ※1※9 |
| 支払区分 | PayType | 2 | 固定 | 半角数字 | →支払区分 | ◎ |
| 利用金額 | Amount | 8 | 可変 | 半角数字 |
利用金額。 「1(1円)」以上をセットしてください。 |
◎ |
| セキュリティコード | SecCd | 3~4 | 範囲 | 半角数字 | 認証アシスト項目。 |
〇 ※3 |
| カナ氏名(姓) | KanaSei | 15 | 可変 | 半角カナ |
〇 ※3 |
|
| カナ氏名(名) | KanaMei | 15 | 可変 | 半角カナ |
〇 ※3 |
|
| 生月日 | BirthDay | 4 | 固定 | 半角数字(MMDD) |
〇 ※3 |
|
| 電話番号 | TelNo | 4 | 固定 | 半角数字 |
〇 ※3 |
|
| 性別 | Sex | 1 | 固定 | 半角英字 |
〇 ※3 |
|
| 生年月日の年 | BirthYear | 4 | 固定 | 半角数字(YYYY) |
〇 ※3 |
|
| 郵便番号 | Postal | 7 | 固定 | 半角数字 |
〇 ※3 |
|
| 銀行口座番号上4桁 | AcntNo1 | 4 | 固定 | 半角数字 |
〇 ※3 |
|
| 銀行口座番号下4桁 | AcntNo2 | 4 | 固定 | 半角数字 |
〇 ※3 |
|
| カード名義 | CardMei | 26 | 可変 | 半角英字記号 |
〇 ※3 |
|
| 3Dメッセージバージョン番号 | MessageVersionNo3D | 10 | 可変 | 半角英数字記号 | 3Dセキュア関連項目。 |
〇 ※4 |
| エンコード済XID | EncodeXId3D | 28 | 可変 | 半角英数字記号 |
〇 ※4 |
|
| ステータス | TransactionStatus3D | 1 | 固定 | 半角英数字 | 3Dセキュア関連項目。 |
〇 ※4 |
| CAVV | CAVV3D | 28 | 可変 | 半角英数字記号 |
〇 ※4 |
|
| ECI | ECI3D | 2 | 固定 | 半角英数字 |
〇 ※4 |
|
| カード番号(3D) | PANCardNo3D | 19 | 可変 | 半角英数字 |
〇 ※4※5 |
|
| トークン | Token | 32 | 固定 | 半角数字 | カード情報の代わりとなる識別子。 |
〇 ※1 |
| POST用URL | PostUrl | 500 | 固定 | 半角数字 | POST電文の送信先URL。 | 〇 |
| 処理番号 | ProcNo | 7 | 固定 | 半角数字 |
加盟店が取引を識別するための番号(加盟店が採番)。 取引日付、店舗コード単位で一意の番号をセットしてください。 |
〇 ※6 |
| オーソリ会員登録同時実行フラグ | AuthKaiinAddFlg | 1 | 固定 | 半角数字 |
オーソリ会員登録同時実行を行う場合に使用するフラグ。 「会員ID/会員パスワード」にセットした値で会員登録を行います。 |
〇 ※7 |
| 会員ID自動採番利用フラグ | KaiinIdAutoRiyoFlg | 1 | 固定 | 半角数字 |
オーソリ会員登録同時実行利用時、会員IDをe-SCOTTで自動採番する場合に使用するフラグ。 利用時は「会員ID」にはブランクをセットしてください。 |
〇 |
| DSトランザクションID | DSTransactionId | 36 | 可変 | 半角英数字記号 | 3Dセキュア関連項目。 |
〇 ※4 |
| 3DSサーバートランザクションID | ThreeDSServerTransactionId | 36 | 可変 | 半角英数字記号 |
〇 ※4 |
|
| ユーザ請求先住所情報 | BillingAddress1 | 50 | 可変 | 半角英数字記号 | 3Dセキュア認証項目。 |
〇 ※8 |
| ユーザ都市 | BillingCity | 50 | 可変 | 半角英数字記号 |
〇 ※8 |
|
| ユーザ国名コード | BillingCountryCode | 3 | 可変 | 半角数字 |
〇 ※8 |
|
| ユーザ郵便番号 | BillingPostalCode | 16 | 可変 | 半角英数字記号 |
〇 ※8 |
|
| ユーザフルネーム | BillingFullName | 2~45 | 可変 | 半角英数字記号スペース |
〇 ※8 |
|
| ユーザEメール | BillingEmail | 254 | 可変 | 半角英数字記号 |
〇 ※8 |
|
| ユーザ電話番号 | BillingPhoneNumber | 20 | 可変 | 半角数字記号 |
〇 ※8 |
|
| ユーザ携帯電話番号 | BillingMobilePhone | 25 | 可変 | 半角数字記号 |
〇 ※8 |
|
| ブランドトークン | BdToken | 11~16 | 範囲 | 半角数字 | ブランドトークン項目。 | 〇 |
| ブランドトークン有効期限 | BdTokenExp | 4 | 固定 | 半角数字(YYMM) |
〇 ※9 |
|
| クリプトグラム | Cryptogram | 28 | 可変 | 半角英数字記号 |
〇 ※10 |
|
| ブランドトークンECI | BdTokenEci | 2 | 固定 | 半角数字 |
〇 ※10 |
|
| POSエントリーモード | PosEntryMode | 2 | 固定 | 半角数字 |
ブランドトークン項目。 →POSエントリーモード |
〇 ※9 |
| ブランドトークントランザクションID(TID) | TransactionIdentifier | 16 | 可変 | 半角英数字記号 | ブランドトークン項目。 |
〇 ※11 |
| トークンリクエスタID | TokenRequestorId | 11 | 可変 | 半角数字 |
〇 ※12 |
|
| ブランドトークン取引種別 | BdTokenTransactionType | 1 | 固定 | 半角数字 |
ブランドトークン項目。 →ブランドトークン取引種別 |
〇 |
BODY部サンプル
与信売上計上(1Gathering)リクエスト
MerchantId=12346578&MerchantPass=abc123AB&TransactionDate=20090101&OperateId=1Gathering&KaiinId=abcdef&KaiinPass=abcdef&PayType=01&Amount=3000レスポンスパラメーター
◎:必須/○:任意(条件付き必須の場合は注釈あり) /-:セット不要
| 項目名 | パラメーター名 | 桁数 | 形式 | データ型 | 説明 | 設定要領 |
|---|---|---|---|---|---|---|
| 処理通番 | TransactionId | 12 | 固定 | 半角数字 | 処理を識別するコード(e-SCOTTが自動採番)。 | ◎ |
| 取引日付 | TransactionDate | 8 | 固定 | 半角数字(YYYYMMDD) | リクエスト時にセットした値を応答します。 | ◎ |
| 処理区分 | OperateId | - | 可変長 | 半角英数字 | リクエスト時にセットした値を応答します。 | ◎ |
| 加盟店自由領域1 | MerchantFree1 | 64 | 可変 | 全半角文字 | リクエスト時にセットした値を応答します。 | 〇 |
| 加盟店自由領域2 | MerchantFree2 | 64 | 可変 | 全半角文字 | リクエスト時にセットした値を応答します。 | 〇 |
| 加盟店自由領域3 | MerchantFree3 | 64 | 可変 | 全半角文字 | リクエスト時にセットした値を応答します。 | 〇 |
| プロセスID | ProcessId | 32 | 固定 | 半角英数字 | 取引を識別するコード(e-SCOTTが自動採番)。 |
〇 ※1 |
| プロセスパスワード | ProcessPass | 32 | 固定 | 半角英数字 | 取引を識別するパスワード(e-SCOTTが自動採番)。 |
〇 ※1 |
| 処理結果コード | ResponseCd | 200 | 可変 | 半角英数字記号 |
→レスポンスコード 1コード3Byte。コードが複数ある場合はパイプ「|」区切りでセットします。 |
◎ |
| 会員ID | KaiinId | 6~32 | 範囲 | 半角英数字 | カード情報に紐づくID。 |
〇 ※2※4 |
| カード会社コード | CompanyCd | 2 | 固定 | 半角英数字 | カード会社を識別するコード。 |
〇 ※1 |
| 承認番号 | ApproveNo | 7 | 可変 | 半角英数字 | カード会社発番の承認番号。 |
〇 ※1 |
| 認証結果1 | McSecCd | 1 | 固定 | 半角英数字 |
認証アシスト項目の認証結果。 →認証結果一覧 |
〇 ※3 |
| 認証結果2 | McKanaSei | 1 | 固定 | 半角英数字 |
〇 ※3 |
|
| 認証結果3 | McKanaMei | 1 | 固定 | 半角英数字 |
〇 ※3 |
|
| 認証結果4 | McBirthDay | 1 | 固定 | 半角英数字 |
〇 ※3 |
|
| 認証結果5 | McTelNo | 1 | 固定 | 半角英数字 |
〇 ※3 |
|
| 認証結果6 | McSex | 1 | 固定 | 半角英数字 |
〇 ※3 |
|
| 認証結果7 | McBirthYear | 1 | 固定 | 半角英数字 |
〇 ※3 |
|
| 認証結果8 | McPostal | 1 | 固定 | 半角英数字 |
〇 ※3 |
|
| 認証結果9 | McAcntNo1 | 1 | 固定 | 半角英数字 |
〇 ※3 |
|
| 認証結果10 | McAcntNo2 | 1 | 固定 | 半角英数字 |
〇 ※3 |
|
| 認証結果11 | McCardMei | 1 | 固定 | 半角英数字 |
〇 ※3 |
|
| 処理番号 | ProcNo | 7 | 固定 | 半角数字 |
加盟店が取引を識別するための番号(加盟店が採番)。 取引日付、店舗コード単位で一意の番号をセットしてください。 |
〇 |
| ブランドトークン | BdToken | 11~16 | 範囲 | 半角数字 | ブランドトークン項目。 | 〇 |
| ブランドトークン有効期限 | BdTokenExp | 4 | 固定 | 半角数字(YYMM) |
〇 ※5 |
|
| クリプトグラム | Cryptogram | 28 | 可変 | 半角英数字記号 |
〇 ※6 |
|
| ブランドトークンECI | BdTokenEci | 2 | 固定 | 半角数字 |
〇 ※6 |
|
| ブランドトークン仕向判定結果 | BdTokenResponceCd | 1 | 固定 | 半角数字 |
ブランドトークン項目。 →ブランドトークン仕向判定結果 |
〇 ※7 |
| POSエントリーモード | PosEntryMode | 2 | 固定 | 半角数字 |
ブランドトークン項目。 →POSエントリーモード |
〇 ※5 |
| ブランドトークントランザクションID(TID) | TransactionIdentifier | 16 | 可変 | 半角英数字記号 | ブランドトークン項目。 |
〇 ※7※8 |
| トークンリクエスタID | TokenRequestorId | 11 | 可変 | 半角数字 |
〇 ※9 |
|
| ブランドトークン取引種別 | BdTokenTransactionType | 1 | 固定 | 半角数字 |
ブランドトークン項目。 →ブランドトークン取引種別 |
〇 |
BODY部サンプル
与信売上計上(1Gathering)レスポンス
TransactionId=1000000000123&TransactionDate=20090101&OperateId=1Gathering&ProcessId=abcdd12345678ABCDEFG123456789abc&ProcessPass=12345678abcdefghi9876543210ABCDE&ResponseCd=OK&CompanyCd=Y2&ApproveNo=12345673.3.3. Process電文項目定義
売上計上(1Capture)、利用額変更(1Change)、取消(1Delete)、取引参照(1Search)、再オーソリ(1ReAuth)の電文項目の定義は下記のとおりです。
3.3.3.1. 売上計上(1Capture)
リクエストパラメーター
◎:必須/○:任意(条件付き必須の場合は注釈あり) /-:セット不要
| 項目名 | パラメーター名 | 桁数 | 形式 | データ型 | 説明 | 設定要領 |
|---|---|---|---|---|---|---|
| 接続ID | MerchantId | 8 | 固定長 | 半角英数字 | e-SCOTTが加盟店を識別するID(SP.LINKSが発番)。 | ◎ |
| 接続パスワード | MerchantPass | 64 | 固定 | 半角英数字記号大文字小文字 | e-SCOTTが加盟店を認証するパスワード(加盟店が加盟店管理画面で発番)。 | ◎ |
| 取引日付 | TransactionDate | 8 | 固定 | 半角数字(YYYYMMDD) | 当日以前をセットしてください。 | ◎ |
| 処理区分 | OperateId | - | 可変長 | 半角英数字 | →API一覧 | ◎ |
| 加盟店自由領域1 | MerchantFree1 | 64 | 可変 | 全半角文字 |
加盟店が自由に使用できる項目。 半角の「&」「<」「>」「"」「'」 はセットしないでください。 エンドユーザ氏名、電話番号などの個人情報はセットしないでください。 |
〇 |
| 加盟店自由領域2 | MerchantFree2 | 64 | 可変 | 全半角文字 | 〇 | |
| 加盟店自由領域3 | MerchantFree3 | 64 | 可変 | 全半角文字 | 〇 | |
| プロセスID | ProcessId | 32 | 固定 | 半角英数字 | 取引を識別するコード(e-SCOTTが自動採番)。 | ◎ |
| プロセスパスワード | ProcessPass | 32 | 固定 | 半角英数字 | 取引を識別するパスワード(e-SCOTTが自動採番)。 | ◎ |
| 会員ID | KaiinId | 6~32 | 範囲 | 半角英数字 | カード情報に紐づくID。 |
〇 ※1 |
| 会員パスワード | KaiinPass | 6~12 | 範囲 | 半角英数字 | 会員IDに紐づくパスワード。 |
〇 ※1 |
| 処理番号 | ProcNo | 7 | 固定 | 半角数字 |
加盟店が取引を識別するための番号(加盟店が採番)。 取引日付、店舗コード単位で一意の番号をセットしてください。 |
〇 |
BODY部サンプル
売上計上(1Capture)リクエスト
MerchantId=12346578&MerchantPass=abc123AB&TransactionDate=20210301&OperateId=1Capture&ProcessId=836be7571855cb569c82c26e27d90240&ProcessPass=c3a69be33c123c3fa5712f582be98b08レスポンスパラメーター
◎:必須/○:任意(条件付き必須の場合は注釈あり) /-:セット不要
| 項目名 | パラメーター名 | 桁数 | 形式 | データ型 | 説明 | 設定要領 |
|---|---|---|---|---|---|---|
| 処理通番 | TransactionId | 12 | 固定 | 半角数字 | 処理を識別するコード(e-SCOTTが自動採番)。 | ◎ |
| 取引日付 | TransactionDate | 8 | 固定 | 半角数字(YYYYMMDD) | リクエスト時にセットした値を応答します。 | ◎ |
| 処理区分 | OperateId | - | 可変長 | 半角英数字 | リクエスト時にセットした値を応答します。 | ◎ |
| 加盟店自由領域1 | MerchantFree1 | 64 | 可変 | 全半角文字 | リクエスト時にセットした値を応答します。 | 〇 |
| 加盟店自由領域2 | MerchantFree2 | 64 | 可変 | 全半角文字 | リクエスト時にセットした値を応答します。 | 〇 |
| 加盟店自由領域3 | MerchantFree3 | 64 | 可変 | 全半角文字 | リクエスト時にセットした値を応答します。 | 〇 |
| プロセスID | ProcessId | 32 | 固定 | 半角英数字 | 取引を識別するコード。 | ◎ |
| プロセスパスワード | ProcessPass | 32 | 固定 | 半角英数字 | 取引を識別するパスワード。 | ◎ |
| 処理結果コード | ResponseCd | 200 | 可変 | 半角英数字記号 |
→レスポンスコード 1コード3Byte。コードが複数ある場合はパイプ「|」区切りでセットします。 |
◎ |
| カード会社コード | CompanyCd | 2 | 固定 | 半角英数字 | カード会社を識別するコード。 |
〇 ※1 |
| 処理番号 | ProcNo | 7 | 固定 | 半角数字 | リクエスト時にセットした値を応答します。 | 〇 |
BODY部サンプル
売上計上(1Capture)レスポンス
TransactionId=000000000002&TransactionDate=20210301&OperateId=1Capture&ProcessId=836be7571855cb569c82c26e27d90240&ProcessPass=c3a69be33c123c3fa5712f582be98b08&ResponseCd=OK&CompanyCd=Y23.3.3.2. 利用額変更(1Change)
リクエストパラメーター
◎:必須/○:任意(条件付き必須の場合は注釈あり) /-:セット不要
| 項目名 | パラメーター名 | 桁数 | 形式 | データ型 | 説明 | 設定要領 |
|---|---|---|---|---|---|---|
| 接続ID | MerchantId | 8 | 固定長 | 半角英数字 | e-SCOTTが加盟店を識別するID(SP.LINKSが発番)。 | ◎ |
| 接続パスワード | MerchantPass | 64 | 固定 | 半角英数字記号大文字小文字 | e-SCOTTが加盟店を認証するパスワード(加盟店が加盟店管理画面で発番)。 | ◎ |
| 取引日付 | TransactionDate | 8 | 固定 | 半角数字(YYYYMMDD) | 当日以前をセットしてください。 | ◎ |
| 処理区分 | OperateId | - | 可変長 | 半角英数字 | →API一覧 | ◎ |
| 加盟店自由領域1 | MerchantFree1 | 64 | 可変 | 全半角文字 |
加盟店が自由に使用できる項目。 半角の「&」「<」「>」「"」「'」 はセットしないでください。 エンドユーザ氏名、電話番号などの個人情報はセットしないでください。 |
〇 |
| 加盟店自由領域2 | MerchantFree2 | 64 | 可変 | 全半角文字 | 〇 | |
| 加盟店自由領域3 | MerchantFree3 | 64 | 可変 | 全半角文字 | 〇 | |
| プロセスID | ProcessId | 32 | 固定 | 半角英数字 | 取引を識別するコード(e-SCOTTが自動採番)。 | ◎ |
| プロセスパスワード | ProcessPass | 32 | 固定 | 半角英数字 | 取引を識別するパスワード(e-SCOTTが自動採番)。 | ◎ |
| 会員ID | KaiinId | 6~32 | 範囲 | 半角英数字 | カード情報に紐づくID。 |
〇 ※1 |
| 会員パスワード | KaiinPass | 6~12 | 範囲 | 半角英数字 | 会員IDに紐づくパスワード。 |
〇 ※1 |
| 利用金額 | Amount | 8 | 可変 | 半角数字 |
利用金額。 「1(1円)」以上をセットしてください。 |
◎ |
| 処理番号 | ProcNo | 7 | 固定 | 半角数字 |
加盟店が取引を識別するための番号(加盟店が採番)。 取引日付、店舗コード単位で一意の番号をセットしてください。 |
〇 |
| クリプトグラム | Cryptogram | 28 | 可変 | 半角英数字記号 | ブランドトークン項目。 |
〇 ※2※3 |
| POSエントリーモード | PosEntryMode | 2 | 固定 | 半角数字 |
ブランドトークン項目。 →POSエントリーモード |
〇 ※2 |
| ブランドトークントランザクションID(TID) | TransactionIdentifier | 16 | 可変 | 半角英数字記号 | ブランドトークン項目。 |
〇 ※4※5 |
| トークンリクエスタID | TokenRequestorId | 11 | 可変 | 半角数字 |
〇 ※2 |
BODY部サンプル
利用額変更(1Change)リクエスト
MerchantId=12346578&MerchantPass=abc123AB&TransactionDate=20210301&OperateId=1Change&ProcessId=836be7571855cb569c82c26e27d90240&ProcessPass=c3a69be33c123c3fa5712f582be98b08&Amount=3000レスポンスパラメーター
◎:必須/○:任意(条件付き必須の場合は注釈あり) /-:セット不要
| 項目名 | パラメーター名 | 桁数 | 形式 | データ型 | 説明 | 設定要領 |
|---|---|---|---|---|---|---|
| 処理通番 | TransactionId | 12 | 固定 | 半角数字 | 処理を識別するコード(e-SCOTTが自動採番)。 | ◎ |
| 取引日付 | TransactionDate | 8 | 固定 | 半角数字(YYYYMMDD) | リクエスト時にセットした値を応答します。 | ◎ |
| 処理区分 | OperateId | - | 可変長 | 半角英数字 | リクエスト時にセットした値を応答します。 | ◎ |
| 加盟店自由領域1 | MerchantFree1 | 64 | 可変 | 全半角文字 | リクエスト時にセットした値を応答します。 | 〇 |
| 加盟店自由領域2 | MerchantFree2 | 64 | 可変 | 全半角文字 | リクエスト時にセットした値を応答します。 | 〇 |
| 加盟店自由領域3 | MerchantFree3 | 64 | 可変 | 全半角文字 | リクエスト時にセットした値を応答します。 | 〇 |
| プロセスID | ProcessId | 32 | 固定 | 半角英数字 | 取引を識別するコード。 | ◎ |
| プロセスパスワード | ProcessPass | 32 | 固定 | 半角英数字 | 取引を識別するパスワード。 | ◎ |
| 処理結果コード | ResponseCd | 200 | 可変 | 半角英数字記号 |
→レスポンスコード 1コード3Byte。コードが複数ある場合はパイプ「|」区切りでセットします。 |
◎ |
| カード会社コード | CompanyCd | 2 | 固定 | 半角英数字 | カード会社を識別するコード。 |
〇 ※1 |
| 承認番号 | ApproveNo | 7 | 可変 | 半角英数字スペース | 承認番号。 |
〇 ※1 |
| 処理番号 | ProcNo | 7 | 固定 | 半角数字 | リクエスト時にセットした値を応答します。 | 〇 |
| ブランドトークン仕向判定結果 | BdTokenResponceCd | 1 | 固定 | 半角数字 |
ブランドトークン項目。 →ブランドトークン仕向判定結果一覧 |
〇 ※2 |
| ブランドトークントランザクションID(TID) | TransactionIdentifier | 16 | 可変 | 半角英数字記号 | ブランドトークン項目。 |
〇 ※2※3 |
BODY部サンプル
利用額変更(1Change)レスポンス
TransactionId=000000000002&TransactionDate=20210301&OperateId=1Change&ProcessId=836be7571855cb569c82c26e27d90240&ProcessPass=c3a69be33c123c3fa5712f582be98b08&ResponseCd=OK&CompanyCd=Y2&ApproveNo=12345673.3.3.3. 取消(1Delete)
リクエストパラメーター
◎:必須/○:任意(条件付き必須の場合は注釈あり) /-:セット不要
| 項目名 | パラメーター名 | 桁数 | 形式 | データ型 | 説明 | 設定要領 |
|---|---|---|---|---|---|---|
| 接続ID | MerchantId | 8 | 固定長 | 半角英数字 | e-SCOTTが加盟店を識別するID(SP.LINKSが発番)。 | ◎ |
| 接続パスワード | MerchantPass | 64 | 固定 | 半角英数字記号大文字小文字 | e-SCOTTが加盟店を認証するパスワード(加盟店が加盟店管理画面で発番)。 | ◎ |
| 取引日付 | TransactionDate | 8 | 固定 | 半角数字(YYYYMMDD) | 当日以前をセットしてください。 | ◎ |
| 処理区分 | OperateId | - | 可変長 | 半角英数字 | →API一覧 | ◎ |
| 加盟店自由領域1 | MerchantFree1 | 64 | 可変 | 全半角文字 |
加盟店が自由に使用できる項目。 半角の「&」「<」「>」「"」「'」 はセットしないでください。 エンドユーザ氏名、電話番号などの個人情報はセットしないでください。 |
〇 |
| 加盟店自由領域2 | MerchantFree2 | 64 | 可変 | 全半角文字 | 〇 | |
| 加盟店自由領域3 | MerchantFree3 | 64 | 可変 | 全半角文字 | 〇 | |
| プロセスID | ProcessId | 32 | 固定 | 半角英数字 | 取引を識別するコード(e-SCOTTが自動採番)。 | ◎ |
| プロセスパスワード | ProcessPass | 32 | 固定 | 半角英数字 | 取引を識別するパスワード(e-SCOTTが自動採番)。 | ◎ |
| 会員ID | KaiinId | 6~32 | 範囲 | 半角英数字 | カード情報に紐づくID。 |
〇 ※1 |
| 会員パスワード | KaiinPass | 6~12 | 範囲 | 半角英数字 | 会員IDに紐づくパスワード。 |
〇 ※1 |
| 処理番号 | ProcNo | 7 | 固定 | 半角数字 |
加盟店が取引を識別するための番号(加盟店が採番)。 取引日付、店舗コード単位で一意の番号をセットしてください。 |
〇 |
BODY部サンプル
取消(1Delete)リクエスト
MerchantId=12346578&MerchantPass=abc123AB&TransactionDate=20210301&OperateId=1Delete&ProcessId=836be7571855cb569c82c26e27d90240&ProcessPass=c3a69be33c123c3fa5712f582be98b08レスポンスパラメーター
◎:必須/○:任意(条件付き必須の場合は注釈あり) /-:セット不要
| 項目名 | パラメーター名 | 桁数 | 形式 | データ型 | 説明 | 設定要領 |
|---|---|---|---|---|---|---|
| 処理通番 | TransactionId | 12 | 固定 | 半角数字 | 処理を識別するコード(e-SCOTTが自動採番)。 | ◎ |
| 取引日付 | TransactionDate | 8 | 固定 | 半角数字(YYYYMMDD) | リクエスト時にセットした値を応答します。 | ◎ |
| 処理区分 | OperateId | - | 可変長 | 半角英数字 | リクエスト時にセットした値を応答します。 | ◎ |
| 加盟店自由領域1 | MerchantFree1 | 64 | 可変 | 全半角文字 | リクエスト時にセットした値を応答します。 | 〇 |
| 加盟店自由領域2 | MerchantFree2 | 64 | 可変 | 全半角文字 | リクエスト時にセットした値を応答します。 | 〇 |
| 加盟店自由領域3 | MerchantFree3 | 64 | 可変 | 全半角文字 | リクエスト時にセットした値を応答します。 | 〇 |
| プロセスID | ProcessId | 32 | 固定 | 半角英数字 | 取引を識別するコード。 | ◎ |
| プロセスパスワード | ProcessPass | 32 | 固定 | 半角英数字 | 取引を識別するパスワード。 | ◎ |
| 処理結果コード | ResponseCd | 200 | 可変 | 半角英数字記号 |
→レスポンスコード 1コード3Byte。コードが複数ある場合はパイプ「|」区切りでセットします。 |
◎ |
| カード会社コード | CompanyCd | 2 | 固定 | 半角英数字 | カード会社を識別するコード。 |
〇 ※1 |
| 承認番号 | ApproveNo | 7 | 可変 | 半角英数字スペース | 承認番号。 |
〇 ※1 |
| 処理番号 | ProcNo | 7 | 固定 | 半角数字 | リクエスト時にセットした値を応答します。 | 〇 |
| ブランドトークン仕向判定結果 | BdTokenResponceCd | 1 | 固定 | 半角数字 |
ブランドトークン項目。 →ブランドトークン仕向判定結果一覧 |
〇 ※2 |
| ブランドトークントランザクションID(TID) | TransactionIdentifier | 16 | 可変 | 半角英数字記号 | ブランドトークン項目。 |
〇 ※2※3 |
BODY部サンプル
取消(1Delete)レスポンス
TransactionId=000000000002&TransactionDate=20210301&OperateId=1Delete&ProcessId=836be7571855cb569c82c26e27d90240&ProcessPass=c3a69be33c123c3fa5712f582be98b08&ResponseCd=OK&CompanyCd=Y2&ApproveNo=12345673.3.3.4. 取引参照(1Search)
リクエストパラメーター
◎:必須/○:任意(条件付き必須の場合は注釈あり) /-:セット不要
| 項目名 | パラメーター名 | 桁数 | 形式 | データ型 | 説明 | 設定要領 |
|---|---|---|---|---|---|---|
| 接続ID | MerchantId | 8 | 固定長 | 半角英数字 | e-SCOTTが加盟店を識別するID(SP.LINKSが発番)。 | ◎ |
| 接続パスワード | MerchantPass | 64 | 固定 | 半角英数字記号大文字小文字 | e-SCOTTが加盟店を認証するパスワード(加盟店が加盟店管理画面で発番)。 | ◎ |
| 取引日付 | TransactionDate | 8 | 固定 | 半角数字(YYYYMMDD) | 当日以前をセットしてください。 | ◎ |
| 処理区分 | OperateId | - | 可変長 | 半角英数字 | →API一覧 | ◎ |
| 加盟店自由領域1 | MerchantFree1 | 64 | 可変 | 全半角文字 |
加盟店が自由に使用できる項目。 半角の「&」「<」「>」「"」「'」 はセットしないでください。 エンドユーザ氏名、電話番号などの個人情報はセットしないでください。 |
〇 |
| 加盟店自由領域2 | MerchantFree2 | 64 | 可変 | 全半角文字 | 〇 | |
| 加盟店自由領域3 | MerchantFree3 | 64 | 可変 | 全半角文字 | 〇 | |
| プロセスID | ProcessId | 32 | 固定 | 半角英数字 | 取引を識別するコード(e-SCOTTが自動採番)。 |
〇 ※1 |
| プロセスパスワード | ProcessPass | 32 | 固定 | 半角英数字 | 取引を識別するパスワード(e-SCOTTが自動採番)。 |
〇 ※1 |
| 会員ID | KaiinId | 6~32 | 範囲 | 半角英数字 | カード情報に紐づくID。 | 〇 |
| 会員パスワード | KaiinPass | 6~12 | 範囲 | 半角英数字 | 会員IDに紐づくパスワード。 | 〇 |
| 処理番号 | ProcNo | 7 | 固定 | 半角数字 |
加盟店が取引を識別するための番号(加盟店が採番)。 取引日付、店舗コード単位で一意の番号をセットしてください。 |
〇 ※1 |
| 店舗コード | TenantId | 4 | 固定 | 半角数字 |
→店舗コード セットしない場合は「0001」として扱います。 |
〇 ※1 |
BODY部サンプル
取引参照(1Search)リクエスト
MerchantId=12346578&MerchantPass=abc123AB&TransactionDate=20210301&OperateId=1Search&ProcessId=836be7571855cb569c82c26e27d90240&ProcessPass=c3a69be33c123c3fa5712f582be98b08レスポンスパラメーター
◎:必須/○:任意(条件付き必須の場合は注釈あり) /-:セット不要
| 項目名 | パラメーター名 | 桁数 | 形式 | データ型 | 説明 | 設定要領 |
|---|---|---|---|---|---|---|
| 処理通番 | TransactionId | 12 | 固定 | 半角数字 | 処理を識別するコード(e-SCOTTが自動採番)。 | ◎ |
| 取引日付 | TransactionDate | 8 | 固定 | 半角数字(YYYYMMDD) | リクエスト時にセットした値を応答します。 | ◎ |
| 処理区分 | OperateId | - | 可変長 | 半角英数字 | リクエスト時にセットした値を応答します。 | ◎ |
| 加盟店自由領域1 | MerchantFree1 | 64 | 可変 | 全半角文字 | リクエスト時にセットした値を応答します。 | 〇 |
| 加盟店自由領域2 | MerchantFree2 | 64 | 可変 | 全半角文字 | リクエスト時にセットした値を応答します。 | 〇 |
| 加盟店自由領域3 | MerchantFree3 | 64 | 可変 | 全半角文字 | リクエスト時にセットした値を応答します。 | 〇 |
| プロセスID | ProcessId | 32 | 固定 | 半角英数字 | 取引を識別するコード。 |
〇 ※1 |
| プロセスパスワード | ProcessPass | 32 | 固定 | 半角英数字 | 取引を識別するパスワード。 |
〇 ※1 |
| 処理結果コード | ResponseCd | 200 | 可変 | 半角英数字記号 |
→レスポンスコード 1コード3Byte。コードが複数ある場合はパイプ「|」区切りでセットします。 |
◎ |
| 利用金額 | Amount | 8 | 可変 | 半角数字 |
利用金額。 「1(1円)」以上をセットしてください。 |
〇 ※1 |
| 売上計上日 | SalesDate | 8 | 固定 | 半角数字(YYYYMMDD) |
エンドユーザーの利用明細に表示されるカードの利用年月日。 未来日付はセットできません。 |
〇 ※2 |
| カード会社コード | CompanyCd | 2 | 固定 | 半角英数字 | カード会社を識別するコード。 |
〇 ※1 |
| 承認番号 | ApproveNo | 7 | 可変 | 半角英数字スペース | 承認番号。 |
〇 ※1 |
| 処理番号 | ProcNo | 7 | 固定 | 半角数字 | リクエスト時にセットした値を応答します。 | 〇 |
| 参照処理結果コード | RefResponseCd | 200 | 可変 | 半角英数字記号 | 参照した取引の処理結果コード。 |
〇 ※3 |
| ステータス | Status | 2 | 可変 | 半角数字 |
参照した取引のステータス。 →取引ステータス |
〇 ※3 |
| 店舗コード | TenantId | 4 | 固定 | 半角数字 | リクエスト時にセットした値を応答します。 | 〇 |
| 最新区分 | SaisinKbn | 1 | 固定 | 半角数字 | →最新区分 |
〇 ※3 |
BODY部サンプル
取引参照(1Search)レスポンス
TransactionId=000000000003&TransactionDate=20210301&OperateId=1Search&ProcessId=836be7571855cb569c82c26e27d90240&ProcessPass=c3a69be33c123c3fa5712f582be98b08&ResponseCd=OK&Amount=3000&CompanyCd=Y2&ApproveNo=12345673.3.3.5. 再オーソリ(1ReAuth)
リクエストパラメーター
◎:必須/○:任意(条件付き必須の場合は注釈あり) /-:セット不要
| 項目名 | パラメーター名 | 桁数 | 形式 | データ型 | 説明 | 設定要領 |
|---|---|---|---|---|---|---|
| 接続ID | MerchantId | 8 | 固定長 | 半角英数字 | e-SCOTTが加盟店を識別するID(SP.LINKSが発番)。 | ◎ |
| 接続パスワード | MerchantPass | 64 | 固定 | 半角英数字記号大文字小文字 | e-SCOTTが加盟店を認証するパスワード(加盟店が加盟店管理画面で発番)。 | ◎ |
| 取引日付 | TransactionDate | 8 | 固定 | 半角数字(YYYYMMDD) | 当日以前をセットしてください。 | ◎ |
| 処理区分 | OperateId | - | 可変長 | 半角英数字 | →API一覧 | ◎ |
| 加盟店自由領域1 | MerchantFree1 | 64 | 可変 | 全半角文字 |
加盟店が自由に使用できる項目。 半角の「&」「<」「>」「"」「'」 はセットしないでください。 エンドユーザ氏名、電話番号などの個人情報はセットしないでください。 |
〇 |
| 加盟店自由領域2 | MerchantFree2 | 64 | 可変 | 全半角文字 | 〇 | |
| 加盟店自由領域3 | MerchantFree3 | 64 | 可変 | 全半角文字 | 〇 | |
| プロセスID | ProcessId | 32 | 固定 | 半角英数字 | 取引を識別するコード(e-SCOTTが自動採番)。 | ◎ |
| プロセスパスワード | ProcessPass | 32 | 固定 | 半角英数字 | 取引を識別するパスワード(e-SCOTTが自動採番)。 | ◎ |
| 会員ID | KaiinId | 6~32 | 範囲 | 半角英数字 | カード情報に紐づくID。 |
〇 ※2 |
| 会員パスワード | KaiinPass | 6~12 | 範囲 | 半角英数字 | 会員IDに紐づくパスワード。 |
〇 ※2 |
| 利用金額 | Amount | 8 | 可変 | 半角数字 |
利用金額。 「1(1円)」以上をセットしてください。 |
◎ |
| 売上計上日 | SalesDate | 8 | 固定 | 半角数字(YYYYMMDD) |
エンドユーザーの利用明細に表示されるカードの利用年月日。 未来日付はセットできません。 |
〇 ※1 |
| 支払区分 | PayType | 2 | 固定 | 半角数字 | →支払区分 |
〇 ※3 |
| 処理番号 | ProcNo | 7 | 固定 | 半角数字 |
加盟店が取引を識別するための番号(加盟店が採番)。 取引日付、店舗コード単位で一意の番号をセットしてください。 |
〇 |
| クリプトグラム | Cryptogram | 28 | 可変 | 半角英数字記号 | ブランドトークン項目。 |
〇 ※4※5 |
| POSエントリーモード | PosEntryMode | 2 | 固定 | 半角数字 |
ブランドトークン項目。 →POSエントリーモード |
〇 ※4 |
| ブランドトークントランザクションID(TID) | TransactionIdentifier | 16 | 可変 | 半角英数字記号 | ブランドトークン項目。 |
〇 ※6※7 |
| トークンリクエスタID | TokenRequestorId | 11 | 可変 | 半角数字 |
〇 ※4 |
BODY部サンプル
再オーソリ(1ReAuth)リクエスト
MerchantId=12346578&MerchantPass=abc123AB&TransactionDate=20210301&OperateId=1ReAuth&ProcessId=836be7571855cb569c82c26e27d90240&ProcessPass=c3a69be33c123c3fa5712f582be98b08&Amount=3000レスポンスパラメーター
◎:必須/○:任意(条件付き必須の場合は注釈あり) /-:セット不要
| 項目名 | パラメーター名 | 桁数 | 形式 | データ型 | 説明 | 設定要領 |
|---|---|---|---|---|---|---|
| 処理通番 | TransactionId | 12 | 固定 | 半角数字 | 処理を識別するコード(e-SCOTTが自動採番)。 | ◎ |
| 取引日付 | TransactionDate | 8 | 固定 | 半角数字(YYYYMMDD) | リクエスト時にセットした値を応答します。 | ◎ |
| 処理区分 | OperateId | - | 可変長 | 半角英数字 | リクエスト時にセットした値を応答します。 | ◎ |
| 加盟店自由領域1 | MerchantFree1 | 64 | 可変 | 全半角文字 | リクエスト時にセットした値を応答します。 | 〇 |
| 加盟店自由領域2 | MerchantFree2 | 64 | 可変 | 全半角文字 | リクエスト時にセットした値を応答します。 | 〇 |
| 加盟店自由領域3 | MerchantFree3 | 64 | 可変 | 全半角文字 | リクエスト時にセットした値を応答します。 | 〇 |
| プロセスID | ProcessId | 32 | 固定 | 半角英数字 | 取引を識別するコード。 |
◎ ※2 |
| プロセスパスワード | ProcessPass | 32 | 固定 | 半角英数字 | 取引を識別するパスワード。 |
◎ ※2 |
| 処理結果コード | ResponseCd | 200 | 可変 | 半角英数字記号 |
→レスポンスコード 1コード3Byte。コードが複数ある場合はパイプ「|」区切りでセットします。 |
◎ |
| カード会社コード | CompanyCd | 2 | 固定 | 半角英数字 | カード会社を識別するコード。 |
〇 ※1 |
| 承認番号 | ApproveNo | 7 | 可変 | 半角英数字スペース | 承認番号。 |
〇 ※1 |
| 支払区分 | PayType | 2 | 固定 | 半角数字 | リクエスト時にセットした値を応答します。 | 〇 |
| 処理番号 | ProcNo | 7 | 固定 | 半角数字 | リクエスト時にセットした値を応答します。 | 〇 |
| ブランドトークン仕向判定結果 | BdTokenResponceCd | 1 | 固定 | 半角数字 |
ブランドトークン項目。 →ブランドトークン仕向判定結果一覧 |
〇 ※3 |
| ブランドトークントランザクションID(TID) | TransactionIdentifier | 16 | 可変 | 半角英数字記号 | ブランドトークン項目。 |
〇 ※3※4 |
BODY部サンプル
再オーソリ(1ReAuth)レスポンス
TransactionId=000000000002&TransactionDate=20210301&OperateId=1ReAuth&ProcessId=836be7571855cb569c82c26e27d90240&ProcessPass=c3a69be33c123c3fa5712f582be98b08&ResponseCd=OK&CompanyCd=Y2&ApproveNo=12345673.3.4. 売上障害取消電文項目定義
売上障害取消(1Recover)の電文項目の定義は下記のとおりです。
3.3.4.1. 売上障害取消(1Recover)
リクエストパラメーター
◎:必須/○:任意(条件付き必須の場合は注釈あり) /-:セット不要
| 項目名 | パラメーター名 | 桁数 | 形式 | データ型 | 説明 | 設定要領 |
|---|---|---|---|---|---|---|
| 接続ID | MerchantId | 8 | 固定長 | 半角英数字 | e-SCOTTが加盟店を識別するID(ソニーペイメントサービスが発番)。 | ◎ |
| 接続パスワード | MerchantPass | 64 | 固定 | 半角英数字記号大文字小文字 | e-SCOTTが加盟店を認証するパスワード(加盟店が加盟店管理画面で発番)。 | ◎ |
| 取引日付 | TransactionDate | 8 | 固定 | 半角数字(YYYYMMDD) | 当日以前をセットしてください。 |
◎ ※1 |
| 処理区分 | OperateId | - | 可変長 | 半角英数字 | →API一覧 | ◎ |
| 加盟店自由領域1 | MerchantFree1 | 64 | 可変 | 全半角文字 |
加盟店が自由に使用できる項目。 半角の「&」「<」「>」「"」「'」 はセットしないでください。 エンドユーザ氏名、電話番号などの個人情報はセットしないでください。 |
〇 |
| 加盟店自由領域2 | MerchantFree2 | 64 | 可変 | 全半角文字 | 〇 | |
| 加盟店自由領域3 | MerchantFree3 | 64 | 可変 | 全半角文字 | 〇 | |
| 会員ID | KaiinId | 6~32 | 範囲 | 半角英数字 | カード情報に紐づくID。 | 〇 |
| 会員パスワード | KaiinPass | 6~12 | 範囲 | 半角英数字 | 会員IDに紐づくパスワード。 | 〇 |
| 処理番号 | ProcNo | 7 | 固定 | 半角数字 |
加盟店が取引を識別するための番号(加盟店が採番)。 取引日付、店舗コード単位で一意の番号をセットしてください。 |
◎ ※1 |
| 店舗コード | TenantId | 4 | 固定 | 半角数字 |
→店舗コード セットしない場合は「0001」として扱います。 |
◎ ※1 |
BODY部サンプル
売上障害取消(1Recover)リクエスト
MerchantId=12346578&MerchantPass=abc123AB&TransactionDate=20210301&OperateId=1Recover&ProcNo=1234567&TenantId=0001レスポンスパラメーター
◎:必須/○:任意(条件付き必須の場合は注釈あり) /-:セット不要
| 項目名 | パラメーター名 | 桁数 | 形式 | データ型 | 説明 | 設定要領 |
|---|---|---|---|---|---|---|
| 処理通番 | TransactionId | 12 | 固定 | 半角数字 | 処理を識別するコード(e-SCOTTが自動採番)。 | ◎ |
| 取引日付 | TransactionDate | 8 | 固定 | 半角数字(YYYYMMDD) | リクエスト時にセットした値を応答します。 | ◎ |
| 処理区分 | OperateId | - | 可変長 | 半角英数字 | リクエスト時にセットした値を応答します。 | ◎ |
| 加盟店自由領域1 | MerchantFree1 | 64 | 可変 | 全半角文字 | リクエスト時にセットした値を応答します。 | 〇 |
| 加盟店自由領域2 | MerchantFree2 | 64 | 可変 | 全半角文字 | リクエスト時にセットした値を応答します。 | 〇 |
| 加盟店自由領域3 | MerchantFree3 | 64 | 可変 | 全半角文字 | リクエスト時にセットした値を応答します。 | 〇 |
| プロセスID | ProcessId | 32 | 固定 | 半角英数字 | 取引を識別するコード(e-SCOTTが自動採番)。 | 〇 |
| プロセスパスワード | ProcessPass | 32 | 固定 | 半角英数字 | 取引を識別するパスワード(e-SCOTTが自動採番)。 | 〇 |
| 処理結果コード | ResponseCd | 200 | 可変 | 半角英数字記号 |
→レスポンスコード 1コード3Byte。コードが複数ある場合はパイプ「|」区切りでセットします。 |
◎ |
| 処理番号 | ProcNo | 7 | 固定 | 半角数字 | リクエスト時にセットした値を応答します。 | ◎ |
| 店舗コード | TenantId | 4 | 固定 | 半角数字 | リクエスト時にセットした値を応答します。 | ◎ |
| ブランドトークン仕向判定結果 | BdTokenResponceCd | 1 | 固定 | 半角数字 |
ブランドトークン項目。 →ブランドトークン仕向判定結果一覧 |
〇 ※1 |
| ブランドトークントランザクションID(TID) | TransactionIdentifier | 16 | 可変 | 半角英数字記号 | ブランドトークン項目。 |
〇 ※1※2 |
BODY部サンプル
売上障害取消(1Recover)レスポンス
TransactionId=000000000002&TransactionDate=20210301&OperateId=1Recover&ProcessId=836be7571855cb569c82c26e27d90240&ProcessPass=c3a69be33c123c3fa5712f582be98b08&ResponseCd=OK&ProcNo=1234567&TenantId=00013.3.5. 会員情報登録電文項目定義
会員新規(4MemAdd)、会員更新(4MemChg)、会員無効(4MemInval)、会員参照(4MemRef)、会員参照(マスキング)(4MemRefM)、会員参照(同一カード番号返戻)(4MemRefMulti)、トークン会員参照(4MemRefToken)、会員無効解除(4MemUnInval)、会員削除(4MemDel)の電文項目の定義は、下記のとおりです。
3.3.5.1. 会員新規(4MemAdd)
リクエストパラメーター
◎:必須/○:任意(条件付き必須の場合は注釈あり) /-:セット不要
| 項目名 | パラメーター名 | 桁数 | 形式 | データ型 | 説明 | 設定要領 |
|---|---|---|---|---|---|---|
| 接続ID | MerchantId | 8 | 固定長 | 半角英数字 | e-SCOTTが加盟店を識別するID(SP.LINKSが発番)。 | ◎ |
| 接続パスワード | MerchantPass | 64 | 固定 | 半角英数字記号大文字小文字 | e-SCOTTが加盟店を認証するパスワード(加盟店が加盟店管理画面で発番)。 | ◎ |
| 取引日付 | TransactionDate | 8 | 固定 | 半角数字(YYYYMMDD) | 当日以前をセットしてください。 | ◎ |
| 処理区分 | OperateId | - | 可変長 | 半角英数字 | →API一覧 | ◎ |
| 加盟店自由領域1 | MerchantFree1 | 64 | 可変 | 全半角文字 |
加盟店が自由に使用できる項目。 半角の「&」「<」「>」「"」「'」 はセットしないでください。 エンドユーザ氏名、電話番号などの個人情報はセットしないでください。 |
〇 |
| 加盟店自由領域2 | MerchantFree2 | 64 | 可変 | 全半角文字 | 〇 | |
| 加盟店自由領域3 | MerchantFree3 | 64 | 可変 | 全半角文字 | 〇 | |
| 店舗コード | TenantId | 4 | 固定 | 半角数字 |
→店舗コード セットしない場合は「0001」として扱います。 |
〇 ※1 |
| 会員ID | KaiinId | 6~32 | 範囲 | 半角英数字 | カード情報に紐づくID。 |
〇 ※6 |
| 会員パスワード | KaiinPass | 6~12 | 範囲 | 半角英数字 | 会員IDに紐づくパスワード。 | ◎ |
| カード番号 | CardNo | 11~16 | 範囲 | 半角数字 | クレジットカード番号。 |
〇 ※2※7 |
| カード有効期限 | CardExp | 4 | 固定 | 半角数字(YYMM) | クレジットカード有効期限。 |
〇 ※2 |
| カード会社コード | CompanyCd | 2 | 固定 | 半角英数字 | カード会社を識別するコード。 |
〇 ※5 |
| 洗替使用区分 | EnableCheckUseKbn | 1 | 固定 | 半角数字 |
→洗替使用区分 セットしない場合は「0」(洗替対象外)となります。 |
〇 |
| セキュリティコード | SecCd | 3~4 | 範囲 | 半角数字 | 認証アシスト項目。 |
〇 ※4 |
| カナ氏名(姓) | KanaSei | 15 | 可変 | 半角カナ |
〇 ※4 |
|
| カナ氏名(名) | KanaMei | 15 | 可変 | 半角カナ |
〇 ※4 |
|
| 生月日 | BirthDay | 4 | 固定 | 半角数字(MMDD) |
〇 ※4 |
|
| 電話番号 | TelNo | 4 | 固定 | 半角数字 |
〇 ※4 |
|
| 性別 | Sex | 1 | 固定 | 半角英字 |
〇 ※4 |
|
| 生年月日の年 | BirthYear | 4 | 固定 | 半角数字(YYYY) |
〇 ※4 |
|
| 郵便番号 | Postal | 7 | 固定 | 半角数字 |
〇 ※4 |
|
| 銀行口座番号上4桁 | AcntNo1 | 4 | 固定 | 半角数字 |
〇 ※4 |
|
| 銀行口座番号下4桁 | AcntNo2 | 4 | 固定 | 半角数字 |
〇 ※4 |
|
| カード名義 | CardMei | 26 | 可変 | 半角英字記号 |
〇 ※4 |
|
| 3Dメッセージバージョン番号 | MessageVersionNo3D | 10 | 可変 | 半角英数字記号 | 3Dセキュア関連項目。 |
〇 ※8 |
| エンコード済XID | EncodeXId3D | 28 | 可変 | 半角英数字記号 |
〇 ※8 |
|
| ステータス | TransactionStatus3D | 1 | 固定 | 半角英数字 |
〇 ※8 |
|
| CAVV | CAVV3D | 28 | 可変 | 半角英数字記号 |
〇 ※8 |
|
| ECI | ECI3D | 2 | 固定 | 半角英数字 |
〇 ※8 |
|
| カード番号(3D) | PANCardNo3D | 19 | 可変 | 半角英数字 |
〇 ※8※9 |
|
| トークン | Token | 32 | 固定 | 半角英数字 | カード情報の代わりとなる識別子。 |
〇 ※2※3 |
| オーソリ実行フラグ | AuthExecuteFlg | 1 | 固定 | 半角数字 |
会員新規登録時のカード有効性確認の実施要否。 「0」をセットした場合は認証アシスト項目は利用できません。 |
〇 |
| POST用URL | PostUrl | 500 | 可変 | 半角英数字記号 | POST電文の送信先URL。 | 〇 |
| プロセスID | ProcessId | 32 | 固定 | 半角英数字 | 取引を識別するコード(e-SCOTTが自動採番)。 |
〇 ※2※3 |
| プロセスパスワード | ProcessPass | 32 | 固定 | 半角英数字 | 取引を識別するパスワード(e-SCOTTが自動採番)。 |
〇 ※2※3 |
| 会員ID自動採番利用フラグ | KaiinIdAutoRiyoFlg | 1 | 固定 | 半角数字 |
オーソリ会員登録同時実行利用時、会員IDをe-SCOTTで自動採番する場合に使用するフラグ。 利用時は「会員ID」にはブランクをセットしてください。 |
〇 |
| DSトランザクションID | DSTransactionId | 36 | 可変 | 半角英数字記号 | 3Dセキュア関連項目。 |
〇 ※8 |
| 3DSサーバートランザクションID | ThreeDSServerTransactionId | 36 | 可変 | 半角英数字記号 |
〇 ※8 |
|
| ユーザ請求先住所情報 | BillingAddress1 | 50 | 可変 | 半角英数字記号 | 3Dセキュア認証項目。 |
〇 ※10 |
| ユーザ都市 | BillingCity | 50 | 可変 | 半角英数字記号 |
〇 ※10 |
|
| ユーザ国名コード | BillingCountryCode | 3 | 可変 | 半角数字 |
〇 ※10 |
|
| ユーザ郵便番号 | BillingPostalCode | 16 | 可変 | 半角英数字記号 |
〇 ※10 |
|
| ユーザフルネーム | BillingFullName | 2~45 | 可変 | 半角英数字記号スペース |
〇 ※10 |
|
| ユーザEメール | BillingEmail | 254 | 可変 | 半角英数字記号 |
〇 ※10 |
|
| ユーザ電話番号 | BillingPhoneNumber | 20 | 可変 | 半角数字記号 |
〇 ※10 |
|
| ユーザ携帯電話番号 | BillingMobilePhone | 25 | 可変 | 半角数字記号 |
〇 ※10 |
BODY部サンプル
会員新規(4MemAdd)リクエスト
MerchantId=12346578&MerchantPass=abc123AB&TransactionDate=20090101&OperateId=4MemAdd&KaiinId=abcdef&KaiinPass=abcdef&Token=aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaレスポンスパラメーター
◎:必須/○:任意(条件付き必須の場合は注釈あり) /-:セット不要
| 項目名 | パラメーター名 | 桁数 | 形式 | データ型 | 説明 | 設定要領 |
|---|---|---|---|---|---|---|
| 処理通番 | TransactionId | 12 | 固定 | 半角数字 | 処理を識別するコード(e-SCOTTが自動採番)。 | ◎ |
| 取引日付 | TransactionDate | 8 | 固定 | 半角数字(YYYYMMDD) | リクエスト時にセットした値を応答します。 | ◎ |
| 処理区分 | OperateId | - | 可変長 | 半角英数字 | リクエスト時にセットした値を応答します。 | ◎ |
| 加盟店自由領域1 | MerchantFree1 | 64 | 可変 | 全半角文字 | リクエスト時にセットした値を応答します。 | 〇 |
| 加盟店自由領域2 | MerchantFree2 | 64 | 可変 | 全半角文字 | 〇 | |
| 加盟店自由領域3 | MerchantFree3 | 64 | 可変 | 全半角文字 | 〇 | |
| 処理結果コード | ResponseCd | 200 | 可変 | 半角英数字記号 |
→レスポンスコード 1コード3Byte。コードが複数ある場合はパイプ「|」区切りでセットします。 |
◎ |
| 会員ID | KaiinId | 6~32 | 範囲 | 半角英数字 | カード情報に紐づくID。 |
〇 ※1※3 |
| カード会社コード | CompanyCd | 2 | 固定 | 半角英数字 | カード会社を識別するコード。 |
〇 ※1※2 |
| 洗替使用区分 | EnableCheckUseKbn | 1 | 固定 | 半角数字 | リクエスト時にセットした値を応答します。 | 〇 |
| 認証結果1 | McSecCd | 1 | 固定 | 半角数字 |
認証アシスト項目の認証結果。 →認証結果一覧 |
〇 ※1※4 |
| 認証結果2 | McKanaSei | 1 | 固定 | 半角数字 |
〇 ※1※4 |
|
| 認証結果3 | McKanaMei | 1 | 固定 | 半角数字 |
〇 ※1※4 |
|
| 認証結果4 | McBirthDay | 1 | 固定 | 半角数字 |
〇 ※1※4 |
|
| 認証結果5 | McTelNo | 1 | 固定 | 半角数字 |
〇 ※1※4 |
|
| 認証結果6 | McSex | 1 | 固定 | 半角数字 |
〇 ※1※4 |
|
| 認証結果7 | McBirthYear | 1 | 固定 | 半角数字 |
〇 ※1※4 |
|
| 認証結果8 | McPostal | 1 | 固定 | 半角数字 |
〇 ※1※4 |
|
| 認証結果9 | McAcntNo1 | 1 | 固定 | 半角数字 |
〇 ※1※4 |
|
| 認証結果10 | McAcntNo2 | 1 | 固定 | 半角数字 |
〇 ※1※4 |
|
| 認証結果11 | McCardMei | 1 | 固定 | 半角数字 |
〇 ※1※4 |
|
| オーソリ実行フラグ | AuthExecuteFlg | 1 | 固定 | 半角数字 | リクエスト時にセットした値を応答します。 | 〇 |
| プロセスID | ProcessId | 32 | 固定 | 半角英数字 | リクエスト時にセットした値を応答します。 | 〇 |
| プロセスパスワード | ProcessPass | 32 | 固定 | 半角英数字 | リクエスト時にセットした値を応答します。 | 〇 |
| ブランドトークン | BdToken | 11~16 | 範囲 | 半角数字 | ブランドトークン項目。 | 〇 |
| ブランドトークン有効期限 | BdTokenExp | 4 | 固定 | 半角数字(YYMM) | 〇 | |
| 顧客ID | BdTokenCustomerId | 60 | 可変 | 半角英数字記号 | 〇 | |
| 決済手段登録番号 | BdTokenAccountMethod | 2 | 固定 | 半角数字 | 〇 |
BODY部サンプル
会員新規(4MemAdd)レスポンス
TransactionId=000000000123&TransactionDate=20090101&OperateId=4MemAdd&ResponseCd=OK3.3.5.2. 会員更新(4MemChg)
リクエストパラメーター
◎:必須/○:任意(条件付き必須の場合は注釈あり) /-:セット不要
| 項目名 | パラメーター名 | 桁数 | 形式 | データ型 | 説明 | 設定要領 |
|---|---|---|---|---|---|---|
| 接続ID | MerchantId | 8 | 固定長 | 半角英数字 | e-SCOTTが加盟店を識別するID(SP.LINKSが発番)。 | ◎ |
| 接続パスワード | MerchantPass | 64 | 固定 | 半角英数字記号大文字小文字 | e-SCOTTが加盟店を認証するパスワード(加盟店が加盟店管理画面で発番)。 | ◎ |
| 取引日付 | TransactionDate | 8 | 固定 | 半角数字(YYYYMMDD) | 当日以前をセットしてください。 | ◎ |
| 処理区分 | OperateId | - | 可変長 | 半角英数字 | →API一覧 | ◎ |
| 加盟店自由領域1 | MerchantFree1 | 64 | 可変 | 全半角文字 |
本項目をセットしても、会員新規(4MemAdd)で登録済みの値は変更されません。 半角の「&」「<」「>」「"」「'」 はセットしないでください。 エンドユーザ氏名、電話番号などの個人情報はセットしないでください。 |
〇 |
| 加盟店自由領域2 | MerchantFree2 | 64 | 可変 | 全半角文字 | 〇 | |
| 加盟店自由領域3 | MerchantFree3 | 64 | 可変 | 全半角文字 | 〇 | |
| 店舗コード | TenantId | 4 | 固定 | 半角数字 |
→店舗コード セットしない場合は「0001」として扱います。 |
〇 ※1 |
| 会員ID | KaiinId | 6~32 | 範囲 | 半角英数字 | カード情報に紐づくID。 | ◎ |
| 会員パスワード | KaiinPass | 6~12 | 範囲 | 半角英数字 | 会員IDに紐づくパスワード。 | ◎ |
| カード番号 | CardNo | 11~16 | 範囲 | 半角数字 | クレジットカード番号。 |
〇 ※4 |
| カード有効期限 | CardExp | 4 | 固定 | 半角数字(YYMM) | クレジットカード有効期限。 | 〇 |
| 新会員パスワード | NewKaiinPass | 6~12 | 範囲 | 半角英数字 | 会員変更後の会員パスワード。 | 〇 |
| 洗替使用区分 | EnableCheckUseKbn | 1 | 固定 | 半角数字 |
→洗替使用区分 セットしない場合は「0」(洗替対象外)となります。 |
〇 |
| セキュリティコード | SecCd | 3~4 | 範囲 | 半角数字 | 認証アシスト項目。 |
〇 ※3 |
| カナ氏名(姓) | KanaSei | 15 | 可変 | 半角カナ |
〇 ※3 |
|
| カナ氏名(名) | KanaMei | 15 | 可変 | 半角カナ |
〇 ※3 |
|
| 生月日 | BirthDay | 4 | 固定 | 半角数字(MMDD) |
〇 ※3 |
|
| 電話番号 | TelNo | 4 | 固定 | 半角数字 |
〇 ※3 |
|
| 性別 | Sex | 1 | 固定 | 半角英字 |
〇 ※3 |
|
| 生年月日の年 | BirthYear | 4 | 固定 | 半角数字(YYYY) |
〇 ※3 |
|
| 郵便番号 | Postal | 7 | 固定 | 半角数字 |
〇 ※3 |
|
| 銀行口座番号上4桁 | AcntNo1 | 4 | 固定 | 半角数字 |
〇 ※3 |
|
| 銀行口座番号下4桁 | AcntNo2 | 4 | 固定 | 半角数字 |
〇 ※3 |
|
| カード名義 | CardMei | 26 | 可変 | 半角英字記号 |
〇 ※3 |
|
| 3Dメッセージバージョン番号 | MessageVersionNo3D | 10 | 可変 | 半角英数字記号 | 3Dセキュア関連項目。 |
〇 ※5 |
| エンコード済XID | EncodeXId3D | 28 | 可変 | 半角英数字記号 |
〇 ※5 |
|
| ステータス | TransactionStatus3D | 1 | 固定 | 半角英数字 |
〇 ※5 |
|
| CAVV | CAVV3D | 28 | 可変 | 半角英数字記号 |
〇 ※5 |
|
| ECI | ECI3D | 2 | 固定 | 半角英数字 |
〇 ※5 |
|
| カード番号(3D) | PANCardNo3D | 19 | 可変 | 半角英数字 |
〇 ※5※6 |
|
| トークン | Token | 32 | 固定 | 半角英数字 | カード情報の代わりとなる識別子。 |
〇 ※2 |
| オーソリ実行フラグ | AuthExecuteFlg | 1 | 固定 | 半角数字 |
会員新規登録時のカード有効性確認の実施要否。 「0」をセットした場合は認証アシスト項目は利用できません。 |
〇 |
| POST用URL | PostUrl | 500 | 可変 | 半角英数字記号 | POST電文の送信先URL。 | 〇 |
| プロセスID | ProcessId | 32 | 固定 | 半角英数字 | 取引を識別するコード(e-SCOTTが自動採番)。 |
〇 ※2 |
| プロセスパスワード | ProcessPass | 32 | 固定 | 半角英数字 | 取引を識別するパスワード(e-SCOTTが自動採番)。 |
〇 ※2 |
| DSトランザクションID | DSTransactionId | 36 | 可変 | 半角英数字記号 | 3Dセキュア関連項目。 |
〇 ※5 |
| 3DSサーバートランザクションID | ThreeDSServerTransactionId | 36 | 可変 | 半角英数字記号 |
〇 ※5 |
|
| ユーザ請求先住所情報 | BillingAddress1 | 50 | 可変 | 半角英数字記号 | 3Dセキュア認証項目。 |
〇 ※7 |
| ユーザ都市 | BillingCity | 50 | 可変 | 半角英数字記号 |
〇 ※7 |
|
| ユーザ国名コード | BillingCountryCode | 3 | 可変 | 半角数字 |
〇 ※7 |
|
| ユーザ郵便番号 | BillingPostalCode | 16 | 可変 | 半角英数字記号 |
〇 ※7 |
|
| ユーザフルネーム | BillingFullName | 2~45 | 可変 | 半角英数字記号スペース |
〇 ※7 |
|
| ユーザEメール | BillingEmail | 254 | 可変 | 半角英数字記号 |
〇 ※7 |
|
| ユーザ電話番号 | BillingPhoneNumber | 20 | 可変 | 半角数字記号 |
〇 ※7 |
|
| ユーザ携帯電話番号 | BillingMobilePhone | 25 | 可変 | 半角数字記号 |
〇 ※7 |
BODY部サンプル
会員更新(4MemChg)リクエスト
MerchantId=12346578&MerchantPass=abc123AB&TransactionDate=20210301&OperateId=4MemChg&KaiinId=abcdef&KaiinPass=abcdef&Token=aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaレスポンスパラメーター
◎:必須/○:任意(条件付き必須の場合は注釈あり) /-:セット不要
| 項目名 | パラメーター名 | 桁数 | 形式 | データ型 | 説明 | 設定要領 |
|---|---|---|---|---|---|---|
| 処理通番 | TransactionId | 12 | 固定 | 半角数字 | 処理を識別するコード(e-SCOTTが自動採番)。 | ◎ |
| 取引日付 | TransactionDate | 8 | 固定 | 半角数字(YYYYMMDD) | リクエスト時にセットした値を応答します。 | ◎ |
| 処理区分 | OperateId | - | 可変長 | 半角英数字 | リクエスト時にセットした値を応答します。 | ◎ |
| 加盟店自由領域1 | MerchantFree1 | 64 | 可変 | 全半角文字 | リクエスト時にセットした値を応答します。 | 〇 |
| 加盟店自由領域2 | MerchantFree2 | 64 | 可変 | 全半角文字 | 〇 | |
| 加盟店自由領域3 | MerchantFree3 | 64 | 可変 | 全半角文字 | 〇 | |
| 処理結果コード | ResponseCd | 200 | 可変 | 半角英数字記号 |
→レスポンスコード 1コード3Byte。コードが複数ある場合はパイプ「|」区切りでセットします。 |
◎ |
| カード会社コード | CompanyCd | 2 | 固定 | 半角英数字 | カード会社を識別するコード。 |
〇 ※1 |
| 新会員パスワード | NewKaiinPass | 6~12 | 範囲 | 半角英数字 | リクエスト時にセットした値を応答します。 | 〇 |
| 洗替使用区分 | EnableCheckUseKbn | 1 | 固定 | 半角数字 | リクエスト時にセットした値を応答します。 | 〇 |
| 認証結果1 | McSecCd | 1 | 固定 | 半角数字 |
認証アシスト項目の認証結果。 →認証結果一覧 |
〇 ※1※2 |
| 認証結果2 | McKanaSei | 1 | 固定 | 半角数字 |
〇 ※1※2 |
|
| 認証結果3 | McKanaMei | 1 | 固定 | 半角数字 |
〇 ※1※2 |
|
| 認証結果4 | McBirthDay | 1 | 固定 | 半角数字 |
〇 ※1※2 |
|
| 認証結果5 | McTelNo | 1 | 固定 | 半角数字 |
〇 ※1※2 |
|
| 認証結果6 | McSex | 1 | 固定 | 半角数字 |
〇 ※1※2 |
|
| 認証結果7 | McBirthYear | 1 | 固定 | 半角数字 |
〇 ※1※2 |
|
| 認証結果8 | McPostal | 1 | 固定 | 半角数字 |
〇 ※1※2 |
|
| 認証結果9 | McAcntNo1 | 1 | 固定 | 半角数字 |
〇 ※1※2 |
|
| 認証結果10 | McAcntNo2 | 1 | 固定 | 半角数字 |
〇 ※1※2 |
|
| 認証結果11 | McCardMei | 1 | 固定 | 半角数字 |
〇 ※1※2 |
|
| オーソリ実行フラグ | AuthExecuteFlg | 1 | 固定 | 半角数字 | リクエスト時にセットした値を応答します。 | 〇 |
| プロセスID | ProcessId | 32 | 固定 | 半角英数字 | リクエスト時にセットした値を応答します。 | 〇 |
| プロセスパスワード | ProcessPass | 32 | 固定 | 半角英数字 | リクエスト時にセットした値を応答します。 | 〇 |
| ブランドトークン | BdToken | 11~16 | 範囲 | 半角数字 | ブランドトークン項目。 | 〇 |
| ブランドトークン有効期限 | BdTokenExp | 4 | 固定 | 半角数字(YYMM) | 〇 | |
| 顧客ID | BdTokenCustomerId | 60 | 可変 | 半角英数字記号 | 〇 | |
| 決済手段登録番号 | BdTokenAccountMethod | 2 | 固定 | 半角数字 | 〇 |
BODY部サンプル
会員更新(4MemChg)レスポンス
TransactionId=000000000002&TransactionDate=20210301&OperateId=4MemChg&ResponseCd=OK&CompanyCd=Y23.3.5.3. 会員無効(4MemInval)
リクエストパラメーター
◎:必須/○:任意(条件付き必須の場合は注釈あり) /-:セット不要
| 項目名 | パラメーター名 | 桁数 | 形式 | データ型 | 説明 | 設定要領 |
|---|---|---|---|---|---|---|
| 接続ID | MerchantId | 8 | 固定長 | 半角英数字 | e-SCOTTが加盟店を識別するID(SP.LINKSが発番)。 | ◎ |
| 接続パスワード | MerchantPass | 64 | 固定 | 半角英数字記号大文字小文字 | e-SCOTTが加盟店を認証するパスワード(加盟店が加盟店管理画面で発番)。 | ◎ |
| 取引日付 | TransactionDate | 8 | 固定 | 半角数字(YYYYMMDD) | 当日以前をセットしてください。 | ◎ |
| 処理区分 | OperateId | - | 可変長 | 半角英数字 | →API一覧 | ◎ |
| 加盟店自由領域1 | MerchantFree1 | 64 | 可変 | 全半角文字 |
加盟店が自由に使用できる項目。 半角の「&」「<」「>」「"」「'」 はセットしないでください。 エンドユーザ氏名、電話番号などの個人情報はセットしないでください。 |
〇 |
| 加盟店自由領域2 | MerchantFree2 | 64 | 可変 | 全半角文字 | 〇 | |
| 加盟店自由領域3 | MerchantFree3 | 64 | 可変 | 全半角文字 | 〇 | |
| 店舗コード | TenantId | 4 | 固定 | 半角数字 |
→店舗コード セットしない場合は「0001」として扱います。 |
〇 ※1 |
| 会員ID | KaiinId | 6~32 | 範囲 | 半角英数字 | カード情報に紐づくID。 | ◎ |
| 会員パスワード | KaiinPass | 6~12 | 範囲 | 半角英数字 | 会員IDに紐づくパスワード。 | ◎ |
BODY部サンプル
会員無効(4MemInval)リクエスト
MerchantId=12346578&MerchantPass=abc123AB&TransactionDate=20210301&OperateId=4MemInval&KaiinId=abcdef&KaiinPass=abcdefレスポンスパラメーター
◎:必須/○:任意(条件付き必須の場合は注釈あり) /-:セット不要
| 項目名 | パラメーター名 | 桁数 | 形式 | データ型 | 説明 | 設定要領 |
|---|---|---|---|---|---|---|
| 処理通番 | TransactionId | 12 | 固定 | 半角数字 | 処理を識別するコード(e-SCOTTが自動採番)。 | ◎ |
| 取引日付 | TransactionDate | 8 | 固定 | 半角数字(YYYYMMDD) | リクエスト時にセットした値を応答します。 | ◎ |
| 処理区分 | OperateId | - | 可変長 | 半角英数字 | リクエスト時にセットした値を応答します。 | ◎ |
| 加盟店自由領域1 | MerchantFree1 | 64 | 可変 | 全半角文字 | リクエスト時にセットした値を応答します。 | 〇 |
| 加盟店自由領域2 | MerchantFree2 | 64 | 可変 | 全半角文字 | 〇 | |
| 加盟店自由領域3 | MerchantFree3 | 64 | 可変 | 全半角文字 | 〇 | |
| 処理結果コード | ResponseCd | 200 | 可変 | 半角英数字記号 |
→レスポンスコード 1コード3Byte。コードが複数ある場合はパイプ「|」区切りでセットします。 |
◎ |
BODY部サンプル
会員無効(4MemInval)レスポンス
TransactionId=000000000002&TransactionDate=20210301&OperateId=4MemInval&ResponseCd=OK3.3.5.4. 会員参照(4MemRef)
リクエストパラメーター
◎:必須/○:任意(条件付き必須の場合は注釈あり) /-:セット不要
|
項目名 |
パラメーター名 |
桁数 |
形式 |
データ型 |
説明 |
設定要領 |
|---|---|---|---|---|---|---|
|
接続ID |
MerchantId |
8 |
固定長 |
半角英数字 |
e-SCOTTが加盟店を識別するID(SP.LINKSが発番)。 |
◎ |
|
接続パスワード |
MerchantPass |
64 |
固定 |
半角英数字記号大文字小文字 |
e-SCOTTが加盟店を認証するパスワード(加盟店が加盟店管理画面で発番)。 |
◎ |
|
取引日付 |
TransactionDate |
8 |
固定 |
半角数字(YYYYMMDD) |
当日以前をセットしてください。 |
◎ |
|
処理区分 |
OperateId |
- |
可変長 |
半角英数字 |
◎ |
|
|
加盟店自由領域1 |
MerchantFree1 |
64 |
可変 |
全半角文字 |
加盟店が自由に使用できる項目。 |
〇 |
|
加盟店自由領域2 |
MerchantFree2 |
64 |
可変 |
全半角文字 |
〇 |
|
|
加盟店自由領域3 |
MerchantFree3 |
64 |
可変 |
全半角文字 |
〇 |
|
|
店舗コード |
TenantId |
4 |
固定 |
半角数字 |
→店舗コード |
〇 ※1 |
|
会員ID |
KaiinId |
6~32 |
範囲 |
半角英数字 |
カード情報に紐づくID。 |
◎ |
|
会員パスワード |
KaiinPass |
6~12 |
範囲 |
半角英数字 |
会員IDに紐づくパスワード。 |
◎ |
|
3Dセキュア認証項目マスキングフラグ |
SecureItemMaskedFlg |
1 |
固定 |
半角数字 |
〇 |
BODY部サンプル
会員参照(4MemRef)リクエスト
MerchantId=12346578&MerchantPass=abc123AB&TransactionDate=20090101&OperateId=4MemRef&KaiinId=abcdef&KaiinPass=abcdefレスポンスパラメーター
◎:必須/○:任意(条件付き必須の場合は注釈あり) /-:セット不要
| 項目名 | パラメーター名 | 桁数 | 形式 | データ型 | 説明 | 設定要領 |
|---|---|---|---|---|---|---|
| 処理通番 | TransactionId | 12 | 固定 | 半角数字 | 処理を識別するコード(e-SCOTTが自動採番)。 | ◎ |
| 取引日付 | TransactionDate | 8 | 固定 | 半角数字(YYYYMMDD) | リクエスト時にセットした値を応答します。 | ◎ |
| 処理区分 | OperateId | - | 可変長 | 半角英数字 | リクエスト時にセットした値を応答します。 | ◎ |
| 加盟店自由領域1 | MerchantFree1 | 64 | 可変 | 全半角文字 | リクエスト時にセットした値を応答します。 | 〇 |
| 加盟店自由領域2 | MerchantFree2 | 64 | 可変 | 全半角文字 | 〇 | |
| 加盟店自由領域3 | MerchantFree3 | 64 | 可変 | 全半角文字 | 〇 | |
| 処理結果コード | ResponseCd | 200 | 可変 | 半角英数字記号 |
→レスポンスコード 1コード3Byte。コードが複数ある場合はパイプ「|」区切りでセットします。 |
◎ |
| カード番号 | CardNo | 11~16 | 範囲 | 半角数字 | クレジットカード番号。 |
〇 ※1 |
| カード有効期限 | CardExp | 4 | 固定 | 半角数字(YYMM) | クレジットカード有効期限。 |
〇 ※1 |
| カード会社コード | CompanyCd | 2 | 固定 | 半角英数字 | カード会社を識別するコード。 |
〇 ※1 |
| 会員ステータス | KaiinStatus | 1 | 固定 | 半角数字 | →会員ステータス |
〇 ※1 |
| 会員有効日付 | KaiinEnableDate | 8 | 固定 | 半角数字(YYYYMMDD) | 会員のオーソリ実施可能期間。 |
〇 ※2 |
| ユーザ請求先住所情報 | BillingAddress1 | 50 | 可変 | 半角英数字記号 | 3Dセキュア認証項目。 |
〇 ※3 |
| ユーザ都市 | BillingCity | 50 | 可変 | 半角英数字記号 |
〇 ※3 |
|
| ユーザ国名コード | BillingCountryCode | 3 | 可変 | 半角数字 |
〇 ※3 |
|
| ユーザ郵便番号 | BillingPostalCode | 16 | 可変 | 半角英数字記号 |
〇 ※3 |
|
| ユーザフルネーム | BillingFullName | 2~45 | 可変 | 半角英数字記号スペース |
〇 ※3 |
|
| ユーザEメール | BillingEmail | 254 | 可変 | 半角英数字記号 |
〇 ※3 |
|
| ユーザ電話番号 | BillingPhoneNumber | 20 | 可変 | 半角数字記号 |
〇 ※3 |
|
| ユーザ携帯電話番号 | BillingMobilePhone | 25 | 可変 | 半角数字記号 |
〇 ※3 |
BODY部サンプル
会員参照(4MemRef)レスポンス
TransactionId=000000000123&TransactionDate=20090101&OperateId=4MemRef&ResponseCd=OK&CardNo=1234567890123456&CardExp=1305&CompanyCd=ab&KaiinStatus=03.3.5.5. 会員参照(マスキング)(4MemRefM)
リクエストパラメーター
◎:必須/○:任意(条件付き必須の場合は注釈あり) /-:セット不要
| 項目名 | パラメーター名 | 桁数 | 形式 | データ型 | 説明 | 設定要領 |
|---|---|---|---|---|---|---|
| 接続ID | MerchantId | 8 | 固定長 | 半角英数字 | e-SCOTTが加盟店を識別するID(SP.LINKSが発番)。 | ◎ |
| 接続パスワード | MerchantPass | 64 | 固定 | 半角英数字記号大文字小文字 | e-SCOTTが加盟店を認証するパスワード(加盟店が加盟店管理画面で発番)。 | ◎ |
| 取引日付 | TransactionDate | 8 | 固定 | 半角数字(YYYYMMDD) | 当日以前をセットしてください。 | ◎ |
| 処理区分 | OperateId | - | 可変長 | 半角英数字 | →API一覧 | ◎ |
| 加盟店自由領域1 | MerchantFree1 | 64 | 可変 | 全半角文字 |
加盟店が自由に使用できる項目。 半角の「&」「<」「>」「"」「'」 はセットしないでください。 エンドユーザ氏名、電話番号などの個人情報はセットしないでください。 |
〇 |
| 加盟店自由領域2 | MerchantFree2 | 64 | 可変 | 全半角文字 | 〇 | |
| 加盟店自由領域3 | MerchantFree3 | 64 | 可変 | 全半角文字 | 〇 | |
| 店舗コード | TenantId | 4 | 固定 | 半角数字 |
→店舗コード セットしない場合は「0001」として扱います。 |
〇 ※1 |
| 会員ID | KaiinId | 6~32 | 範囲 | 半角英数字 | カード情報に紐づくID。 | ◎ |
| 会員パスワード | KaiinPass | 6~12 | 範囲 | 半角英数字 | 会員IDに紐づくパスワード。 | ◎ |
| カード番号表示桁数 | CardDispLength | 2 | 可変 | 半角数字 |
「カード番号」を応答する際、指定した桁数だけ先頭から番号を表示します(末尾はマスキングされます)。 「0~10」までの範囲で指定してください。 |
〇 |
| 3Dセキュア認証項目マスキングフラグ | SecureItemMaskedFlg | 1 | 固定 | 半角数字 | →3Dセキュア認証項目マスキングフラグコード | 〇 |
BODY部サンプル
会員参照(マスキング)(4MemRefM)リクエスト
MerchantId=12346578&MerchantPass=abc123AB&TransactionDate=20090101&OperateId=4MemRefM&KaiinId=abcdef&KaiinPass=abcdefレスポンスパラメーター
◎:必須/○:任意(条件付き必須の場合は注釈あり) /-:セット不要
| 項目名 | パラメーター名 | 桁数 | 形式 | データ型 | 説明 | 設定要領 |
|---|---|---|---|---|---|---|
| 処理通番 | TransactionId | 12 | 固定 | 半角数字 | 処理を識別するコード(e-SCOTTが自動採番)。 | ◎ |
| 取引日付 | TransactionDate | 8 | 固定 | 半角数字(YYYYMMDD) | リクエスト時にセットした値を応答します。 | ◎ |
| 処理区分 | OperateId | - | 可変長 | 半角英数字 | リクエスト時にセットした値を応答します。 | ◎ |
| 加盟店自由領域1 | MerchantFree1 | 64 | 可変 | 全半角文字 | リクエスト時にセットした値を応答します。 | 〇 |
| 加盟店自由領域2 | MerchantFree2 | 64 | 可変 | 全半角文字 | 〇 | |
| 加盟店自由領域3 | MerchantFree3 | 64 | 可変 | 全半角文字 | 〇 | |
| 処理結果コード | ResponseCd | 200 | 可変 | 半角英数字記号 |
→レスポンスコード 1コード3Byte。コードが複数ある場合はパイプ「|」区切りでセットします。 |
◎ |
| カード番号 | CardNo | 11~16 | 範囲 | 半角数字 | クレジットカード番号。 |
〇 ※1※2 |
| カード有効期限 | CardExp | 4 | 固定 | 半角数字(YYMM) | クレジットカード有効期限。 |
〇 ※1 |
| カード会社コード | CompanyCd | 2 | 固定 | 半角英数字 | カード会社を識別するコード。 |
〇 ※1 |
| 会員ステータス | KaiinStatus | 1 | 固定 | 半角数字 | →会員ステータス |
〇 ※1 |
| 会員有効日付 | KaiinEnableDate | 8 | 固定 | 半角数字(YYYYMMDD) | 会員のオーソリ実施可能期間。 |
〇 ※3 |
| ユーザ請求先住所情報 | BillingAddress1 | 50 | 可変 | 半角英数字記号 | 3Dセキュア認証項目。 |
〇 ※4 |
| ユーザ都市 | BillingCity | 50 | 可変 | 半角英数字記号 |
〇 ※4 |
|
| ユーザ国名コード | BillingCountryCode | 3 | 可変 | 半角数字 |
〇 ※4 |
|
| ユーザ郵便番号 | BillingPostalCode | 16 | 可変 | 半角英数字記号 |
〇 ※4 |
|
| ユーザフルネーム | BillingFullName | 2~45 | 可変 | 半角英数字記号スペース |
〇 ※4 |
|
| ユーザEメール | BillingEmail | 254 | 可変 | 半角英数字記号 |
〇 ※4 |
|
| ユーザ電話番号 | BillingPhoneNumber | 20 | 可変 | 半角数字記号 |
〇 ※4 |
|
| ユーザ携帯電話番号 | BillingMobilePhone | 25 | 可変 | 半角数字記号 |
〇 ※4 |
BODY部サンプル
会員参照(マスキング)(4MemRefM)レスポンス
TransactionId=000000000123&TransactionDate=20090101&OperateId=4MemRefM&ResponseCd=OK&CardNo=1234********3456&CardExp=1305&CompanyCd=ab&KaiinStatus=03.3.5.6. 会員参照(同一カード番号返戻)(4MemRefMulti)
リクエストパラメーター
◎:必須/○:任意(条件付き必須の場合は注釈あり) /-:セット不要
| 項目名 | パラメーター名 | 桁数 | 形式 | データ型 | 説明 | 設定要領 |
|---|---|---|---|---|---|---|
| 接続ID | MerchantId | 8 | 固定長 | 半角英数字 | e-SCOTTが加盟店を識別するID(SP.LINKSが発番)。 | ◎ |
| 接続パスワード | MerchantPass | 64 | 固定 | 半角英数字記号大文字小文字 | e-SCOTTが加盟店を認証するパスワード(加盟店が加盟店管理画面で発番)。 | ◎ |
| 取引日付 | TransactionDate | 8 | 固定 | 半角数字(YYYYMMDD) | 当日以前をセットしてください。 | ◎ |
| 処理区分 | OperateId | - | 可変長 | 半角英数字 | →API一覧 | ◎ |
| 加盟店自由領域1 | MerchantFree1 | 64 | 可変 | 全半角文字 |
加盟店が自由に使用できる項目。 半角の「&」「<」「>」「"」「'」 はセットしないでください。 エンドユーザ氏名、電話番号などの個人情報はセットしないでください。 |
〇 |
| 加盟店自由領域2 | MerchantFree2 | 64 | 可変 | 全半角文字 | 〇 | |
| 加盟店自由領域3 | MerchantFree3 | 64 | 可変 | 全半角文字 | 〇 | |
| 店舗コード | TenantId | 4 | 固定 | 半角数字 |
→店舗コード セットしない場合は「0001」として扱います。 |
〇 ※1 |
| 会員ID | KaiinId | 6~32 | 範囲 | 半角英数字 | カード情報に紐づくID。 | ◎ |
| 会員パスワード | KaiinPass | 6~12 | 範囲 | 半角英数字 | 会員IDに紐づくパスワード。 | ◎ |
| カード番号表示桁数 | CardDispLength | 2 | 可変 | 半角数字 |
「カード番号」を応答する際、指定した桁数だけ先頭から番号を表示します(末尾はマスキングされます)。 「0~10」までの範囲で指定してください。 |
〇 |
BODY部サンプル
会員参照(同一カード番号返戻)(4MemRefMulti)リクエスト
MerchantId=12346578&MerchantPass=abc123AB&TransactionDate=20090101&OperateId=4MemRefMulti&KaiinId=abcdef&KaiinPass=abcdefレスポンスパラメーター
◎:必須/○:任意(条件付き必須の場合は注釈あり) /-:セット不要
| 項目名 | パラメーター名 | 桁数 | 形式 | データ型 | 説明 | 設定要領 |
|---|---|---|---|---|---|---|
| 処理通番 | TransactionId | 12 | 固定 | 半角数字 | 処理を識別するコード(e-SCOTTが自動採番)。 | ◎ |
| 取引日付 | TransactionDate | 8 | 固定 | 半角数字(YYYYMMDD) | リクエスト時にセットした値を応答します。 | ◎ |
| 処理区分 | OperateId | - | 可変長 | 半角英数字 | リクエスト時にセットした値を応答します。 | ◎ |
| 加盟店自由領域1 | MerchantFree1 | 64 | 可変 | 全半角文字 | リクエスト時にセットした値を応答します。 | 〇 |
| 加盟店自由領域2 | MerchantFree2 | 64 | 可変 | 全半角文字 | 〇 | |
| 加盟店自由領域3 | MerchantFree3 | 64 | 可変 | 全半角文字 | 〇 | |
| 処理結果コード | ResponseCd | 200 | 可変 | 半角英数字記号 |
→レスポンスコード 1コード3Byte。コードが複数ある場合はパイプ「|」区切りでセットします。 |
◎ |
| 会員ID | KaiinId | 6~32 | 範囲 | 半角英数字 | カード情報に紐づくID。 |
〇 ※4 |
| カード番号 | CardNo | 11~16 | 範囲 | 半角数字 | クレジットカード番号。 |
〇 ※1※2 |
| カード有効期限 | CardExp | 4 | 固定 | 半角数字(YYMM) | クレジットカード有効期限。 |
〇 ※1 |
| カード会社コード | CompanyCd | 2 | 固定 | 半角英数字 | カード会社を識別するコード。 |
〇 ※1 |
| 会員ステータス | KaiinStatus | 1 | 固定 | 半角数字 | →会員ステータス |
〇 ※1 |
| 会員有効日付 | KaiinEnableDate | 8 | 固定 | 半角数字(YYYYMMDD) | 会員のオーソリ実施可能期間。 |
〇 ※3 |
BODY部サンプル
会員参照(同一カード番号返戻)(4MemRefMulti)レスポンス
TransactionId=000000000123&TransactionDate=20090101&OperateId=4MemRefMulti&ResponseCd=OK&KaiinId=abcdef|test001|test002|test003&CardNo=1234*******3456&CardExp=1305&CompanyCd=ab&KaiinStatus=03.3.5.7. トークン会員参照(4MemRefToken)
リクエストパラメーター
◎:必須/○:任意(条件付き必須の場合は注釈あり) /-:セット不要
| 項目名 | パラメーター名 | 桁数 | 形式 | データ型 | 説明 | 設定要領 |
|---|---|---|---|---|---|---|
| 接続ID | MerchantId | 8 | 固定長 | 半角英数字 | e-SCOTTが加盟店を識別するID(SP.LINKSが発番)。 | ◎ |
| 接続パスワード | MerchantPass | 64 | 固定 | 半角英数字記号大文字小文字 | e-SCOTTが加盟店を認証するパスワード(加盟店が加盟店管理画面で発番)。 | ◎ |
| 取引日付 | TransactionDate | 8 | 固定 | 半角数字(YYYYMMDD) | 当日以前をセットしてください。 | ◎ |
| 処理区分 | OperateId | - | 可変長 | 半角英数字 | →API一覧 | ◎ |
| 加盟店自由領域1 | MerchantFree1 | 64 | 可変 | 全半角文字 |
加盟店が自由に使用できる項目。 半角の「&」「<」「>」「"」「'」 はセットしないでください。 エンドユーザ氏名、電話番号などの個人情報はセットしないでください。 |
〇 |
| 加盟店自由領域2 | MerchantFree2 | 64 | 可変 | 全半角文字 | 〇 | |
| 加盟店自由領域3 | MerchantFree3 | 64 | 可変 | 全半角文字 | 〇 | |
| 店舗コード | TenantId | 4 | 固定 | 半角数字 |
→店舗コード セットしない場合は「0001」として扱います。 |
〇 ※1 |
| トークン | Token | 32 | 固定 | 半角英数字 | カード情報の代わりとなる識別子。 | ◎ |
BODY部サンプル
トークン会員参照(4MemRefToken)リクエスト
MerchantId=12345678&MerchantPass=abc123AB&TransactionDate=20090101&OperateId=4MemRefToken&Token=1234567890abcdefghijklmnopqrstuvレスポンスパラメーター
◎:必須/○:任意(条件付き必須の場合は注釈あり) /-:セット不要
| 項目名 | パラメーター名 | 桁数 | 形式 | データ型 | 説明 | 設定要領 |
|---|---|---|---|---|---|---|
| 処理通番 | TransactionId | 12 | 固定 | 半角数字 | 処理を識別するコード(e-SCOTTが自動採番)。 | ◎ |
| 取引日付 | TransactionDate | 8 | 固定 | 半角数字(YYYYMMDD) | リクエスト時にセットした値を応答します。 | ◎ |
| 処理区分 | OperateId | - | 可変長 | 半角英数字 | リクエスト時にセットした値を応答します。 | ◎ |
| 加盟店自由領域1 | MerchantFree1 | 64 | 可変 | 全半角文字 | リクエスト時にセットした値を応答します。 | 〇 |
| 加盟店自由領域2 | MerchantFree2 | 64 | 可変 | 全半角文字 | 〇 | |
| 加盟店自由領域3 | MerchantFree3 | 64 | 可変 | 全半角文字 | 〇 | |
| 処理結果コード | ResponseCd | 200 | 可変 | 半角英数字記号 |
→レスポンスコード 1コード3Byte。コードが複数ある場合はパイプ「|」区切りでセットします。 |
◎ |
| 会員ID | KaiinId | 6~32 | 範囲 | 半角英数字 | カード情報に紐づくID。 |
〇 ※3 |
| カード番号 | CardNo | 11~16 | 範囲 | 半角数字 | クレジットカード番号。 |
〇 ※1※2 |
| カード有効期限 | CardExp | 4 | 固定 | 半角数字(YYMM) | クレジットカード有効期限。 |
〇 ※1 |
| カード会社コード | CompanyCd | 2 | 固定 | 半角英数字 | カード会社を識別するコード。 |
〇 ※1 |
| トークンステータス | TokenStatus | 1 | 固定 | 半角数字 | →トークンステータス |
〇 ※1 |
BODY部サンプル
トークン会員参照(4MemRefToken)レスポンス
TransactionId=000000000123&TransactionDate=20090101&OperateId=4MemRefToken&ResponseCd=OK&KaiinId=abcdef|test001|test002|test003&CardNo=1234********3456&CardExp=1305&CompanyCd=ab&TokenStatus=03.3.5.8. 会員無効解除(4MemUnInval)
リクエストパラメーター
◎:必須/○:任意(条件付き必須の場合は注釈あり) /-:セット不要
| 項目名 | パラメーター名 | 桁数 | 形式 | データ型 | 説明 | 設定要領 |
|---|---|---|---|---|---|---|
| 接続ID | MerchantId | 8 | 固定長 | 半角英数字 | e-SCOTTが加盟店を識別するID(SP.LINKSが発番)。 | ◎ |
| 接続パスワード | MerchantPass | 64 | 固定 | 半角英数字記号大文字小文字 | e-SCOTTが加盟店を認証するパスワード(加盟店が加盟店管理画面で発番)。 | ◎ |
| 取引日付 | TransactionDate | 8 | 固定 | 半角数字(YYYYMMDD) | 当日以前をセットしてください。 | ◎ |
| 処理区分 | OperateId | - | 可変長 | 半角英数字 | →API一覧 | ◎ |
| 加盟店自由領域1 | MerchantFree1 | 64 | 可変 | 全半角文字 |
加盟店が自由に使用できる項目。 半角の「&」「<」「>」「"」「'」 はセットしないでください。 エンドユーザ氏名、電話番号などの個人情報はセットしないでください。 |
〇 |
| 加盟店自由領域2 | MerchantFree2 | 64 | 可変 | 全半角文字 | 〇 | |
| 加盟店自由領域3 | MerchantFree3 | 64 | 可変 | 全半角文字 | 〇 | |
| 店舗コード | TenantId | 4 | 固定 | 半角数字 |
→店舗コード セットしない場合は「0001」として扱います。 |
〇 ※1 |
| 会員ID | KaiinId | 6~32 | 範囲 | 半角英数字 | カード情報に紐づくID。 | ◎ |
| 会員パスワード | KaiinPass | 6~12 | 範囲 | 半角英数字 | 会員IDに紐づくパスワード。 | ◎ |
BODY部サンプル
会員無効解除(4MemUnInval)リクエスト
MerchantId=12346578&MerchantPass=abc123AB&TransactionDate=20210301&OperateId=4MemUnInval&KaiinId=abcdef&KaiinPass=abcdefレスポンスパラメーター
◎:必須/○:任意(条件付き必須の場合は注釈あり) /-:セット不要
| 項目名 | パラメーター名 | 桁数 | 形式 | データ型 | 説明 | 設定要領 |
|---|---|---|---|---|---|---|
| 処理通番 | TransactionId | 12 | 固定 | 半角数字 | 処理を識別するコード(e-SCOTTが自動採番)。 | ◎ |
| 取引日付 | TransactionDate | 8 | 固定 | 半角数字(YYYYMMDD) | リクエスト時にセットした値を応答します。 | ◎ |
| 処理区分 | OperateId | - | 可変長 | 半角英数字 | リクエスト時にセットした値を応答します。 | ◎ |
| 加盟店自由領域1 | MerchantFree1 | 64 | 可変 | 全半角文字 | リクエスト時にセットした値を応答します。 | 〇 |
| 加盟店自由領域2 | MerchantFree2 | 64 | 可変 | 全半角文字 | 〇 | |
| 加盟店自由領域3 | MerchantFree3 | 64 | 可変 | 全半角文字 | 〇 | |
| 処理結果コード | ResponseCd | 200 | 可変 | 半角英数字記号 |
→レスポンスコード 1コード3Byte。コードが複数ある場合はパイプ「|」区切りでセットします。 |
◎ |
| カード会社コード | CompanyCd | 2 | 固定 | 半角英数字 | カード会社を識別するコード。 |
〇 ※1 |
| ブランドトークン | BdToken | 11~16 | 範囲 | 半角数字 | ブランドトークン項目。 | 〇 |
| ブランドトークン有効期限 | BdTokenExp | 4 | 固定 | 半角数字(YYMM) | 〇 | |
| 顧客ID | BdTokenCustomerId | 60 | 可変 | 半角英数字記号 | 〇 | |
| 決済手段登録番号 | BdTokenAccountMethod | 2 | 固定 | 半角数字 | 〇 |
BODY部サンプル
会員無効解除(4MemUnInval)レスポンス
TransactionId=000000000002&TransactionDate=20210301&OperateId=4MemUnInval&ResponseCd=OK&CompanyCd=Y23.3.5.9. 会員削除(4MemDel)
リクエストパラメーター
◎:必須/○:任意(条件付き必須の場合は注釈あり) /-:セット不要
| 項目名 | パラメーター名 | 桁数 | 形式 | データ型 | 説明 | 設定要領 |
|---|---|---|---|---|---|---|
| 接続ID | MerchantId | 8 | 固定長 | 半角英数字 | e-SCOTTが加盟店を識別するID(SP.LINKSが発番)。 | ◎ |
| 接続パスワード | MerchantPass | 64 | 固定 | 半角英数字記号大文字小文字 | e-SCOTTが加盟店を認証するパスワード(加盟店が加盟店管理画面で発番)。 | ◎ |
| 取引日付 | TransactionDate | 8 | 固定 | 半角数字(YYYYMMDD) | 当日以前をセットしてください。 | ◎ |
| 処理区分 | OperateId | - | 可変長 | 半角英数字 | →API一覧 | ◎ |
| 加盟店自由領域1 | MerchantFree1 | 64 | 可変 | 全半角文字 |
加盟店が自由に使用できる項目。 半角の「&」「<」「>」「"」「'」 はセットしないでください。 エンドユーザ氏名、電話番号などの個人情報はセットしないでください。 |
〇 |
| 加盟店自由領域2 | MerchantFree2 | 64 | 可変 | 全半角文字 | 〇 | |
| 加盟店自由領域3 | MerchantFree3 | 64 | 可変 | 全半角文字 | 〇 | |
| 店舗コード | TenantId | 4 | 固定 | 半角数字 |
→店舗コード セットしない場合は「0001」として扱います。 |
〇 ※1 |
| 会員ID | KaiinId | 6~32 | 範囲 | 半角英数字 | カード情報に紐づくID。 | ◎ |
| 会員パスワード | KaiinPass | 6~12 | 範囲 | 半角英数字 | 会員IDに紐づくパスワード。 | ◎ |
BODY部サンプル
会員削除(4MemDel)リクエスト
MerchantId=12346578&MerchantPass=abc123AB&TransactionDate=20090101&OperateId=4MemDel&KaiinId=abcdef&KaiinPass=abcdefレスポンスパラメーター
◎:必須/○:任意(条件付き必須の場合は注釈あり) /-:セット不要
| 項目名 | パラメーター名 | 桁数 | 形式 | データ型 | 説明 | 設定要領 |
|---|---|---|---|---|---|---|
| 処理通番 | TransactionId | 12 | 固定 | 半角数字 | 処理を識別するコード(e-SCOTTが自動採番)。 | ◎ |
| 取引日付 | TransactionDate | 8 | 固定 | 半角数字(YYYYMMDD) | リクエスト時にセットした値を応答します。 | ◎ |
| 処理区分 | OperateId | - | 可変長 | 半角英数字 | リクエスト時にセットした値を応答します。 | ◎ |
| 加盟店自由領域1 | MerchantFree1 | 64 | 可変 | 全半角文字 | リクエスト時にセットした値を応答します。 | 〇 |
| 加盟店自由領域2 | MerchantFree2 | 64 | 可変 | 全半角文字 | 〇 | |
| 加盟店自由領域3 | MerchantFree3 | 64 | 可変 | 全半角文字 | 〇 | |
| 処理結果コード | ResponseCd | 200 | 可変 | 半角英数字記号 |
→レスポンスコード 1コード3Byte。コードが複数ある場合はパイプ「|」区切りでセットします。 |
◎ |
BODY部サンプル
会員削除(4MemDel)レスポンス
TransactionId=000000000123&TransactionDate=20090101&OperateId=4MemDel&ResponseCd=OK3.3.6. POST電文項目定義
POST電文(オンライン取引Master電文、会員情報登録電文、与信済ステータス取引自動取消)の電文項目の定義は、下記のとおりです。
3.3.6.1. オンライン取引Master電文
パラメーター
◎:必須/○:任意(条件付き必須の場合は注釈あり) /-:セット不要
| 項目名 | パラメーター名 | 桁数 | 形式 | データ型 | 説明 | 設定要領 | |
|---|---|---|---|---|---|---|---|
| IVRシステム | マニュアル送信結果通知 | ||||||
| 接続ID | MerchantId | 8 | 固定長 | 半角英数字 | リクエスト時にセットした値を応答します。 | ◎ | ◎ |
| 処理通番 | TransactionId | 12 | 固定 | 半角数字 | 処理を識別するコード(e-SCOTTが自動採番)。 | ◎ | ◎ |
| 取引日付 | TransactionDate | 8 | 固定 | 半角数字(YYYYMMDD) | リクエスト時にセットした値を応答します。 | ◎ | ◎ |
| 処理区分 | OperateId | - | 可変長 | 半角英数字 | リクエスト時にセットした値を応答します。 | ◎ | ◎ |
| 加盟店自由領域1 | MerchantFree1 | 64 | 可変 | 全半角文字 | リクエスト時にセットした値を応答します。 | 〇 | 〇 |
| 加盟店自由領域2 | MerchantFree2 | 64 | 可変 | 全半角文字 | 〇 | 〇 | |
| 加盟店自由領域3 | MerchantFree3 | 64 | 可変 | 全半角文字 | 〇 | 〇 | |
| プロセスID | ProcessId | 32 | 固定 | 半角英数字 | 取引を識別するコード(e-SCOTTが自動採番)。 | ◎ | ◎ |
| プロセスパスワード | ProcessPass | 32 | 固定 | 半角英数字 | 取引を識別するパスワード(e-SCOTTが自動採番)。 | ◎ | ◎ |
| 処理結果コード | ResponseCd | 200 | 可変 | 半角英数字記号 |
→レスポンスコード 1コード3Byte。コードが複数ある場合はパイプ「|」区切りでセットします。 |
◎ | ◎ |
| 店舗コード | TenantId | 4 | 固定 | 半角数字 | リクエスト時にセットした値を応答します。 |
◎ ※3 |
◎ ※3 |
| 会員ID | KaiinId | 6~32 | 範囲 | 半角英数字 | リクエスト時にセットした値を応答します。 |
〇 ※2 |
〇 ※2 |
| 支払区分 | PayType | 2 | 固定 | 半角数字 | →支払区分 | 〇 | 〇 |
| 利用金額 | Amount | 8 | 可変 | 半角数字 |
利用金額。 「1(1円)」以上をセットしてください。 |
〇 | 〇 |
| カード会社コード | CompanyCd | 2 | 固定 | 半角英数字 | カード会社を識別するコード。 | ◎ | ◎ |
| 承認番号 | ApproveNo | 7 | 可変 | 半角英数字スペース | カード会社発番の承認番号。 | ◎ | ◎ |
| 認証結果1 | McSecCd | 1 | 固定 | 半角数字 |
認証アシスト項目の認証結果。 →認証結果一覧 |
〇 ※1 |
〇 ※1 |
| 認証結果2 | McKanaSei | 1 | 固定 | 半角数字 |
〇 ※1 |
〇 ※1 |
|
| 認証結果3 | McKanaMei | 1 | 固定 | 半角数字 |
〇 ※1 |
〇 ※1 |
|
| 認証結果4 | McBirthDay | 1 | 固定 | 半角数字 |
〇 ※1 |
〇 ※1 |
|
| 認証結果5 | McTelNo | 1 | 固定 | 半角数字 |
〇 ※1 |
〇 ※1 |
|
| 認証結果6 | McSex | 1 | 固定 | 半角数字 |
〇 ※1 |
〇 ※1 |
|
| 認証結果7 | McBirthYear | 1 | 固定 | 半角数字 |
〇 ※1 |
〇 ※1 |
|
| 認証結果8 | McPostal | 1 | 固定 | 半角数字 |
〇 ※1 |
〇 ※1 |
|
| 認証結果9 | McAcntNo1 | 1 | 固定 | 半角数字 |
〇 ※1 |
〇 ※1 |
|
| 認証結果10 | McAcntNo2 | 1 | 固定 | 半角数字 |
〇 ※1 |
〇 ※1 |
|
| 認証結果11 | McCardMei | 1 | 固定 | 半角数字 |
〇 ※1 |
〇 ※1 |
|
| 処理番号 | ProcNo | 7 | 固定 | 半角数字 | リクエスト時にセットした値を応答します。 | 〇 | - |
| POST_ID | PostId | 8 | 可変 | 半角数字 | POST電文を識別するID。 | ◎ | ◎ |
BODY部サンプル
オンライン取引Master電文
MerchantId=12346578&TransactionId=000009979772&TransactionDate=20181003&OperateId=1Auth&ProcessId=5c365146839ac9073550aa3874e5a518&ProcessPass=1deb10981edc0a6ebb02800f1a8348cb&ResponseCd=OK&TenantId=0001&CompanyCd=Y0&ApproveNo=1234567&PostId=123456783.3.6.2. 会員情報登録電文
パラメーター
◎:必須/○:任意(条件付き必須の場合は注釈あり) /-:セット不要
| 項目名 | パラメーター名 | 桁数 | 形式 | データ型 | 説明 | 設定要領 | ||
|---|---|---|---|---|---|---|---|---|
| オーソリなし会員登録 | IVRシステム | マニュアル送信結果通知 | ||||||
| 接続ID | MerchantId | 8 | 固定長 | 半角英数字 | リクエスト時にセットした値を応答します。 | ◎ | ◎ | ◎ |
| 処理通番 | TransactionId | 12 | 固定 | 半角数字 | 処理を識別するコード(e-SCOTTが自動採番)。 | ◎ | ◎ | ◎ |
| 取引日付 | TransactionDate | 8 | 固定 | 半角数字(YYYYMMDD) | リクエスト時にセットした値を応答します。 | ◎ | ◎ | ◎ |
| 処理区分 | OperateId | - | 可変長 | 半角英数字 | リクエスト時にセットした値を応答します。 | ◎ | ◎ | ◎ |
| 加盟店自由領域1 | MerchantFree1 | 64 | 可変 | 全半角文字 | リクエスト時にセットした値を応答します。 | 〇 | 〇 | 〇 |
| 加盟店自由領域2 | MerchantFree2 | 64 | 可変 | 全半角文字 | 〇 | 〇 | 〇 | |
| 加盟店自由領域3 | MerchantFree3 | 64 | 可変 | 全半角文字 | 〇 | 〇 | 〇 | |
| 処理結果コード | ResponseCd | 200 | 可変 | 半角英数字記号 |
→レスポンスコード 1コード3Byte。コードが複数ある場合はパイプ「|」区切りでセットします。 |
◎ | ◎ | ◎ |
| 店舗コード | TenantId | 4 | 固定 | 半角数字 | リクエスト時にセットした値を応答します。 |
◎ ※4 |
◎ ※4 |
◎ ※4 |
| 会員ID | KaiinId | 6~32 | 範囲 | 半角英数字 | リクエスト時にセットした値を応答します。 |
〇 ※3 |
〇 ※3 |
〇 ※3 |
| カード会社コード | CompanyCd | 2 | 固定 | 半角英数字 | カード会社を識別するコード。 |
〇 ※5 |
〇 ※5 |
◎ |
| 洗替使用区分 | EnableCheckUseKbn | 1 | 固定 | 半角数字 | リクエスト時にセットした値を応答します。 | 〇 | 〇 | 〇 |
| 認証結果1 | McSecCd | 1 | 固定 | 半角数字 |
認証アシスト項目の認証結果。 →認証結果一覧 |
〇 ※1 |
〇 ※1 |
〇 ※1 |
| 認証結果2 | McKanaSei | 1 | 固定 | 半角数字 |
〇 ※1 |
〇 ※1 |
〇 ※1 |
|
| 認証結果3 | McKanaMei | 1 | 固定 | 半角数字 |
〇 ※1 |
〇 ※1 |
〇 ※1 |
|
| 認証結果4 | McBirthDay | 1 | 固定 | 半角数字 |
〇 ※1 |
〇 ※1 |
〇 ※1 |
|
| 認証結果5 | McTelNo | 1 | 固定 | 半角数字 |
〇 ※1 |
〇 ※1 |
〇 ※1 |
|
| 認証結果6 | McSex | 1 | 固定 | 半角数字 |
〇 ※1 |
〇 ※1 |
〇 ※1 |
|
| 認証結果7 | McBirthYear | 1 | 固定 | 半角数字 |
〇 ※1 |
〇 ※1 |
〇 ※1 |
|
| 認証結果8 | McPostal | 1 | 固定 | 半角数字 |
〇 ※1 |
〇 ※1 |
〇 ※1 |
|
| 認証結果9 | McAcntNo1 | 1 | 固定 | 半角数字 |
〇 ※1 |
〇 ※1 |
〇 ※1 |
|
| 認証結果10 | McAcntNo2 | 1 | 固定 | 半角数字 |
〇 ※1 |
〇 ※1 |
〇 ※1 |
|
| 認証結果11 | McCardMei | 1 | 固定 | 半角数字 |
〇 ※1 |
〇 ※1 |
〇 ※1 |
|
| POST_ID | PostId | 8 | 可変 | 半角数字 | POST電文を識別するID。 | ◎ | ◎ | ◎ |
| オーソリ実行フラグ | AuthExecuteFlg | 1 | 固定 | 半角数字 | リクエスト時にセットした値を応答します。 | 〇 |
〇 ※2 |
- |
| プロセスID | ProcessId | 32 | 固定 | 半角英数字 | リクエスト時にセットした値を応答します。 | - | 〇 | - |
| プロセスパスワード | ProcessPass | 32 | 固定 | 半角英数字 | リクエスト時にセットした値を応答します。 | - | 〇 | - |
BODY部サンプル
会員情報登録電文
MerchantId=12346578&TransactionId=000009979772&TransactionDate=20181003&OperateId=4MemAdd&ResponseCd=OK&TenantId=0001&CompanyCd=Y0&PostId=123456783.3.6.3. 与信済ステータス取引自動取消
パラメーター
◎:必須/○:任意(条件付き必須の場合は注釈あり) /-:セット不要
|
項目名 |
パラメーター名 |
桁数 |
形式 |
データ型 |
説明 |
設定要領 |
|---|---|---|---|---|---|---|
|
接続ID |
MerchantId |
8 |
固定長 |
半角英数字 |
リクエスト時にセットした値を応答します。 |
◎ |
|
処理通番 |
TransactionId |
12 |
固定 |
半角数字 |
処理を識別するコード(e-SCOTTが自動採番)。 |
◎ |
|
取引日付 |
TransactionDate |
8 |
固定 |
半角数字(YYYYMMDD) |
リクエスト時にセットした値を応答します。 |
◎ |
|
処理区分 |
OperateId |
- |
可変長 |
半角英数字 |
取引の処理内容です。"1Delete"固定。 |
◎ |
|
加盟店自由領域1 |
MerchantFree1 |
64 |
可変 |
全半角文字 |
リクエスト時にセットした値を応答します。 |
〇 |
|
加盟店自由領域2 |
MerchantFree2 |
64 |
可変 |
全半角文字 |
〇 |
|
|
加盟店自由領域3 |
MerchantFree3 |
64 |
可変 |
全半角文字 |
〇 |
|
|
プロセスID |
ProcessId |
32 |
固定 |
半角英数字 |
取引を識別するコード(e-SCOTTが自動採番)。 |
◎ |
|
プロセスパスワード |
ProcessPass |
32 |
固定 |
半角英数字 |
取引を識別するパスワード(e-SCOTTが自動採番)。 |
◎ |
|
処理結果コード |
ResponseCd |
200 |
可変 |
半角英数字記号 |
→レスポンスコード |
◎ |
|
利用金額 |
Amount |
8 |
可変 |
半角数字 |
リクエスト時にセットした値を応答します。 |
〇 |
|
カード会社コード |
CompanyCd |
2 |
固定 |
半角英数字 |
カード会社を識別するコード。 |
◎ |
|
承認番号 |
ApproveNo |
7 |
可変 |
半角英数字スペース |
カード会社発番の承認番号。 |
◎ |
|
処理番号 |
ProcNo |
7 |
固定 |
半角数字 |
リクエスト時にセットした値を応答します。 |
〇 |
|
店舗コード |
TenantId |
4 |
固定 |
半角数字 |
リクエスト時にセットした値を応答します。 |
◎ |
|
元処理区分 |
OriginOperateId |
- |
固定 |
半角英数字 |
リクエスト時にOperateIdにセットした値を応答します。 |
◎ |
BODY部サンプル
与信済ステータス取引自動取消
MerchantId=00000257&TransactionId=000009979772&TransactionDate=20181003&OperateId=1Delete&MerchantFree1=Free1&MerchantFree2=Free2&MerchantFree3=Free3&ProcessId=5c365146839ac9073550aa3874e5a518&ProcessPass=1deb10981edc0a6ebb02800f1a8348cb&ResponseCd=OK&Amount=1000&CompanyCd=Y0&ApproveNo=1234567&ProcNo=1234567&TenantId=0001&OriginOperateId=1Auth3.3.7. 留意事項
3.3.7.1. 取引データの保持期間および後続処理
支払区分がボーナス一括払いの取引データの保持期間は、原則15か月です。その他の場合については、取引データの保持期間を確認してください。
保持期間を経過した取引の確認や後続処理はできません。
3.3.7.2. 後続処理実施可能期間
取引ステータスが「与信済」で、取引に使用したカードの国際ブランドがVISA/Mastercard の取引については、後続処理実施可能期間は取引データの保持期間にかかわらずオーソリ取得日から原則最大20 日間となります。
後続処理実施可能期間を超過した場合、自動取消対象として処理されます(2026 年 9 月以降適用)。
| 取引ステータス | カードブランド | 後続処理実施可能期間 | ||||
|---|---|---|---|---|---|---|
| 与信済 |
|
|
||||
| 上記以外 | - | 取引データの保持期間および後続処理と同様 |
※後続処理実施可能期間を超過した場合(自動取消後を含む)でも、取引データの保持期間内であれば再オーソリ(1ReAuth)は実施可能です。
3.4. コード定義
APIで利用するコード定義は下記のとおりです。
処理結果コード、エラーコード、エラーコード概要については、レスポンスコードを確認してください。
3.4.1. 取引先ステータス
| コード値 | 内容 | 状態 |
|---|---|---|
| 1 | カードチェック済 | クレジットカードの有効性確認済の状態です。 |
| 2 | 与信済 | 与信枠を確保している状態です。 |
| 3 | 売上計上処理済 | 次回売上締めで「カード会社計上済」処理の対象となる状態です。 |
| 4 | 取消処理済 | e-SCOTTの締め処理前に取引がキャンセルされた状態です。 |
| 10 | NG | 取引不成立もしくは処理失敗の状態です。 |
| 11 | 返品処理済 |
e-SCOTTの締め処理後に取引がキャンセルされた状態です。 ※金額がマイナスの「売上計上処理済」レコードが自動作成されます。 |
| 14 | 障害取消済 | 売上障害取消が正常に実施された状態です。 |
| - | カード会社計上済 | e-SCOTTの締め処理が実行された状態です。 |
| - | 参照処理済 | 取引を参照した状態です。 |
| - | オーソリなしデータ登録済 | 売上計上統一フォーマット(NoAuth)を利用して売上計上を行った状態です。 |
| - | 全件オーソリ受付済 | 全件オーソリを受け付けた状態です。 |
| - | 全件オーソリNG | 全件オーソリでNGが発生した状態です。 |
コード値がないものは取引参照(1Search)で応答しません。加盟店管理画面で確認してください。
3.4.2. 会員ステータス
| コード値 | 内容 | 状態 |
|---|---|---|
| 0 | 有効 | 正常な会員です。 |
| 1 | カード無効 | 登録されているカード情報が無効、またはカード会社からのカード情報変更データにより無効になった会員です。 |
| 2 | Login回数無効 | 同日内に同じ会員IDでパスワードを3回間違えた結果、無効になった会員です。 |
| 3 | 会員無効 | 会員情報が無効になった会員です。 |
| 4 | 会員削除 | 会員情報が削除された会員です。 |
3.4.3. 支払区分
| コード値 | 内容 | 説明 |
|---|---|---|
| 01 | 1回払い | |
| 02 | 分割払い(2回) | セット可能回数はカード会社との契約に依存します |
| 03 | 分割払い(3回) | |
| 04 | 分割払い(4回) | |
| 05 | 分割払い(5回) | |
| 06 | 分割払い(6回) | |
| 07 | 分割払い(7回) | |
| 08 | 分割払い(8回) | |
| 09 | 分割払い(9回) | |
| 10 | 分割払い(10回) | |
| 11 | 分割払い(11回) | |
| 12 | 分割払い(12回) | |
| 15 | 分割払い(15回) | |
| 16 | 分割払い(16回) | |
| 18 | 分割払い(18回) | |
| 20 | 分割払い(20回) | |
| 24 | 分割払い(24回) | |
| 30 | 分割払い(30回) | |
| 36 | 分割払い(36回) | |
| 48 | 分割払い(48回) | |
| 54 | 分割払い(54回) | |
| 60 | 分割払い(60回) | |
| 72 | 分割払い(72回) | |
| 84 | 分割払い(84回) | |
| 80 | ボーナス一括払い | |
| 88 | リボルビング払い |
3.4.4. 最新区分
| コード値 | 内容 |
|---|---|
| 0 | 最新(後続処理が行われていない) |
| 1 | 最新ではない(後続処理が行われていない)、またはエラー |
3.4.5. トークンステータス
| コード値 | 内容 | 説明 |
|---|---|---|
| 0 | 有効発行 | 使用可能なトークンです。 |
| 1 | 無効発行 | トークン発行時にエラーが発生し、使用できないトークンです。 |
| 2 | 使用済み | 使用済みのトークンです。 |
| 3 | 有効期限切れ | 有効期限切れのトークンです。 |
3.4.6. POSエントリーモード
| コード値 | 内容 |
|---|---|
| 01 | 都度決済 |
| 10 | 継続課金 |
3.4.7. ブランドトークン取引種別
| コード値 | 内容 |
|---|---|
| 1 | 都度決済 |
| 2 | 継続課金 |
3.4.8. 認証結果
| コード値 | 内容 | 説明 |
|---|---|---|
| 0 | マッチ | カード会社に登録された情報とマッチしました。 |
| 1 | アンマッチ | カード会社に登録された情報と異なる情報でした。 |
| 5 | 代行中 |
当社でオーソリ代行中のためマッチング不可です。 ※カード会社により代行の有無は異なります。 |
| 9 | 照会不可 | カード会社側でマッチングができませんでした。 |
3.4.9. ブランドトークン仕向判定結果
| コード値 | 内容 |
|---|---|
| 0 | e-SCOTTでエラーとなった状態。 |
| 1 | カード会社へカード番号を仕向けた状態。 |
| 2 | カード会社へブランドトークン番号を仕向けた状態。 |
| 3 | 仕向先の確認処理でカード会社へカード番号仕向と判定された状態。 |
| 4 | 仕向先の確認処理でカード会社へブランドトークン番号仕向と判定された状態。 |
3.4.10. 洗替使用区分
| コード値 | 内容 |
|---|---|
| 0 | 洗替しない |
| 1 | 洗替する |
3.4.11. 3Dセキュア認証項目マスキングフラグ
| コード値 | 内容 |
|---|---|
| 0 | マスクしない |
| 1 | マスクする |
3.5. 各種一覧
3.5.1. バッチ処理のスケジュール
クレジットカード決済で利用可能なバッチ処理のスケジュールは、下記のとおりです。
| バッチ処理 | 加盟店 | 当社 | ||
|---|---|---|---|---|
| 処理 | 期限 | 処理 | 期限 | |
| 売上データ送信処理 | 売上計上 | 締日 | カード会社送信 |
締日+2日/固定日 ※ |
| 洗替処理 | 洗替登録 | 毎月4日 | 洗替登録情報更新 | 毎月27日17時 |
| 支払明細データ処理 | - | - | 支払明細データ反映 | 支払日の前日17時 |
| 与信済ステータス取引自動取消 | - | - | 取消 | 後続処理実施可能期間が経過次第実施 |
※カード会社によって送信タイミングが異なります。
3.5.2. POST電文の送信有無
各処理区分のPOST電文の送信有無は、下記のとおりです。
○:通知あり ×:通知なし
| 処理区分 |
Anywhere端末利用時 (オーソリなし会員登録利用時) |
IVRシステム利用時 |
貸出専用端末管理画面 マニュアル送信結果通知利用時 |
|---|---|---|---|
| カードチェック | - | - | ○ |
| 与信 | - | ○ | ○ |
| 与信売上計上 | - | ○ | ○ |
| 会員新規 | ○ | ○ | ○ |
| 会員更新 | - | ○ | - |
3.5.3. アップロード可能なデータ種類
ファイル伝送や加盟店管理画面からアップロード可能なデータ種類は、下記のとおりです。
| データ種類 | 処理内容 |
|---|---|
| カード決済Masterデータ | 「1Check(カードチェック)」、「1Auth(与信)」、「1Gathering(与信売上計上)」の処理データです。 |
| カード決済Processデータ | 「1Change(利用額変更)」、「1Delete(取消)」の処理データです。 |
| 会員情報登録データ | 「4MemAdd(会員新規登録)」、「4MemChg(会員更新)」、「4MemInval(会員無効)」、「4MemDel(会員削除)」の処理データです。 |
| 与信済用売上計上データ | 「与信」ステータスの取引に対する売上計上および取消処理データです。 |
| 売上計上統一フォーマット |
以下が混在する場合の処理データです。 ①「与信」ステータスの取引に対する売上計上処理 ② オーソリを伴わない(元取引のない)売上計上処理 |
4. APPENDIX
4.1. タイムアウト
e-SCOTTから応答がない場合のタイムアウト推奨値は90 秒です。
4.2. 会員ステータスと後続処理結果
各会員ステータスの会員情報を使用した電文の処理結果コードは下記の通りです。
| 会員ステータス | 会員新規 | 会員更新 | 会員無効 |
会員無効 解除 |
会員削除 | 会員参照 |
トークン 会員参照 |
|---|---|---|---|---|---|---|---|
| 有効 | K69 | OK | OK | K73 | K70 | OK | OK |
| カード無効 | K69 | OK | OK | K73 | K70 | OK | OK |
| Login 回数無効 | K69 | K75 | K75 | OK | K70 | K75 | OK |
| 会員無効 | K69 | K75 | OK | OK | OK | OK | OK |
| 会員削除 | K69 | K71 | K71 | K71 | K71 | K71 | K71 |
| 会員ステータス |
カード チェック |
与信 |
与信売上 計上 |
売上計上 |
利用額 変更 |
取消 | 取引参照 | 再オーソリ |
売上障害 取消 |
|---|---|---|---|---|---|---|---|---|---|
| 有効 | OK | OK | OK | OK | OK | OK | OK | OK | OK |
| カード無効 | K79 | K79 | K79 | OK | OK | OK | OK | K79 | OK |
| Login 回数無効 | K79 | K79 | K79 | K79 | K79 | K79 | OK/K79 ※ |
K79 | OK/K79 ※ |
| 会員無効 | K79 | K79 | K79 | OK | OK | OK | OK | K79 | OK |
| 会員削除 | K71 | K71 | K71 | K71 | K71 | K71 | OK/K71 ※ |
K71 | OK/K71 ※ |
※「会員ID」、「会員パスワード」を電文にセットした場合にエラーとなります。
4.3. 会員ID自動採番
会員登録時に会員IDをe-SCOTTが自動採番する機能です。採番した会員IDは電文のレスポンスや加盟店管理画面から確認することができます。
自動で採番する値のルールについては下記の通りです。
| 自動採番会員ID | 加盟店設定文字(1~18桁)+YYMM+e-SCOTT採番値(8桁) |
加盟店設定文字はe-SCOTTのマスタで管理します。カード情報保持単位によって、店舗毎または事業者単位で設定が可能です。
会員ID自動採番を行う場合、会員IDの桁数は最大30桁となります。
4.4. 接続テスト
4.4.1. 簡易折り返しテスト
e-SCOTTとの疎通、および各電文のフォーマットの確認を目的としたテストです。

4.4.2. 設定確認テスト
契約内容に基づくカード会社設定の確認を目的としたテストです。

3Dセキュアを利用する場合は、設定確認テストは利用できません。
