EMV3Dセキュア | 開発者向けサイト - SP.LINKS

お問い合わせプライバシーポリシー企業情報コーポレートサイト

1. EMV3Dセキュアサービスとは

1.1. EMV3Dセキュアサービスとは

オンラインにおけるカード不正利用を防ぐことを目的としたカード業界推奨の本人認証サービスです。
各カード会社からお客様に対して、直接カード会社所定の認証方式による認証手続の要求がなされ、その認証結果を貴社に通知します。

対応ブランド

ブランド	サービス名
JCB	J/Secure™
VISA	Visa Secure
MasterCard	Mastercard ID Check™
AMEX	American Express SafeKey®
Diners	ProtectBuy

2. インターフェイス概要

2.1. 利用可能なインターフェイス

EMV3Dセキュアサービスで利用できるインターフェイスは、「オンライン」「加盟店管理画面」です。

3. インターフェイス詳細

3.1. API一覧

EMV3DセキュアサービスのAPIは下記のとおりです。

処理区分		コード値	説明	電文種類	可能な後続処理
処理区分		コード値	説明	電文種類	可能な後続処理
3Dセキュア認証		3Secure	3Dセキュア認証のみを行う機能後続処理にて3Dセキュア認証結果をセットする必要があります。	3Dセキュア認証電文	クレジットカード決済サービス「カードチェック」「与信」「与信売上計上」「会員新規」「会員更新」
カードチェック		1Check	3Dセキュア認証およびカードの有効性を確認（入会オーソリ）する機能	3Dセキュア認証カード決済Master電文	3Dセキュア認証サービス「3Dセキュア認証処理結果参照」
与信		1Auth	3Dセキュア認証およびカードの与信枠を確保（売上オーソリ）する機能	3Dセキュア認証カード決済Master電文	3Dセキュア認証サービス「3Dセキュア認証処理結果参照」クレジットカード決済サービス「売上計上」「利用額変更」「取消」「再オーソリ」「取引参照」
与信売上計上		1Gathering	3Dセキュア認証および与信枠確保、与信の確定を行う機能	3Dセキュア認証カード決済Master電文	3Dセキュア認証サービス「3Dセキュア認証処理結果参照」クレジットカード決済サービス「利用額変更」「取消」「再オーソリ」「取引参照」
3Dセキュア認証処理結果参照		3Search	3Dセキュア認証の状態を確認する機能	3Dセキュア認証カード決済Process電文	‐
会員新規		4MemAdd	3Dセキュア認証およびe-SCOTTにカード情報を登録する機能。	3Dセキュア認証会員情報登録電文	3Dセキュア認証サービス「会員更新」クレジットカード決済サービス「会員無効」「会員参照」
会員更新		4MemChg	3Dセキュア認証およびカード情報を更新する機能。	3Dセキュア認証会員情報登録電文	3Dセキュア認証サービス「会員更新」クレジットカード決済サービス「会員無効」「会員参照」

3.2. 処理フロー

EMV3Dセキュアサービスの処理フローについて、処理区分ごとに説明します。

3.2.1. 3Secure（3Dセキュア認証）

処理フロー

①～⑤の順序で3Secure（3Dセキュア認証）の処理が行われます。

処理内容

No.	処理内容	加盟店側実装
①	3Dセキュア認証電文に必要項目をセットし、加盟店からe-SCOTTにリダイレクトで送信します。	○
②	e-SCOTTがカード会社に3Dセキュア認証対応有無確認リクエストを送信します。
③	e-SCOTTが処理中画面をエンドユーザー端末に表示し、カード会社がブラウザ情報を取得します。
④	カード会社が認証画面をエンドユーザー端末に表示し、エンドユーザーがカード会社所定の認証方法で認証手続きを行います。
⑤	認証結果をe-SCOTTが受信します。
⑥	認証結果をe-SCOTTから加盟店に応答します。	○

※3Dセキュア認証後にオーソリ処理を行う場合は、クレジットカード決済のAPIを使用してください。
→クレジットカード決済API一覧

3.2.2. 1Check（カードチェック）

処理フロー

①～⑥の順序で1Check（カードチェック）の処理が行われます。

処理内容

No.	処理内容	加盟店側実装
①	Master電文に必要項目をセットし、加盟店からe-SCOTTにリダイレクトで送信します。	○
②	e-SCOTTがカード会社に3Dセキュア認証対応有無確認リクエストを送信します。認証アシストサービスを利用する場合は事前にカードの有効性を確認します。※
③	e-SCOTTが処理中画面をエンドユーザー端末に表示し、カード会社がブラウザ情報を取得します。
④	カード会社が認証画面をエンドユーザー端末に表示し、エンドユーザーがカード会社所定の認証方法で認証手続きを行います。
⑤	認証結果をe-SCOTTが受信します。
⑥	認証結果を使用して、e-SCOTTがオーソリ処理を行います。
⑦	処理結果をe-SCOTTから加盟店に応答します。	○

※カード有効性確認結果がNGの場合は、3D認証を実施せずエラーを応答します。

3.2.3. 1Auth（与信）

処理フロー

3.2.2 1Check（カードチェック）と同様の処理が行われます。

処理内容

3.2.2 1Check（カードチェック）と同様の処理内容です。

3.2.4. 1Gathering（与信売上計上）

処理フロー

3.2.2 1Check（カードチェック）と同様の処理が行われます。

処理内容

3.2.2 1Check（カードチェック）と同様の処理内容です。

3.2.5. 3Search（3Dセキュア認証処理結果参照）

処理フロー

クレジットカード決済3.2.4 1Capture（売上計上）と同様の処理が行われます。

処理内容

クレジットカード決済3.2.4 1Capture（売上計上）と同様の処理内容です。

3.2.6. 4MemAdd（会員新規）

処理フロー

①～⑥の順序で4MemAdd（会員新規）の処理が行われます。

処理内容

No.	処理内容	加盟店側実装
①	会員情報登録電文に必要項目をセットし、加盟店からe-SCOTTにリダイレクトで送信します。	○
②	e-SCOTTがカード会社に3Dセキュア認証対応有無確認リクエストを送信します。認証アシストを行う場合は事前にカードの有効性を確認します。※
③	e-SCOTTが処理中画面をエンドユーザー端末に表示し、カード会社がブラウザ情報を取得します。
④	カード会社が認証画面をエンドユーザー端末に表示し、エンドユーザーがカード会社所定の認証方法で認証手続きを行います。
⑤	認証結果をe-SCOTTが受信します。
⑥	認証結果を使用して、e-SCOTTが入会オーソリ処理を行います。
⑦	処理結果をe-SCOTTから加盟店に応答します。	○

※カード有効性確認結果がNGの場合は、3D認証を実施せずエラーを応答します。

3.2.7. 4MemChg（会員更新）

処理フロー

3.2.6 4MemAdd（会員新規）と同様の処理が行われます。

処理内容

3.2.6 4MemAdd（会員新規）と同様の処理内容です。

3.3. API仕様

e-SCOTTのAPI仕様について説明します。

3.3.1. 接続先URL

3Dセキュア認証電文・Master電文・Process電文・会員情報登録電文の接続先URLは、下記のとおりです。

環境	接続先URL
テスト環境	契約後に管理画面から確認してください
本番環境	契約後に管理画面から確認してください

