3Dセキュア2.0
3Dセキュア2.0は下記方法にて対応が可能です。
トークン決済
トークン発行後の加盟店様からイプシロンシステムへの決済指示の際、3Dセキュア2.0専用のパラメータをお送りいただきます。
その後、イプシロンから戻される処理結果に基づき処理をお願いいたします。
3Dセキュア1.0と3Dセキュア2.0が並行して利用可能な期間は、3Dセキュア1.0と3Dセキュア2.0のどちらかに対応いただければ問題ございません。
リンク決済
決済時に3Dセキュア2.0専用のパラメータをお送りいただくことで3Dセキュア2.0に対応が可能です。
【リンク決済での3Dセキュア2.0対応可能決済サービス】
- クレジットカード決済
- 多通貨決済
- ※いずれも3Dセキュア2.0に対応するには、専用パラメータをお送りいただく必要がございます。
- ※多通貨決済につきましては、3Dセキュア1.0閉塞後、3Dセキュア2.0への対応が必須となります。
3Dセキュア2.0の専用パラメータをお送りいただかないと決済が行えません。 - ※イプシロン決済サービスにおいて、2022年10月13日を以て現行仕様（3Dセキュア1.0）は廃止となります。
処理フロー
（１）処理フロー：トークン決済
トークン取得後のフロー図
（２）処理フロー：リンク決済
リンク決済では処理フローに変更はございません。
送信パラメータ
「オーダー情報送信先 CGI」「接続先URL」へ決済パラメータを送信する際、以下表のパラメータを追加してください。
オーダー情報送信先 CGI記載ページへ
接続先URL記載ページへ
現在はテスト環境では3Dセキュア2.0の決済は行えません。
3Dセキュア2.0での決済を確認される場合は本番環境をご利用ください。
| No. | 項目名 | パラメータ名 | 種別 | 属性 | 例 | 説明 |
|---|---|---|---|---|---|---|
| 1 | 3DS2.0フラグ | tds_flag | 〇 | 半角数字2桁 | 21 | 3Dセキュア2.0を利用する場合、必須 21 または 22を設定 |
| 2 | 請求先住所(都市) | billAddrCity | △ | EUC or S-JIS 50byte以下 | 渋谷区 | 購入者の請求先住所の都市 |
| 3 | 請求先住所(国番号) | billAddrCountry | ▲ | 半角数字3桁 | 392 | 購入者の請求先住所の国番号 指定可能な国コードはISO 3166-1の3桁の国番号 ※8: billAddrState に値を指定する場合、本パラメータは指定必須 |
| 4 | 請求先住所(区域部分_1行目) | billAddrLine1 | △ | EUC or S-JIS 50byte以下 | 道玄坂1丁目14番6号 | 購入者の請求先住所の街路住所またはそれと同等の区域部分の1行目 |
| 5 | 請求先住所(区域部分_2行目) | billAddrLine2 | △ | EUC or S-JIS 50byte以下 | ヒューマックス渋谷ビル7F | 購入者の請求先住所の街路住所またはそれと同等の区域部分の2行目 |
| 6 | 請求先住所(区域部分_3行目) | billAddrLine3 | △ | EUC or S-JIS 50byte以下 | 購入者の請求先住所の街路住所またはそれと同等の区域部分の3行目 | |
| 7 | 請求先住所(郵便番号) | billAddrPostCode | △ | 半角数字-16桁以下 | 150-0043 | 購入者の請求先住所のZIPコードまたはその他の郵便番号 |
| 8 | 請求先住所 (州または都道府県番号) |
billAddrState | △ | 半角英数字3桁以下 | 13 | 指定可能な州または都道府県コードは ISO 3166-2の下2桁もしくは下3桁の州または都道府県番号、記号 |
| 9 | 送り先住所(都市) | shipAddrCity | △ | EUC or S-JIS 50byte以下 | 渋谷区 | 購入者が要求している送り先住所の都市 |
| 10 | 送り先住所(国番号) | shipAddrCountry | ▲ | 半角数字3桁 | 392 | 購入者が要求している送り先住所の国番号 指定可能な国コードはISO 3166-1の3桁の国番号 ※15: shipAddrState に値を指定する場合、本パラメータは指定必須 |
| 11 | 送り先住所(区域部分_1行目) | shipAddrLine1 | △ | EUC or S-JIS 50byte以下 | 道玄坂1丁目14番6号 | 購入者が要求している送り先住所の街路住所 またはそれと同等の区域部分の1行目 |
| 12 | 送り先住所(区域部分_2行目) | shipAddrLine2 | △ | EUC or S-JIS 50byte以下 | ヒューマックス渋谷ビル7F | 購入者が要求している送り先住所の街路住所 またはそれと同等の区域部分の2行目 |
| 13 | 送り先住所(区域部分_3行目) | shipAddrLine3 | △ | EUC or S-JIS 50byte以下 | 購入者が要求している送り先住所の街路住所 またはそれと同等の区域部分の3行目 |
|
| 14 | 送り先住所(郵便番号) | shipAddrPostCode | △ | 半角数字-16桁以下 | 150-0043 | 購入者が要求している送り先住所のZIPコードまたはその他の郵便番号 |
| 15 | 送り先住所 (州または都道府県番号) |
shipAddrState | △ | 半角英数字3桁以下 | 13 | 指定可能な州または都道府県コードは ISO 3166-2の下2桁もしくは下3桁の州または都道府県番号、記号 |
| 16 | 購入者登録情報 | chAccAgeInd | △ | 半角数字2桁 | 01 | 購入者アカウントに関するチェック 01 = アカウントなし（ゲストチェックアウト） 02 = この取引中にアカウントが作成された 03 = 30日未満 04 = 30～60日 05 = 60日を超える期間 |
| 17 | 購入者更新日 | chAccChange | △ | 半角数字8桁 | 20220101 | 購入者情報が最後に変更された日付 YYYYMMDD形式 |
| 18 | 購入者更新変更期間 | chAccChangeInd | △ | 半角数字2桁 | 01 | 購入者情報が最後に変更されてからの期間 01 = この取引中に変更された 02 = 30日未満 03 = 30～60日 04 = 60日を超える期間 |
| 19 | 購入者登録日 | chAccDate | △ | 半角数字8桁 | 20220101 | 購入者アカウントを作成した日付 YYYYMMDD形式 |
| 20 | パスワード変更日 | chAccPwChange | △ | 半角数字8桁 | 20220101 | 購入者アカウントのパスワードが変更されたか、 アカウントがリセットされた日付 YYYYMMDD形式 |
| 21 | パスワード変更期間 | chAccPwChangeInd | △ | 半角数字2桁 | 01 | 購入者アカウントのパスワードが変更されたか、 アカウントがリセットされてからの期間 01 = 変更なし 02 = この取引中に変更された 03 = 30日未満 04 = 30～60日 05 = 60日を超える期間 |
| 22 | 購入回数(6か月) | nbPurchaseAccount | △ | 半角数字4桁以下 | 0 | 過去6か月間にこの購入者アカウントで購入が行われた回数 0～9999 |
| 23 | カード登録日 | paymentAccAge | △ | 半角数字8桁 | 20220101 | 購入者アカウントにカード情報が登録された日付 YYYYMMDD形式 |
| 24 | カード登録期間 | paymentAccInd | △ | 半角数字2桁 | 01 | 購入者アカウントにカード情報が登録されてからの期間 01 = アカウントなし（ゲストチェックアウト） 02 = この取引中 03 = 30日未満 04 = 30～60日 05 = 60日を超える期間 |
| 25 | カード登録回数(24時間) | provisionAttemptsDay | △ | 半角数字3桁以下 | 0 | 過去24時間に行われたカード情報追加の試行回数 0～999 |
| 26 | 送り先住所初回利用日 | shipAddressUsage | △ | 半角数字8桁 | 20220101 | この取引で使用される送り先住所が加盟店様で最初に使用された日付 YYYYMMDD形式 |
| 27 | 送り先住所利用期間 | shipAddressUsageInd | △ | 半角数字2桁 | 01 | この取引で使用される送り先住所が加盟店様で最初に使用されてからの期間 01 = この取引 02 = 30日未満 03 = 30～60日 04 = 60日を超える期間 |
| 28 | 送り先名と会員名チェック | shipNameIndicator | △ | 半角数字2桁 | 01 | 購入者アカウントの会員名がこの取引で使用される送り先名と同じかどうか 01 = 会員名と送り先名が同じ 02 = 会員名と送り先名が異なる |
| 29 | 不審行為情報 | suspiciousAccActivity | △ | 半角数字2桁 | 01 | 購入者アカウントで、過去不審な行動（不正行為含む）を 加盟店様が発見したかどうか 01 = 不審な行動は見られなかった 02 = 不審な行動が見られた |
| 30 | 取引回数(24時間) | txnActivityDay | △ | 半角数字3桁以下 | 0 | 過去24時間に行われたこの購入者アカウントと加盟店の取引回数 0～999 |
| 31 | 取引回数(前年) | txnActivityYear | △ | 半角数字3桁以下 | 0 | 前年に行われたこの購入者アカウントと加盟店様の取引回数 0～999 |
| 32 | ログイン認証データ | threeDSReqAuthData | △ | EUC or S-JIS 2048byte以下 | validlogin at UL TS BV | 購入者が特定の方法で加盟店様システムにログイン認証したことを 裏付けるデータ |
| 33 | ログイン認証方法 | threeDSReqAuthMethod | △ | 半角数字2桁 | 1 | 購入者が加盟店様システムへのログイン認証に使用した方法 01 = 加盟店様によるログイン認証が行われなかった （購入者がゲストとしてログインした） 02 = 加盟店様の認証情報を利用したログイン認証 03 = SSO(シングルサインオン)を利用したログイン認証 04 = イシュアーの認証情報を利用したログイン認証 05 = サードパーティ認証を利用したログイン認証 06 = FIDO認証を利用したログイン認証 |
| 34 | ログイン認証日時 | threeDSReqAuthTimestamp | △ | 半角数字12桁 | 202201011234 | 購入者が加盟店様システムへのログイン認証を行った日付時刻 YYYYMMDDHH24MM形式 |
| 35 | 送り先住所と請求先住所チェック | addrMatch | △ | 半角英字1桁 | Y | 購入者の送り先住所と購入者の請求先住所が同じかどうか Y = 送り先住所が請求先住所と一致する N = 送り先住所が請求先住所と一致しない |
| 36 | カード名義 | cardholderName | △ | 半角英字・スペース 2～45桁 | TARO EPSILON | カード名義 |
| 37 | 自宅電話 | homePhone | △ | 半角数字+-15桁以下 | +813-1111-2222 | 購入者の自宅電話 |
| 38 | 携帯電話 | mobilePhone | △ | 半角数字+-15桁以下 | +8190-3333-4444 | 購入者の携帯電話 |
| 39 | 職場電話 | workPhone | △ | 半角数字-15桁以下 | 03-5555-6666 | 購入者の職場電話 |
| 40 | チャレンジ要求 | challengeInd | △ | 半角数字2桁 | 01 | この取引に対するチャレンジが要求されているかどうか 01 = 任意 02 = チャレンジが必要とされない 03 = チャレンジが必要とされる：3DSリクエスターによる選択 04 = チャレンジが必要とされる：義務 ※「04」を選択しても決済の一部がカード会社側の判断でフリクションレスフローでの認証成功となる場合があります。 |
| 41 | 納品先メールアドレス | deliveryEmailAddress | △ | 半角英数字.-_@ 256桁以下 | test@epsilon.jp | 電子デリバリーの場合は、商品を納品したときの納品先メールアドレス |
| 42 | 納品時間枠種別 | deliveryTimeframe | △ | 半角数字2桁 | 01 | 商品納品時間枠 01 = 電子デリバリー 02 = 当日出荷 03 = 翌日出荷 04 = 2日目以降の出荷 |
| 43 | ギフトカード購入金額 | giftCardAmount | △ | 半角数字15桁以下 | 10000 | プリペイドカードまたはギフトカードの購入の場合は、購入金額 （小数点以下切り捨て） |
| 44 | ギフトカード購入総数 | giftCardCount | △ | 半角数字2桁以下 | 10 | プリペイドカードまたはギフトカードの購入の場合は、購入総数 |
| 45 | 予約商品発売予定日 | preOrderDate | △ | 半角数字8桁 | 20230101 | 先行予約購入の場合は、商品の発売予定日 YYYYMMDD形式 |
| 46 | 予約商品チェック | preOrderPurchaseInd | △ | 半角数字2桁以下 | 01 | 購入者が将来発売またはリリースされる商品を注文しているかどうか 01 = 販売されている商品 02 = 将来発売される商品 |
| 47 | 再購入チェック | reorderItemsInd | △ | 半角数字2桁以下 | 01 | 購入者が以前購入した商品を再び注文しているかどうか 01 = 初めての注文 02 = 再注文 |
| 48 | 配送方法種別 | shipIndicator | △ | 半角数字2桁以下 | 01 | 選択されている取引の配送方法 01 = 購入者の請求先住所に配送する 02 = 加盟店様が保持している別の確認済み住所に配送する 03 = 購入者の請求先住所と異なる住所に配送する 04 = 店舗へ配送 / 近所の店舗での受け取り （店舗の住所は送り先住所で指定する） 05 = デジタル商品 （オンラインサービス、電子ギフトカードおよび償還コードを含む） 06 = 配送されない旅行およびイベントのチケット 07 = その他（たとえば、ゲーム、配送されないデジタルサービス、 電子メディアの購読料など） |
＜種別説明＞
〇：必須の項目です。値を設定してください。
▲：条件つきで必須項目となります。説明をご確認ください。
△：任意の設定項目です。
トークン：送受信パラメータ
| No. | 項目名 | パラメータ名 | 属性 | 例 | 種別 | 説明 |
|---|---|---|---|---|---|---|
| 1 | トランザクションコード | trans_code | 半角数字 | 12345678 | △ | イプシロンから発番される注文受付番号です。 パラメータ相違等により取引を受け付けられなかった場合には設定されません。 |
| 2 | 決済結果 | result | 半角数字 | 1 | 〇 | 0: 決済NG 1: 決済OK 6: 3DS2.0処理（EP画面にリダイレクト必要） 9: システムエラー（パラメータ不足、不正等） |
| 3 | エラーコード | err_code | 半角英数字 | 602 | △ | エラーコード一覧をご確認ください。 |
| 4 | エラーメッセージ | err_detail | S-JIS 2byte文字 | オーソリ処理NG （有効期限が不正です） |
△ | エラーコード一覧をご確認ください。 |
| 5 | 3DS2.0 リダイレクトURL |
tds2_url | 半角英数記号 | https://secure.epsilon.jp/tds2.cgi | △ | 決済結果: 6 の場合設定されます。 3DS2.0認証処理に必要な項目です。 |
| 6 | 3DS認証要求電文 | pareq | 桁数不明 | XXXXXXXXXXXXXXXXXX | △ | 決済結果：6 の場合設定されます。 3DS認証処理に必要な項目です。 |
| 7 | 仮実フラグ | kari_flag | 半角数字1桁 | 1 | △ | 決済結果：1 の場合設定されます 対象取引の決済状況 1：課金済み 2：仮売上 |
| No. | 結果内容 | resultの値 | 処理内容 |
|---|---|---|---|
| 1 | 決済NG | 0 | 3DS不要でクレジットカード決済がNGとなります。 再度クレジット情報を表示する画面を提示して新しいカード番号の入力を実施お願いします。注文情報については同じものを設定していただきますようお願いいたします。 |
| 2 | 決済OK | 1 | クレジットカード決済がOKとなります。 決済が完了しておりますので購入者に決済完了の画面の表示をお願いいたします。 |
| 3 | 3DS2.0処理 | 6 | 3DS2.0の処理が必要となります。 次項「（2）購入者様リダイレクト時必要パラメータ」以降の処理を実施してください。 併せて返却するパラメータ tds2_url に購入者様をリダイレクトしていただくようお願いいたします。 |
| 4 | システムエラー | 9 | システムエラーとなります。 エラーの内容につきましてはエラーコード一覧（決済API版）をご参照の上、エラーコードとエラーメッセージをご確認お願いいたします。 |
（２）購入者様リダイレクト時必要パラメータ
購入者様リダイレクト時に必要なパラメータは以下の通りです。
| No. | 項目名 | パラメータ名 | 属性 | 例 | 種別 | 説明 |
|---|---|---|---|---|---|---|
| 1 | 3DS接続URL | ACSUrl | 桁数不明 | https://secure.epsilon.jp/tds2.cgi | 〇 | 「tds2_url」をURLデコードして設定する。 |
| 2 | 3DS認証要求電文 | pareq | 桁数不明 | XXXXXXXXXXXXXXXXXX | △ | 3DS認証のための暗号化したキーです。 イプシロンから返す「pareq」をURLデコードして設定します。 |
| 3 | 戻り先URL | TermUrｌ | URL | https://my.merchant.com/next.cgi | 〇 | 結果受け取り用のURLです。 ここに設定したURLにカード会社からの結果がイプシロンよりリダイレクトされます。 |
| 4 | トラッキングデータ | MD | ASCII文字 1024バイト | 12345678 | △ | セッション管理用のパラメータです。 カード会社からの応答にセットされるため取引を一意に認識するのに利用できます。 日本語もしくはバイナリデータを利用する場合はBase64でエンコードが必要です。 |
接続のサンプルページ
<!DOCTYPE html>
<html>
<head>
<meta charset="UTF-8">
<title>接続のサンプルページ</title>
</head>
<body OnLoad='OnLoadEvent();'>
<form name="downloadForm" action="https://secure.epsilon.jp/tds2.cgi" method="POST">
<noscript>
<br><br><center>
<h2>3-Dセキュア認証を続けます。<br>
ボタンをクリックしてください。</h2>
<input type="submit" value="OK">
</center>
</noscript>
<input type="hidden" name="PaReq" value="PAReq MESSAGE HERE">
<input type="hidden" name="TermUrl" value="https://my.merchant.com/next.cgi">
<input type="hidden" name="MD" value="MERCHANT DATA HERE">
</form>
<script language="Javascript">
<!--
function OnLoadEvent(){
document.downloadForm.submit();
}
//-->
</script>
</body>
</html>
（３）3Dセキュア2.0認証後受信パラメータ イプシロン ⇒ 加盟店様
3DSの認証完了後、以下のパラメータがイプシロンから戻ります。
| No. | 項目名 | パラメータ名 | 属性 | 例 | 種別 | 説明 |
|---|---|---|---|---|---|---|
| 1 | 3DS認証結果 | PaRes | 桁数不明 | XXXXXXXXXXXXXXXXXXXX | 〇 | カード会社からの認証結果です。 イプシロンに送信する「tds_pares」に設定してください。 |
| 2 | トラッキングデータ | MD | ASCII文字 1024バイト | 12345678 | △ | セッション管理用のパラメータです。 購入者様リダイレクト時に設定した値が設定されます。 |
（４）接続２回目：送信パラメータ 加盟店様 ⇒ イプシロン
「3Dセキュア2.0認証後受信パラメータ」で受信した値（PaRes）と注文情報の一部を、1回目の接続先URLと同じ接続先URLにPOSTしてください。
| No. | 項目名 | パラメータ名 | 属性 | 例 | 種別 | 説明 |
|---|---|---|---|---|---|---|
| 1 | 契約コード | contract_code | 半角英数字 8byte(固定) | 12345600 | 〇 | イプシロンが加盟店様ごとに採番します。 申込時にイプシロンの申込完了画面及びメールにて通知します。 |
| 2 | オーダー番号 | order_number | 半角英数字 32byte | A123456789 | 〇 | 接続1回目に設定したオーダー番号と同一の値を設定してください。 |
| 3 | 3DSフラグ | tds_check_code | 半角数字 1桁 | 2 | 〇 | 2：3DS結果確認処理 （2回目） |
| 4 | 3DS応答（PaRes） | tds_pares | 桁数不明 | XXXXXXXXXXXXXXXXXX | 〇 | カード会社からの戻り値「PaRes」を設定してください。 |
（５）接続２回目：受信パラメータ イプシロン ⇒ 加盟店様
以下パラメータをxml形式で応答します。
| No. | 項目名 | パラメータ名 | 属性 | 例 | 種別 | 説明 |
|---|---|---|---|---|---|---|
| 1 | トランザクションコード | trans_code | 半角数字 | 12345678 | 〇 | 接続1回目の受信パラメータて設定されたトランザクションコードと同一の値が設定されます。 |
| 2 | 決済結果 | result | 半角数字 | 1 | 〇 | 0：決済NG 1：決済OK 9：システムエラー （パラメータ不足、不正等） |
| 3 | エラーコード | err_code | 半角英数字 | 602 | △ | エラーコード一覧をご確認ください。 |
| 4 | エラーメッセージ | err_detail | S-JIS 2byte文字 | オーソリ処理NG （有効期限が不正です） |
△ | エラーコード一覧をご確認ください。 |
各表の必須、条件付き必須、任意などは以下の記号で表しています。
＜種別説明：送信パラメータの場合＞
〇：必須の項目です。値を設定してください。
▲：条件つきで必須項目となります。それぞれのパラメータの説明をご確認ください。
△：任意の設定項目です。
＜種別説明：受信パラメータの場合＞
〇：必須で値が戻ります。
△：特定の条件で値が戻ります。
リンク決済：受信パラメータ
リンク決済では受信パラメータに変更はございません。
仕様書ダウンロード
PDF形式の仕様書のダウンロードはこちら
※ダウンロードには管理画面へのログインが必要です。