接続先URLは以下になります。
【本番環境】 https://secure.epsilon.jp/cgi-bin/order/direct_card_payment.cgi
【テスト環境】 https://beta.epsilon.jp/cgi-bin/order/direct_card_payment.cgi
「2.接続先URL」のURLに以下パラメータをPOSTで送信してください。
| No. | 項目名 | パラメータ名 | 属性 | 例 | 必須 | 説明 |
|---|---|---|---|---|---|---|
| 1 | 契約コード | contract_code | 半角英数字 8byte(固定) | 12345600 | ○ | イプシロンが加盟店様ごとに採番します。 申込時にイプシロンの申込完了画面及びメールにて通知します。 |
| 2 | ユーザーID | user_id | 半角英数字.-+/@ 64byte以下 |
satoh002 | ○ | クレジットカード決済の登録済み課金及び定期課金を利用の場合、購入者様特定のため、購入者様単位でユニークなものを設定してください。 上記機能をご利用しない場合は自由に設定可能です。 |
| 3 | ユーザー氏名 | user_name | EUC or S-JIS 64byte | 佐藤太郎 | ○ | 購入者様の名前 |
| 4 | メールアドレス | user_mail_add | 半角英数字.-_@ 128byte以下 |
sato@sample.jp | ○ | 購入者様のメールアドレス |
| 5 | 商品コード | item_code | 半角英数字.-+/ 64byte以下 |
T2000 | ○ | 商品のコード 「0（数字のゼロ）」のみで構成される文字列の指定は不可。 |
| 6 | 商品名 | item_name | EUC or S-JIS 64byte |
りんご×5個 | ○ | 商品名 複数の商品を一度に記載する場合は制限文字数(半角64文字、全角32文字)以内とする スマートフォンキャリア決済（au）に限り以下文字列使用不可 ローマ数字, ～, 【, 】, － |
| 7 | オーダー番号 | order_number | 半角英数字 32byte |
A123456789 | ○ | 注文単位でユニークに設定してください。 同じオーダー番号で注文を実行するとエラーとなります。 |
| 8 | 決済区分 | st_code | 11000-0000-00000 | 11000-0000-00000 | ○ | 1桁目がVisa/Master/Dinersの契約、2桁目がJCB/AMEXの契約を表します。 それ以外の桁に『0』以外を設定しますとエラーになります。 JCB/AMEXをご契約していない場合でも、『11000』をセットしてください。 |
| 9 | 課金区分 | mission_code | 1～32 | 1 | ○ | 1回課金の場合は「1」を指定してください。 課金区分の詳細はこちら |
| 10 | 価格 | item_price | 1～9999999 | 50000 | ○ | クレジットカード決済の決済金額を設定。課金方法によって上限があります。 1回課金 9,999,999以下を設定 定期課金 9,999,999以下を設定 |
| 11 | 処理区分 | process_code | 1 or 2 | 1 | ○ | 1：初回課金 2：登録済み課金 2を設定した場合はNo.19:セキュリティコードチェックフラグ、 No.21:トークンは設定不要です。 |
| 12 | 予備1 | memo1 | EUC or S-JIS 128byte | 青森産 | △ | 自由項目 |
| 13 | 予備2 | memo2 | EUC or S-JIS 128byte | 配送は月曜日 | △ | 自由項目 |
| 14 | 支払い方法 | card_st_code | 半角数字1桁 | 10 | ▲ | NULL 10：一括 61：分割 （分割の場合は『分割数』が必須項目となります。） 80：リボ |
| 15 | 分割数 | pay_time | 半角数字 1桁～2桁 | NULL | ▲ | 支払い方法が61（分割）の場合のみ必須 3,5,6,10,12,15,18,20,24 が設定可能 |
| 16 | 3DSフラグ | tds_check_code | 半角数字 1桁 | 1 | △ | NULL or 1 ：通常処理 （初回） |
| 17 | 3DS-keitai | keitai | 半角数字 1桁 | 0 | ▲ | 購入者の利用端末が携帯の場合必須 NULL or 0 ：PC or 1：携帯 *3DS処理が携帯電話では利用不可のため通知が必要となります |
| 18 | 仮実フラグ | kari_flag | 半角数字 1桁 | 1 | △ | 仮実運用を強制的に設定します。 1：仮実を利用する 2：仮実を利用しない *NULL or 上記以外の場合は、管理画面設定上で設定されている内容に従います。 |
| 19 | セキュリティーコード チェックフラグ |
security_check | 半角数字 1桁 | 1 | ▲ | 5-2-1.(3)トークン発行時送信パラメータNo.5:セキュリティーコードを利用するか否かの設定フラグ。 1：セキュリティーコードを利用する それ以外 ：セキュリティーコードを利用しない *イプシロンの管理画面設定上セキュリティーコード利用不可になっている加盟店様の場合、セキュリティコードは利用されません。 |
| 20 | ユーザーエージェント | user_agent | 半角文字列 | Mozilla/5.0 (compatible; MSIE 10.0; Windows NT 6.1; Trident/6.0) | ○ | 購入者(お客様)のユーザーエージェント。 ユーザーエージェントから、購入者(お客様)利用端末を特定することで、加盟店様の契約内容と照らし合せ、携帯からのアクセスを制限します。 |
| 21 | トークン | token | 半角文字列 | vn409tqrq3jqf4r0qdpowqpweqj3 | △ | 事前にトークン発行をされた際に設定します。 No.11:処理区分が「2:登録済み課金」の場合は、設定不要です。 |
| 22 | 3DS2.0フラグ | tds_flag | 半角数字2桁 | 21 | ○ | 21 または 22を設定 |
【3Dセキュア義務化について】
3Dセキュアの義務化に伴いクレジットカード決済、多通貨決済では3Dセキュア認証支援サービスのご利用が必須となります。
3Dセキュア認証支援サービスご利用のためのご対応、システム構築をお願いいたします。
3Dセキュア専用パラメータは下記リンク先をご確認ください。
3Dセキュア専用パラメータ
【必須項目】
○：必須の項目です。値を設定してください。
▲：条件つきで必須項目となります。説明をご確認ください。
△：任意の設定項目です。
・トークンの有効期限について
発行されたトークンは、有効期限が経過するか、一度決済に利用されると、無効となります。
有効期限はトークンが発行されてから約30分となります。
・日本語の扱いに関する制限について
「﨑」のようなJISX0213定義文字以降に新たに定義された文字は文字化けする可能性がございます。
そのため、JISX0208定義文字で定義されております「崎」など他の文字で代用をお願いいたします。
以下パラメータをxml形式で応答します。※支払い方法が「未確定」の場合、下記パラメータは返却されません。
| No. | 項目名 | パラメータ名 | 属性 | 例 | 必須 | 説明 |
|---|---|---|---|---|---|---|
| 1 | トランザクションコード | trans_code | 半角数字 | 12345678 | △ | イプシロンから発番される注文受付番号です。 パラメータ相違等により取引を受け付けられなかった場合には設定されません。 |
| 2 | 決済結果 | result | 半角数字 | 1 | ○ | 0：決済NG 1：決済OK 3Dセキュアの完全義務化に伴い「result:1」の応答は廃止されます。 6：3DS処理（EP画面にリダイレクト必要） 9：システムエラー（パラメータ不足、不正等） |
| 3 | エラーコード | err_code | 半角英数字 | 602 | △ | 「イプシロン決済システム仕様書」末尾のエラーコード一覧をご参照ください。 |
| 4 | エラーメッセージ | err_detail | S-JIS 2byte文字 | オーソリ処理NG（有効期限が不正です） | △ | 「イプシロン決済システム仕様書」末尾のエラーコード一覧をご参照ください。 |
| 5 | 3DS接続URL | acsurl | 桁数不明 | https://secure.co.jp/XXXX | △ | 決済結果：5 の場合設定されます。 ３DS処理時カード会社への接続用URL URLエンコードされています。 |
| 6 | 3DS認証要求電文 | pareq | 桁数不明 | XXXXXXXXXXXXXXXXXX | △ | 決済結果：5 の場合設定されます。 3DS認証処理に必要な項目です。 |
| 7 | 仮実フラグ | kari_flag | 半角数字1桁 | 1 | △ | 決済結果：1 の場合設定されます 対象取引の決済状況 1：課金済み 2：仮売上 |
No.3、No.4のエラー内容については「イプシロン決済システム仕様書」末尾のエラーコード一覧をご参照ください。
決済結果(result)の値によって後続処理の対応をお願いします。
「イプシロン決済システム仕様書」は管理画面にてダウンロードいただけます。
▼仕様書のダウンロードはこちら
管理画面【サポート】⇒【各種資料ダウンロード】