POST電文の通知先URLは、下記のとおりです。

電文種別	通知先URL
3Dセキュア認証電文	電文項目の「POST用URL」に設定したURL
Master電文
会員情報登録電文

3.3.2. 3Dセキュア認証電文項目定義

3Secure（3Dセキュア認証）の電文項目は下記のとおりです。

3.3.2.1. 3Secure（3Dセキュア認証）

リクエストパラメーター

◎：必須／○：任意（条件付き必須の場合は注釈あり）／－：セット不要

項目名	パラメーター名	桁数	形式	データ型	説明	設定要領
接続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」として扱います。	〇
会員ID	KaiinId	6～32	範囲	半角英数字	カード情報に紐づくID。	〇 ※1※4
会員パスワード	KaiinPass	6～12	範囲	半角英数字	会員IDに紐づくパスワード。	〇 ※1※4
カード番号	CardNo	11～16	範囲	半角数字	クレジットカード番号。 PCIDSSに準拠していない場合、使用できません。	〇 ※1※5
カード有効期限	CardExp	4	固定	半角数字(YYMM)	クレジットカード有効期限。	〇 ※1※5
利用金額	Amount	8	可変	半角数字	利用金額。「1（1円）」以上をセットしてください。	◎
処理番号	ProcNo	7	固定	半角数字	加盟店が取引を識別するための番号（加盟店が採番）。取引日付、店舗コード単位で一意の番号をセットしてください。	◎
リダイレクト用URL	RedirectUrl	500	固定	半角数字	3Dセキュア認証からのリダイレクト先URL。	◎
POST用URL	PostUrl	500	固定	半角数字	POST電文の送信先URL。エンドユーザのリダイレクトが受け取れなかった場合などのリカバリとして設定を推奨します。	〇
トークン	Token	32	固定	半角数字	カード情報の代わりとなる識別子。	〇 ※1※4
ユーザ請求先住所情報	BillingAddress1	50	可変	半角英数字記号	3Dセキュア認証項目。	〇 ※4
ユーザ都市	BillingCity	50	可変	半角英数字記号		〇 ※4
ユーザ国名コード	BillingCountryCode	3	可変	半角数字		〇 ※4
ユーザ名	BillingFirstName	2～22	範囲	半角英数字記号		〇 ※2
ユーザ姓	BillingLastName	2～22	範囲	半角英数字記号		〇 ※2
ユーザ郵便番号	BillingPostalCode	16	可変	半角英数字記号		〇 ※4
ユーザフルネーム	BillingFullName	2～45	範囲	半角英数字記号スペース		〇 ※2※4
ユーザEメール	BillingEmail	254	可変	半角英数字記号		〇 ※3※4
ユーザ電話番号	BillingPhoneNumber	20	可変	半角数字記号		〇 ※3※4
ユーザ携帯電話番号	BillingMobilePhone	25	可変	半角数字記号		〇 ※3※4
チャレンジインジケーター	ChallengeInd	2	固定	半角数字		〇
ターゲット属性フラグ	TargetAttributeFlg	1	固定	半角数字		〇
ブランドトークン	BdToken	11～16	範囲	半角数字	ブランドトークン項目（オプション機能）。	〇
ブランドトークン有効期限	BdTokenExp	4	固定	半角数字(YYMM)	ブランドトークン項目（オプション機能）。	〇 ※5

BODY部サンプル

3Secure（3Dセキュア認証）リクエスト

MerchantId=12346578&MerchantPass=abc123AB&OperateId=3Secure&TransactionDate=20210301&KaiinId=abcdef&KaiinPass=abcdef&Amount=1000&ProcNo=0000001&RedirectUrl=https://XXXXXXX&PostUrl=https://XXXXXXX&BillingFullName=fullname&BillingPhoneNumber=1234

レスポンスパラメーター

◎：必須／○：任意（条件付き必須の場合は注釈あり）／－：セット不要

項目名	パラメーター名	桁数	形式	データ型	説明	設定要領
処理通番	TransactionId	12	固定	半角数字	処理を識別するコード（e-SCOTTが自動採番）。	◎
取引日付	TransactionDate	8	固定	半角数字(YYYYMMDD)	リクエスト時にセットした値を応答します。	◎
処理区分	OperateId	－	可変長	半角英数字	リクエスト時にセットした値を応答します。	◎
加盟店自由領域1	MerchantFree1	64	可変	全半角文字	リクエスト時にセットした値を応答します。	〇
加盟店自由領域2	MerchantFree2	64	可変	全半角文字	リクエスト時にセットした値を応答します。	〇
加盟店自由領域3	MerchantFree3	64	可変	全半角文字	リクエスト時にセットした値を応答します。	〇
処理結果コード	ResponseCd	200	可変	半角英数字記号	→レスポンスコード 1コード3Byte。コードが複数ある場合はパイプ「｜」区切りでセットします。	◎
3Dメッセージバージョン番号	MessageVersionNo3D	10	可変	半角英数字記号	3Dセキュア関連項目。	〇
エンコード済XID	EncodeXId3D	28	可変	半角英数字記号	3Dセキュア関連項目。	〇
ステータス	TransactionStatus3D	1	固定	半角英数字	3Dセキュア関連項目。 →トランザクションステータス	〇
CAVV	CAVV3D	28	可変	半角英数字記号	3Dセキュア関連項目。	〇
ECI	ECI3D	2	固定	半角英数字	3Dセキュア関連項目。 →ECI	〇
処理番号	ProcNo	7	固定	半角数字	リクエスト時にセットした値を応答します。	◎
3Dセキュア認証結果コード	SecureResultCode	1	固定	半角数字	3D セキュア関連項。 →3Dセキュア認証結果コード	◎
DSトランザクションID	DSTransactionId	36	可変	半角英数字記号	3D セキュア関連項。	〇
3DSサーバートランザクションID	ThreeDSServerTransactionId	36	可変	半角英数字記号	3D セキュア関連項。	〇
ブランドトークン	BdToken	11～16	範囲	半角数字	リクエスト時にセットした値を応答します。	〇
ブランドトークン有効期限	BdTokenExp	4	固定	半角数字(YYMM)	リクエスト時にセットした値を応答します。	〇 ※1
ブランドトークン仕向判定結果	BdTokenResponceCd	1	固定	半角数字	ブランドトークン項目（オプション機能）。 →ブランドトークン仕向判定結果	〇 ※2

BODY部サンプル

3Secure（3Dセキュア認証）レスポンス

TransactionId=1000000000123&TransactionDate=20090101&OperateId=3Secure&ResponseCd=OK&ProcNo=0000001&SecureResultCode=0

3.3.3. Master電文項目定義

1Check（カードチェック）、1Auth（与信）、1Gathering（与信売上計上）の電文項目は下記のとおりです。

3.3.3.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」として扱います。	〇
会員ID	KaiinId	6～32	範囲	半角英数字	カード情報に紐づくID。	〇 ※1※4
会員パスワード	KaiinPass	6～12	範囲	半角英数字	会員IDに紐づくパスワード。	〇 ※1※4
カード番号	CardNo	11～16	範囲	半角数字	クレジットカード番号。 PCIDSSに準拠していない場合、使用できません。	〇 ※1※5
カード有効期限	CardExp	4	固定	半角数字(YYMM)	クレジットカード有効期限。	〇 ※1※5
セキュリティコード	SecCd	3～4	範囲	半角数字	認証アシスト項目。	〇 ※7
カナ氏名（姓）	KanaSei	15	可変	半角カナ		〇 ※7
カナ氏名（名）	KanaMei	15	可変	半角カナ		〇 ※7
生月日	BirthDay	4	固定	半角数字(MMDD)		〇 ※7
電話番号	TelNo	4	固定	半角数字		〇 ※7
処理番号	ProcNo	7	固定	半角数字	加盟店が取引を識別するための番号（加盟店が採番）。取引日付、店舗コード単位で一意の番号をセットしてください。	◎
リダイレクト用URL	RedirectUrl	500	固定	半角数字	3Dセキュア認証からのリダイレクト先URL。	◎
POST用URL	PostUrl	500	固定	半角数字	POST電文の送信先URL。エンドユーザのリダイレクトが受け取れなかった場合などのリカバリとして設定を推奨します。	〇
トークン	Token	32	固定	半角数字	カード情報の代わりとなる識別子。	〇 ※1※4
ユーザ請求先住所情報	BillingAddress1	50	可変	半角英数字記号	3Dセキュア認証項目。	〇 ※4
ユーザ都市	BillingCity	50	可変	半角英数字記号		〇 ※4
ユーザ国名コード	BillingCountryCode	3	可変	半角数字		〇 ※4
ユーザ名	BillingFirstName	2～22	範囲	半角英数字記号		〇 ※2
ユーザ姓	BillingLastName	2～22	範囲	半角英数字記号		〇 ※2
ユーザ郵便番号	BillingPostalCode	16	可変	半角英数字記号		〇 ※4
ユーザフルネーム	BillingFullName	2～45	範囲	半角英数字記号スペース		〇 ※2※4
ユーザEメール	BillingEmail	254	可変	半角英数字記号		〇 ※3※4
ユーザ電話番号	BillingPhoneNumber	20	可変	半角数字記号		〇 ※3※4
ユーザ携帯電話番号	BillingMobilePhone	25	可変	半角数字記号		〇 ※3※4
チャレンジインジケーター	ChallengeInd	2	固定	半角数字		〇
ターゲット属性フラグ	TargetAttributeFlg	1	固定	半角数字		〇
ブランドトークン	BdToken	11～16	範囲	半角数字	ブランドトークン項目（オプション機能）。	〇
ブランドトークン有効期限	BdTokenExp	4	固定	半角数字(YYMM)		〇 ※5
クリプトグラム	Cryptogram	28	可変	半角英数字記号		〇 ※6
ブランドトークンECI	BdTokenEci	2	固定	半角数字		〇 ※6
POSエントリーモード	PosEntryMode	2	固定	半角数字	ブランドトークン項目（オプション機能）。 →POSエントリーモード	〇 ※5
トークンリクエスタID	TokenRequestorId	11	可変	半角数字	ブランドトークン項目（オプション機能）。	〇 ※6

BODY部サンプル

カードチェック(1Check)リクエスト

MerchantId=12346578&MerchantPass=abc123AB&OperateId=1Check&TransactionDate=20210301&KaiinId=abcdef&KaiinPass=abcdef&ProcNo=0000001&RedirectUrl=https://XXXXXXX&PostUrl=https://XXXXXXX&BillingFullName=fullname&BillingPhoneNumber=1234

レスポンスパラメーター

◎：必須／○：任意（条件付き必須の場合は注釈あり）／－：セット不要

項目名	パラメーター名	桁数	形式	データ型	説明	設定要領
処理通番	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。コードが複数ある場合はパイプ「｜」区切りでセットします。	◎
3Dメッセージバージョン番号	MessageVersionNo3D	10	可変	半角英数字記号	3Dセキュア関連項目。	〇
エンコード済XID	EncodeXId3D	28	可変	半角英数字記号	3Dセキュア関連項目。	〇
ステータス	TransactionStatus3D	1	固定	半角英数字	3Dセキュア関連項目。 →トランザクションステータス	〇
CAVV	CAVV3D	28	可変	半角英数字記号	3Dセキュア関連項目。	〇
ECI	ECI3D	2	固定	半角英数字	3Dセキュア関連項目。 →ECI	〇
カード会社コード	CompanyCd	2	固定	半角英数字	カード会社を識別するコード。	〇 ※1
承認番号	ApproveNo	7	可変	半角英数字スペース	カード会社発番の承認番号。	◎ ※1
認証結果1	McSecCd	1	固定	半角数字	認証アシスト項目の認証結果。 →認証結果一覧	〇 ※6
認証結果2	McKanaSei	1	固定	半角数字		〇 ※6
認証結果3	McKanaMei	1	固定	半角数字		〇 ※6
認証結果4	McBirthDay	1	固定	半角数字		〇 ※6
認証結果5	McTelNo	1	固定	半角数字		〇 ※6
処理番号	ProcNo	7	固定	半角数字	リクエスト時にセットした値を応答します。	◎
3Dセキュア認証結果コード	SecureResultCode	1	固定	半角数字	3D セキュア関連項。 →3Dセキュア認証結果コード	◎
DSトランザクションID	DSTransactionId	36	可変	半角英数字記号	3D セキュア関連項。	〇
3DSサーバートランザクションID	ThreeDSServerTransactionId	36	可変	半角英数字記号	3D セキュア関連項。	〇
ブランドトークン	BdToken	11～16	範囲	半角数字	リクエスト時にセットした値を応答します。	〇
ブランドトークン有効期限	BdTokenExp	4	固定	半角数字(YYMM)	リクエスト時にセットした値を応答します。	〇 ※2
クリプトグラム	Cryptogram	28	可変	半角英数字記号	リクエスト時にセットした値を応答します。	〇 ※3
ブランドトークンECI	BdTokenEci	2	固定	半角数字	リクエスト時にセットした値を応答します。	〇 ※3
ブランドトークン仕向判定結果	BdTokenResponceCd	1	固定	半角数字	ブランドトークン項目（オプション機能）。 →ブランドトークン仕向判定結果	〇 ※4
POSエントリーモード	PosEntryMode	2	固定	半角数字	リクエスト時にセットした値を応答します。	〇 ※2
ブランドトークントランザクションID(TID)	TransactionIdentifier	16	可変	半角英数字記号	ブランドトークン項目（オプション機能）。	〇 ※4※5
トークンリクエスタID	TokenRequestorId	11	可変	半角数字	リクエスト時にセットした値を応答します。	〇 ※3

BODY部サンプル

カードチェック(1Check)レスポンス

TransactionId=1000000000123&TransactionDate=20090101&OperateId=1Check&ProcessId=abcdd12345678ABCDEFG123456789abc&ProcessPass=12345678abcdefghi9876543210ABCDE&ResponseCd=OK&CompanyCd=Y2&ApproveNo=1234567&ProcNo=0000001&SecureResultCode=0

3.3.3.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」として扱います。	〇
会員ID	KaiinId	6～32	範囲	半角英数字	カード情報に紐づくID。	〇 ※1
会員パスワード	KaiinPass	6～12	範囲	半角英数字	会員IDに紐づくパスワード。	〇 ※1
カード番号	CardNo	11～16	範囲	半角数字	クレジットカード番号。 PCIDSSに準拠していない場合、使用できません。	〇 ※1※5
カード有効期限	CardExp	4	固定	半角数字(YYMM)	クレジットカード有効期限。	〇 ※1※5
支払区分	PayType	2	固定	半角数字	→支払区分	◎
利用金額	Amount	8	可変	半角数字	利用金額。「1（1円）」以上をセットしてください。	◎
セキュリティコード	SecCd	3～4	範囲	半角数字	認証アシスト項目。	〇 ※8
カナ氏名（姓）	KanaSei	15	可変	半角カナ		〇 ※8
カナ氏名（名）	KanaMei	15	可変	半角カナ		〇 ※8
生月日	BirthDay	4	固定	半角数字(MMDD)		〇 ※8
電話番号	TelNo	4	固定	半角数字		〇 ※8
処理番号	ProcNo	7	固定	半角数字	加盟店が取引を識別するための番号（加盟店が採番）。取引日付、店舗コード単位で一意の番号をセットしてください。	◎
リダイレクト用URL	RedirectUrl	500	固定	半角数字	3Dセキュア認証からのリダイレクト先URL。	◎
POST用URL	PostUrl	500	固定	半角数字	POST電文の送信先URL。エンドユーザのリダイレクトが受け取れなかった場合などのリカバリとして設定を推奨します。	〇
トークン	Token	32	固定	半角数字	カード情報の代わりとなる識別子。	〇 ※1
ユーザ請求先住所情報	BillingAddress1	50	可変	半角英数字記号	3Dセキュア認証項目。	〇 ※4
ユーザ都市	BillingCity	50	可変	半角英数字記号		〇 ※4
ユーザ国名コード	BillingCountryCode	3	可変	半角数字		〇 ※4
ユーザ名	BillingFirstName	2～22	範囲	半角英数字記号		〇 ※2
ユーザ姓	BillingLastName	2～22	範囲	半角英数字記号		〇 ※2
ユーザ郵便番号	BillingPostalCode	16	可変	半角英数字記号		〇 ※4
ユーザフルネーム	BillingFullName	2～45	範囲	半角英数字記号スペース		〇 ※2※4
ユーザEメール	BillingEmail	254	可変	半角英数字記号		〇 ※3※4
ユーザ電話番号	BillingPhoneNumber	20	可変	半角数字記号		〇 ※3※4
ユーザ携帯電話番号	BillingMobilePhone	25	可変	半角数字記号		〇 ※3※4
チャレンジインジケーター	ChallengeInd	2	固定	半角数字		〇
ターゲット属性フラグ	TargetAttributeFlg	1	固定	半角数字		〇
ブランドトークン	BdToken	11～16	範囲	半角数字	ブランドトークン項目（オプション機能）。	〇
ブランドトークン有効期限	BdTokenExp	4	固定	半角数字(YYMM)		〇 ※5
クリプトグラム	Cryptogram	28	可変	半角英数字記号		〇 ※6
ブランドトークンECI	BdTokenEci	2	固定	半角数字		〇 ※6
POSエントリーモード	PosEntryMode	2	固定	半角数字	ブランドトークン項目（オプション機能）。 →POSエントリーモード	〇 ※5
ブランドトークントランザクションID(TID)	TransactionIdentifier	16	可変	半角英数字記号	ブランドトークン項目（オプション機能）。	〇 ※7
トークンリクエスタID	TokenRequestorId	11	可変	半角数字	ブランドトークン項目（オプション機能）。	〇 ※6
ブランドトークン取引種別	BdTokenTransactionType	1	固定	半角数字	ブランドトークン項目（オプション機能）。 →ブランドトークン取引種別	〇

BODY部サンプル

与信（1Auth）リクエスト

MerchantId=12346578&MerchantPass=abc123AB&TransactionDate=20090101&OperateId=1Auth&KaiinId=abcdef&KaiinPass=abcdef&PayType=01&Amount=3000&ProcNo=0000001&RedirectUrl=https://XXXXXXX&PostUrl=https://XXXXXXX&BillingFullName=fullname&BillingPhoneNumber=1234

レスポンスパラメーター

◎：必須／○：任意（条件付き必須の場合は注釈あり）／－：セット不要

項目名	パラメーター名	桁数	形式	データ型	説明	設定要領
処理通番	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。コードが複数ある場合はパイプ「｜」区切りでセットします。	◎
3Dメッセージバージョン番号	MessageVersionNo3D	10	可変	半角英数字記号	3Dセキュア関連項目。	〇
エンコード済XID	EncodeXId3D	28	可変	半角英数字記号	3Dセキュア関連項目。	〇
ステータス	TransactionStatus3D	1	固定	半角英数字	3Dセキュア関連項目。 →トランザクションステータス	〇
CAVV	CAVV3D	28	可変	半角英数字記号	3Dセキュア関連項目。	〇
ECI	ECI3D	2	固定	半角英数字	3Dセキュア関連項目。 →ECI	〇
カード会社コード	CompanyCd	2	固定	半角英数字	カード会社を識別するコード。	〇 ※1
承認番号	ApproveNo	7	可変	半角英数字スペース	カード会社発番の承認番号。	〇 ※1
認証結果1	McSecCd	1	固定	半角数字	認証アシスト項目の認証結果。 →認証結果一覧	〇 ※6
認証結果2	McKanaSei	1	固定	半角数字		〇 ※6
認証結果3	McKanaMei	1	固定	半角数字		〇 ※6
認証結果4	McBirthDay	1	固定	半角数字		〇 ※6
認証結果5	McTelNo	1	固定	半角数字		〇 ※6
処理番号	ProcNo	7	固定	半角数字	リクエスト時にセットした値を応答します。	◎
3Dセキュア認証結果コード	SecureResultCode	1	固定	半角数字	3D セキュア関連項。 →3Dセキュア認証結果コード	◎
DSトランザクションID	DSTransactionId	36	可変	半角英数字記号	3D セキュア関連項。	〇
3DSサーバートランザクションID	ThreeDSServerTransactionId	36	可変	半角英数字記号	3D セキュア関連項。	〇
ブランドトークン	BdToken	11～16	範囲	半角数字	リクエスト時にセットした値を応答します。	〇
ブランドトークン有効期限	BdTokenExp	4	固定	半角数字(YYMM)	リクエスト時にセットした値を応答します。	〇 ※2
クリプトグラム	Cryptogram	28	可変	半角英数字記号	リクエスト時にセットした値を応答します。	〇 ※3
ブランドトークンECI	BdTokenEci	2	固定	半角数字	リクエスト時にセットした値を応答します。	〇 ※3
ブランドトークン仕向判定結果	BdTokenResponceCd	1	固定	半角数字	ブランドトークン項目（オプション機能）。 →ブランドトークン仕向判定結果	〇 ※4
POSエントリーモード	PosEntryMode	2	固定	半角数字	リクエスト時にセットした値を応答します。	〇 ※2
ブランドトークントランザクションID(TID)	TransactionIdentifier	16	可変	半角英数字記号	ブランドトークン項目（オプション機能）。	〇 ※4※5
トークンリクエスタID	TokenRequestorId	11	可変	半角数字	リクエスト時にセットした値を応答します。	〇 ※3
ブランドトークン取引種別	BdTokenTransactionType	1	固定	半角数字	リクエスト時にセットした値を応答します。	〇

BODY部サンプル

与信（1Auth）レスポンス

TransactionId=1000000000123&TransactionDate=20090101&OperateId=1Auth&ProcessId=abcdd12345678ABCDEFG123456789abc&ProcessPass=12345678abcdefghi9876543210ABCDE&ResponseCd=OK&CompanyCd=Y2&ApproveNo=1234567&ProcNo=0000001&SecureResultCode=0

3.3.3.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」として扱います。	〇
会員ID	KaiinId	6～32	範囲	半角英数字	カード情報に紐づくID。	〇 ※1
会員パスワード	KaiinPass	6～12	範囲	半角英数字	会員IDに紐づくパスワード。	〇 ※1
カード番号	CardNo	11～16	範囲	半角数字	クレジットカード番号。 PCIDSSに準拠していない場合、使用できません。	〇 ※1※5
カード有効期限	CardExp	4	固定	半角数字(YYMM)	クレジットカード有効期限。	〇 ※1※5
支払区分	PayType	2	固定	半角数字	→支払区分	◎
利用金額	Amount	8	可変	半角数字	利用金額。「1（1円）」以上をセットしてください。	◎
セキュリティコード	SecCd	3～4	範囲	半角数字	認証アシスト項目。	〇 ※8
カナ氏名（姓）	KanaSei	15	可変	半角カナ		〇 ※8
カナ氏名（名）	KanaMei	15	可変	半角カナ		〇 ※8
生月日	BirthDay	4	固定	半角数字(MMDD)		〇 ※8
電話番号	TelNo	4	固定	半角数字		〇 ※8
処理番号	ProcNo	7	固定	半角数字	加盟店が取引を識別するための番号（加盟店が採番）。取引日付、店舗コード単位で一意の番号をセットしてください。	◎
リダイレクト用URL	RedirectUrl	500	固定	半角数字	3Dセキュア認証からのリダイレクト先URL。	◎
POST用URL	PostUrl	500	固定	半角数字	POST電文の送信先URL。エンドユーザのリダイレクトが受け取れなかった場合などのリカバリとして設定を推奨します。	〇
トークン	Token	32	固定	半角数字	カード情報の代わりとなる識別子。	〇 ※1
ユーザ請求先住所情報	BillingAddress1	50	可変	半角英数字記号	3Dセキュア認証項目。	〇 ※4
ユーザ都市	BillingCity	50	可変	半角英数字記号		〇 ※4
ユーザ国名コード	BillingCountryCode	3	可変	半角数字		〇 ※4
ユーザ名	BillingFirstName	2～22	範囲	半角英数字記号		〇 ※2
ユーザ姓	BillingLastName	2～22	範囲	半角英数字記号		〇 ※2
ユーザ郵便番号	BillingPostalCode	16	可変	半角英数字記号		〇 ※4
ユーザフルネーム	BillingFullName	2～45	範囲	半角英数字記号スペース		〇 ※2※4
ユーザEメール	BillingEmail	254	可変	半角英数字記号		〇 ※3※4
ユーザ電話番号	BillingPhoneNumber	20	可変	半角数字記号		〇 ※3※4
ユーザ携帯電話番号	BillingMobilePhone	25	可変	半角数字記号		〇 ※3※4
チャレンジインジケーター	ChallengeInd	2	固定	半角数字		〇
ターゲット属性フラグ	TargetAttributeFlg	1	固定	半角数字		〇
ブランドトークン	BdToken	11～16	範囲	半角数字	ブランドトークン項目（オプション機能）。	〇
ブランドトークン有効期限	BdTokenExp	4	固定	半角数字(YYMM)		〇 ※5
クリプトグラム	Cryptogram	28	可変	半角英数字記号		〇 ※6
ブランドトークンECI	BdTokenEci	2	固定	半角数字		〇 ※6
POSエントリーモード	PosEntryMode	2	固定	半角数字	ブランドトークン項目（オプション機能）。 →POSエントリーモード	〇 ※5
ブランドトークントランザクションID(TID)	TransactionIdentifier	16	可変	半角英数字記号	ブランドトークン項目（オプション機能）。	〇 ※7
トークンリクエスタID	TokenRequestorId	11	可変	半角数字	ブランドトークン項目（オプション機能）。	〇 ※6
ブランドトークン取引種別	BdTokenTransactionType	1	固定	半角数字	ブランドトークン項目（オプション機能）。 →ブランドトークン取引種別	〇

BODY部サンプル

与信売上計上（1Gathering）リクエスト

MerchantId=12346578&MerchantPass=abc123AB&TransactionDate=20090101&OperateId=1Gathering&KaiinId=abcdef&KaiinPass=abcdef&PayType=01&Amount=3000&ProcNo=0000001&RedirectUrl=https://XXXXXXX&PostUrl=https://XXXXXXX&BillingFullName=fullname&BillingPhoneNumber=1234

レスポンスパラメーター

◎：必須／○：任意（条件付き必須の場合は注釈あり）／－：セット不要

項目名	パラメーター名	桁数	形式	データ型	説明	設定要領
処理通番	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。コードが複数ある場合はパイプ「｜」区切りでセットします。	◎
3Dメッセージバージョン番号	MessageVersionNo3D	10	可変	半角英数字記号	3Dセキュア関連項目。	〇
エンコード済XID	EncodeXId3D	28	可変	半角英数字記号	3Dセキュア関連項目。	〇
ステータス	TransactionStatus3D	1	固定	半角英数字	3Dセキュア関連項目。 →トランザクションステータス	〇
CAVV	CAVV3D	28	可変	半角英数字記号	3Dセキュア関連項目。	〇
ECI	ECI3D	2	固定	半角英数字	3Dセキュア関連項目。 →ECI	〇
カード会社コード	CompanyCd	2	固定	半角英数字	カード会社を識別するコード。	〇 ※1
承認番号	ApproveNo	7	可変	半角英数字スペース	カード会社発番の承認番号。	〇 ※1
認証結果1	McSecCd	1	固定	半角数字	認証アシスト項目の認証結果。 →認証結果一覧	〇 ※6
認証結果2	McKanaSei	1	固定	半角数字		〇 ※6
認証結果3	McKanaMei	1	固定	半角数字		〇 ※6
認証結果4	McBirthDay	1	固定	半角数字		〇 ※6
認証結果5	McTelNo	1	固定	半角数字		〇 ※6
処理番号	ProcNo	7	固定	半角数字	リクエスト時にセットした値を応答します。	◎
3Dセキュア認証結果コード	SecureResultCode	1	固定	半角数字	3D セキュア関連項。 →3Dセキュア認証結果コード	◎
DSトランザクションID	DSTransactionId	36	可変	半角英数字記号	3D セキュア関連項。	〇
3DSサーバートランザクションID	ThreeDSServerTransactionId	36	可変	半角英数字記号	3D セキュア関連項。	〇
ブランドトークン	BdToken	11～16	範囲	半角数字	リクエスト時にセットした値を応答します。	〇
ブランドトークン有効期限	BdTokenExp	4	固定	半角数字(YYMM)	リクエスト時にセットした値を応答します。	〇 ※2
クリプトグラム	Cryptogram	28	可変	半角英数字記号	リクエスト時にセットした値を応答します。	〇 ※3
ブランドトークンECI	BdTokenEci	2	固定	半角数字	リクエスト時にセットした値を応答します。	〇 ※3
ブランドトークン仕向判定結果	BdTokenResponceCd	1	固定	半角数字	ブランドトークン項目（オプション機能）。 →ブランドトークン仕向判定結果	〇 ※4
POSエントリーモード	PosEntryMode	2	固定	半角数字	リクエスト時にセットした値を応答します。	〇 ※2
ブランドトークントランザクションID(TID)	TransactionIdentifier	16	可変	半角英数字記号	ブランドトークン項目（オプション機能）。	〇 ※4※5
トークンリクエスタID	TokenRequestorId	11	可変	半角数字	リクエスト時にセットした値を応答します。	〇 ※3
ブランドトークン取引種別	BdTokenTransactionType	1	固定	半角数字	リクエスト時にセットした値を応答します。	〇

BODY部サンプル

与信売上計上（1Gathering）レスポンス

TransactionId=1000000000123&TransactionDate=20090101&OperateId=1Gathering&ProcessId=abcdd12345678ABCDEFG123456789abc&ProcessPass=12345678abcdefghi9876543210ABCDE&ResponseCd=OK&CompanyCd=Y2&ApproveNo=1234567&ProcNo=0000001&SecureResultCode=0

3.3.4. Process電文項目定義

3Dセキュア認証処理結果参照（3Search）の電文項目の定義は下記のとおりです。

3.3.4.1. 3Dセキュア認証処理結果参照（3Search）

リクエストパラメーター

◎：必須／○：任意（条件付き必須の場合は注釈あり）／－：セット不要

項目名	パラメーター名	桁数	形式	データ型	説明	設定要領
接続ID	MerchantId	8	固定長	半角英数字	e-SCOTTが加盟店を識別するID（SP.LINKSが発番）。	◎
接続パスワード	MerchantPass	64	固定	半角英数字記号大文字小文字	e-SCOTTが加盟店を認証するパスワード（加盟店が加盟店管理画面で発番）。	◎
取引日付	TransactionDate	8	固定	半角数字(YYYYMMDD)	当日以前をセットしてください。	◎
処理区分	OperateId	－	可変長	半角英数字	→API一覧	◎
店舗コード	TenantId	4	固定	半角数字	→店舗コードセットしない場合は「0001」として扱います。	〇
処理番号	ProcNo	7	固定	半角数字	加盟店が取引を識別するための番号（加盟店が採番）。取引日付、店舗コード単位で一意の番号をセットしてください。	◎

BODY部サンプル

3Dセキュア認証処理結果参照（3Search）リクエスト

MerchantId=12346578&MerchantPass=abc123AB&TransactionDate=20210301&OperateId=3Search&ProcNo=0000001

レスポンスパラメーター

◎：必須／○：任意（条件付き必須の場合は注釈あり）／－：セット不要

項目名	パラメーター名	桁数	形式	データ型	説明	設定要領
項目名	パラメーター名	桁数	形式	データ型	説明	元取引正常終了時	元取引エラー終了時	元取引未完了時	元取引未存在時
処理通番	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	固定	半角数字	元取引でセットした値を応答します。	◎	◎	◎	－
会員ID	KaiinId	6～32	範囲	半角英数字	元取引でセットした値を応答します。	〇	〇	〇	－
支払区分	PayType	2	固定	半角数字	元取引でセットした値を応答します。	◎	〇	〇	－
利用金額	Amount	8	可変	半角数字	元取引でセットした値を応答します。	◎	〇	〇	－
3Dメッセージバージョン番号	MessageVersionNo3D	10	可変	半角英数字記号	元取引で応答した値を応答します。	〇	〇	－	－
エンコード済XID	EncodeXId3D	28	可変	半角英数字記号	元取引で応答した値を応答します。	〇	〇	－	－
ステータス	TransactionStatus3D	1	固定	半角英数字	元取引で応答した値を応答します。	〇	〇	－	－
CAVV	CAVV3D	28	可変	半角英数字記号	元取引で応答した値を応答します。	〇	〇	－	－
ECI	ECI3D	2	固定	半角英数字	元取引で応答した値を応答します。	〇	〇	－	－
カード会社コード	CompanyCd	2	固定	半角英数字	元取引で応答した値を応答します。	◎	〇	－	－
承認番号	ApproveNo	7	可変	半角英数字スペース	元取引で応答した値を応答します。	◎	〇	－	－
処理番号	ProcNo	7	固定	半角数字	リクエスト時にセットした値を応答します。	◎	◎	◎	◎
最新区分	SaisinKbn	1	固定	半角数字	→最新区分	◎	◎	－	－
3Dセキュア認証結果コード	SecureResultCode	1	固定	半角数字	3D セキュア関連項。 →3Dセキュア認証結果コード	◎	◎	－	－
DSトランザクションID	DSTransactionId	36	可変	半角英数字記号	3D セキュア関連項。	〇	－	－	－
3DSサーバートランザクションID	ThreeDSServerTransactionId	36	可変	半角英数字記号	3D セキュア関連項。	〇	－	－	－

BODY部サンプル

3Dセキュア認証処理結果参照（3Search）レスポンス

TransactionId=000000000002&TransactionDate=20210301&OperateId=3Search&ProcessId=836be7571855cb569c82c26e27d90240&ProcessPass=c3a69be33c123c3fa5712f582be98b08&ResponseCd=OK&TenantId=0001&PayType=01&Amount=3000&CompanyCd=Y2&ApproveNo=1234567&ProcNo=0000001&SaisinKbn=0&SecureResultCode=0

3.3.5. 会員情報登録電文項目定義

会員新規（4MemAdd）、会員更新（4MemChg）の電文項目の定義は、下記のとおりです。

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」として扱います。	〇
会員ID	KaiinId	6～32	範囲	半角英数字	カード情報に紐づくID。	◎
会員パスワード	KaiinPass	6～12	範囲	半角英数字	会員IDに紐づくパスワード。	◎
カード番号	CardNo	11～16	範囲	半角数字	クレジットカード番号。 PCIDSSに準拠していない場合、使用できません。	〇 ※1
カード有効期限	CardExp	4	固定	半角数字(YYMM)	クレジットカード有効期限。	〇 ※1
新会員パスワード	NewKaiinPass	6～12	範囲	半角英数字	会員変更後の会員パスワード。	－
洗替使用区分	EnableCheckUseKbn	1	固定	半角数字	→洗替使用区分セットしない場合は「0」(洗替対象外)となります。	〇
セキュリティコード	SecCd	3～4	範囲	半角数字	認証アシスト項目。	〇 ※5
カナ氏名(姓)	KanaSei	15	可変	半角カナ		〇 ※5
カナ氏名(名)	KanaMei	15	可変	半角カナ		〇 ※5
生月日	BirthDay	4	固定	半角数字(MMDD)		〇 ※5
電話番号	TelNo	4	固定	半角数字		〇 ※5
処理番号	ProcNo	7	固定	半角数字	加盟店が取引を識別するための番号（加盟店が採番）。取引日付、店舗コード単位で一意の番号をセットしてください。	◎
リダイレクト用URL	RedirectUrl	500	固定	半角数字	3Dセキュア認証からのリダイレクト先URL。	◎
POST用URL	PostUrl	500	可変	半角英数字記号	POST電文の送信先URL。エンドユーザのリダイレクトが受け取れなかった場合などのリカバリとして設定を推奨します。	〇
トークン	Token	32	固定	半角数字	カード情報の代わりとなる識別子。	〇 ※1
ユーザ請求先住所情報	BillingAddress1	50	可変	半角英数字記号	3Dセキュア認証項目。	〇 ※2
ユーザ都市	BillingCity	50	可変	半角英数字記号		〇 ※2
ユーザ国名コード	BillingCountryCode	3	可変	半角数字		〇 ※2
ユーザ名	BillingFirstName	2～22	範囲	半角英数字記号		〇 ※3
ユーザ姓	BillingLastName	2～22	範囲	半角英数字記号		〇 ※3
ユーザ郵便番号	BillingPostalCode	16	可変	半角英数字記号		〇 ※2
ユーザフルネーム	BillingFullName	2～45	可変	半角英数字記号スペース		〇 ※2※3
ユーザEメール	BillingEmail	254	可変	半角英数字記号		〇 ※2※4
ユーザ電話番号	BillingPhoneNumber	20	可変	半角数字記号		〇 ※2※4
ユーザ携帯電話番号	BillingMobilePhone	25	可変	半角数字記号		〇 ※2※4
チャレンジインジケーター	ChallengeInd	2	固定	半角数字		〇
ターゲット属性フラグ	TargetAttributeFlg	1	固定	半角数字		〇

BODY部サンプル

会員新規（4MemAdd）リクエスト

MerchantId=12346578&MerchantPass=abc123AB&TransactionDate=20090101&OperateId=4MemAdd&KaiinId=abcdef&KaiinPass=abcdef&Token=aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa&ProcNo=0000001&RedirectUrl=https://XXXXXXX&PostUrl=https://XXXXXXX&BillingFullName=fullname&BillingPhoneNumber=1234

レスポンスパラメーター

◎：必須／○：任意（条件付き必須の場合は注釈あり）／－：セット不要

項目名	パラメーター名	桁数	形式	データ型	説明	設定要領
処理通番	TransactionId	12	固定	半角数字	処理を識別するコード（e-SCOTTが自動採番）。	◎
取引日付	TransactionDate	8	固定	半角数字(YYYYMMDD)	リクエスト時にセットした値を応答します。	◎
処理区分	OperateId	－	可変長	半角英数字	リクエスト時にセットした値を応答します。	◎
加盟店自由領域1	MerchantFree1	64	可変	全半角文字	リクエスト時にセットした値を応答します。	〇
加盟店自由領域2	MerchantFree2	64	可変	全半角文字	リクエスト時にセットした値を応答します。	〇
加盟店自由領域3	MerchantFree3	64	可変	全半角文字	リクエスト時にセットした値を応答します。	〇
処理結果コード	ResponseCd	200	可変	半角英数字記号	→レスポンスコード 1コード3Byte。コードが複数ある場合はパイプ「｜」区切りでセットします。	◎
カード会社コード	CompanyCd	2	固定	半角英数字	カード会社を識別するコード。	〇 ※1
洗替使用区分	EnableCheckUseKbn	1	固定	半角数字	リクエスト時にセットした値を応答します。	〇
認証結果1	McSecCd	1	固定	半角数字	認証アシスト項目の認証結果。 →認証結果一覧	〇 ※2
認証結果2	McKanaSei	1	固定	半角数字		〇 ※2
認証結果3	McKanaMei	1	固定	半角数字		〇 ※2
認証結果4	McBirthDay	1	固定	半角数字		〇 ※2
認証結果5	McTelNo	1	固定	半角数字		〇 ※2
3Dメッセージバージョン番号	MessageVersionNo3D	10	可変	半角英数字記号	3Dセキュア関連項目。	〇
エンコード済XID	EncodeXId3D	28	可変	半角英数字記号	3Dセキュア関連項目。	〇
ステータス	TransactionStatus3D	1	固定	半角英数字	3Dセキュア関連項目。 →トランザクションステータス	〇
CAVV	CAVV3D	28	可変	半角英数字記号	3Dセキュア関連項目。	〇
ECI	ECI3D	2	固定	半角英数字	3Dセキュア関連項目。 →ECI	〇
処理番号	ProcNo	7	固定	半角数字	リクエスト時にセットした値を応答します。	◎
3Dセキュア認証結果コード	SecureResultCode	1	固定	半角数字	3D セキュア関連項。 →3Dセキュア認証結果コード	◎
DSトランザクションID	DSTransactionId	36	可変	半角英数字記号	3D セキュア関連項。	〇
3DSサーバートランザクションID	ThreeDSServerTransactionId	36	可変	半角英数字記号	3D セキュア関連項。	〇
ブランドトークン	BdToken	11～16	範囲	半角数字	ブランドトークン項目（オプション機能）。	〇
ブランドトークン有効期限	BdTokenExp	4	固定	半角数字(YYMM)		〇
顧客ID	BdTokenCustomerId	60	可変	半角英数字記号		〇
決済手段登録番号	BdTokenAccountMethod	2	固定	半角数字		〇
ブランドトークン仕向判定結果	BdTokenResponceCd	1	固定	半角数字	ブランドトークン項目（オプション機能）。 →ブランドトークン仕向判定結果	〇

BODY部サンプル

会員新規（4MemAdd）レスポンス

TransactionId=000000000123&TransactionDate=20090101&OperateId=4MemAdd&ResponseCd=OK&CompanyCd=Y2&ProcNo=0000001&SecureResultCode=0

3.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」として扱います。	〇
会員ID	KaiinId	6～32	範囲	半角英数字	カード情報に紐づくID。	◎
会員パスワード	KaiinPass	6～12	範囲	半角英数字	会員IDに紐づくパスワード。	◎
カード番号	CardNo	11～16	範囲	半角数字	クレジットカード番号。 PCIDSSに準拠していない場合、使用できません。	〇 ※1
カード有効期限	CardExp	4	固定	半角数字(YYMM)	クレジットカード有効期限。	〇 ※1
新会員パスワード	NewKaiinPass	6～12	範囲	半角英数字	会員変更後の会員パスワード。	〇
洗替使用区分	EnableCheckUseKbn	1	固定	半角数字	→洗替使用区分セットしない場合は「0」(洗替対象外)となります。	〇
セキュリティコード	SecCd	3～4	範囲	半角数字	認証アシスト項目。	〇 ※4
カナ氏名(姓)	KanaSei	15	可変	半角カナ		〇 ※4
カナ氏名(名)	KanaMei	15	可変	半角カナ		〇 ※4
生月日	BirthDay	4	固定	半角数字(MMDD)		〇 ※4
電話番号	TelNo	4	固定	半角数字		〇 ※4
処理番号	ProcNo	7	固定	半角数字	加盟店が取引を識別するための番号（加盟店が採番）。取引日付、店舗コード単位で一意の番号をセットしてください。	◎
リダイレクト用URL	RedirectUrl	500	固定	半角数字	3Dセキュア認証からのリダイレクト先URL。	◎
POST用URL	PostUrl	500	可変	半角英数字記号	POST電文の送信先URL。エンドユーザのリダイレクトが受け取れなかった場合などのリカバリとして設定を推奨します。	〇
トークン	Token	32	固定	半角数字	カード情報の代わりとなる識別子。	〇
ユーザ請求先住所情報	BillingAddress1	50	可変	半角英数字記号	3Dセキュア認証項目。	〇 ※1
ユーザ都市	BillingCity	50	可変	半角英数字記号		〇 ※1
ユーザ国名コード	BillingCountryCode	3	可変	半角数字		〇 ※1
ユーザ名	BillingFirstName	2～22	範囲	半角英数字記号		〇 ※2
ユーザ姓	BillingLastName	2～22	範囲	半角英数字記号		〇 ※2
ユーザ郵便番号	BillingPostalCode	16	可変	半角英数字記号		〇 ※1
ユーザフルネーム	BillingFullName	2～45	可変	半角英数字記号スペース		〇 ※1※2
ユーザEメール	BillingEmail	254	可変	半角英数字記号		〇 ※1※3
ユーザ電話番号	BillingPhoneNumber	20	可変	半角数字記号		〇 ※1※3
ユーザ携帯電話番号	BillingMobilePhone	25	可変	半角数字記号		〇 ※1※3
チャレンジインジケーター	ChallengeInd	2	固定	半角数字		〇
ターゲット属性フラグ	TargetAttributeFlg	1	固定	半角数字		〇

BODY部サンプル

会員更新（4MemChg）リクエスト

MerchantId=12346578&MerchantPass=abc123AB&TransactionDate=20210301&OperateId=4MemChg&KaiinId=abcdef&KaiinPass=abcdef&Token=aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa&ProcNo=0000001&RedirectUrl=https://XXXXXXX&PostUrl=https://XXXXXXX&BillingFullName=fullname&BillingPhoneNumber=1234

レスポンスパラメーター

◎：必須／○：任意（条件付き必須の場合は注釈あり）／－：セット不要

項目名	パラメーター名	桁数	形式	データ型	説明	設定要領
処理通番	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	固定	半角数字	認証アシスト項目の認証結果。 →認証結果一覧	〇 ※2
認証結果2	McKanaSei	1	固定	半角数字		〇 ※2
認証結果3	McKanaMei	1	固定	半角数字		〇 ※2
認証結果4	McBirthDay	1	固定	半角数字		〇 ※2
認証結果5	McTelNo	1	固定	半角数字		〇 ※2
3Dメッセージバージョン番号	MessageVersionNo3D	10	可変	半角英数字記号	3Dセキュア関連項目。	〇
エンコード済XID	EncodeXId3D	28	可変	半角英数字記号	3Dセキュア関連項目。	〇
ステータス	TransactionStatus3D	1	固定	半角英数字	3Dセキュア関連項目。 →トランザクションステータス	〇
CAVV	CAVV3D	28	可変	半角英数字記号	3Dセキュア関連項目。	〇
ECI	ECI3D	2	固定	半角英数字	3Dセキュア関連項目。 →ECI	〇
処理番号	ProcNo	7	固定	半角数字	リクエスト時にセットした値を応答します。	◎
3Dセキュア認証結果コード	SecureResultCode	1	固定	半角数字	3D セキュア関連項。 →3Dセキュア認証結果コード	◎
DSトランザクションID	DSTransactionId	36	可変	半角英数字記号	3D セキュア関連項。	〇
3DSサーバートランザクションID	ThreeDSServerTransactionId	36	可変	半角英数字記号	3D セキュア関連項。	〇
ブランドトークン	BdToken	11～16	範囲	半角数字	ブランドトークン項目（オプション機能）。	〇
ブランドトークン有効期限	BdTokenExp	4	固定	半角数字(YYMM)		〇
顧客ID	BdTokenCustomerId	60	可変	半角英数字記号		〇
決済手段登録番号	BdTokenAccountMethod	2	固定	半角数字		〇
ブランドトークン仕向判定結果	BdTokenResponceCd	1	固定	半角数字	ブランドトークン項目（オプション機能）。 →ブランドトークン仕向判定結果	〇

BODY部サンプル

会員更新（4MemChg）レスポンス

TransactionId=000000000002&TransactionDate=20210301&OperateId=4MemChg&ResponseCd=OK&CompanyCd=Y2&ProcNo=0000001&SecureResultCode=0

3.3.6. 留意事項

3.3.6.1. エンドユーザー利用環境について

EMV3Dセキュアサービスはフィーチャーフォンに対応していません。

3.3.6.2. 応答電文（REDIRECT、POST）について

3Dセキュア認証の処理結果はエンドユーザー画面を経由するREDIRECT電文と、加盟店サーバーに直接送信するPOST電文の２種類の電文で応答します。
インターフェイスはREDIRECT 電文とPOST 電文共に同一となります。
REDIRECT電文がエンドユーザー操作等で失敗した場合に備え、POST電文を受信し処理結果を受領してください。
POST電文の送信タイミングは下記の通りです。

エンドユーザ画面	送信タイミング
認証完了画面まで到達しない状態（タイムアウト、ブラウザリロード等）	エンドユーザーの最終操作から30分後
上記以外	処理完了時

POST 電文を正常に受信した場合、HTTP ステータスコード「200」を応答してください。
応答が確認できない場合、最大5回リトライを行います。

3.4. コード定義

APIで利用するコード定義は下記のとおりです。
処理結果コード、エラーコード、エラーコード概要については、レスポンスコードを確認してください。

3.4.1. ECI

コード値	内容
00	認証失敗（MasterCard）
01	アテンプト（MasterCard）
02	認証成功（MasterCard）
05	認証成功（VISA/JCB/AMEX/Diners）
06	アテンプト（VISA/JCB/AMEX/Diners）
07	認証失敗（VISA/JCB/AMEX/Diners）

3.4.2. トランザクションステータス

コード値	内容
Y	認証成功
N	認証失敗
U	システムエラー
A	アテンプト
R	認証拒否
-(値返却なし)	3Dセキュア未対応カード、ネットワークエラー等

3.4.3. 3Dセキュア認証結果コード

コード値	内容	説明
0	3Dセキュア認証済	3Dセキュア認証正常終了
1	3Dセキュア未認証	3Dセキュア認証失敗
4	アテンプト	イシュアまたは会員が3Dセキュア認証未参加
9	認証システムエラー	認証システムでエラーが発生

4. APPENDIX

4.1. オーソリ送信判定オプション

3Dセキュア認証未実施の場合に、後続のオーソリ処理を実施することができるようになるオプションです。認証結果およびカードブランド毎に設定することができます。
設定可能な認証結果は下記の通りです。

認証結果	説明
4（アテンプト）	イシュアまたは会員が3Dセキュア認証未参加のため3D セキュア認証未実施
9（認証システムエラー）	認証システムのエラーにより3Dセキュア認証未実施

認証結果が「0（3Dセキュア認証済）」以外でオーソリ処理を実施した場合、加盟店の債務となるケースがあります。

4.2. 3Dセキュア認証項目保持機能

加盟店が採番する会員IDに紐づけて3Dセキュア認証項目を登録するオプション機能です。3Dセキュア認証項目の登録以降は会員IDと会員パスワードを送信することで3Dセキュア認証の処理が可能です。

利用には別途ご契約が必要となります。