送受信パラメータの仕様

2.接続先URL

接続先URLは以下になります。
【本番環境】 https://secure.epsilon.jp/cgi-bin/order/direct_card_payment.cgi
【テスト環境】 https://beta.epsilon.jp/cgi-bin/order/direct_card_payment.cgi

3.送信パラメータ

「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 商品のコード
6 商品名 item_name EUC or S-JIS
64byte 
りんご×5個 商品名
複数の商品を一度に記載する場合は制限文字数(半角64文字、全角32文字)以内とする
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以下を設定
   月次課金 30,000以下を設定
定期課金 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:登録済み課金」の場合は、設定不要です。

【必須項目】
○:必須の項目です。値を設定してください。
▲:条件つきで必須項目となります。説明をご確認ください。
△:任意の設定項目です。
・トークンの有効期限について
発行されたトークンは、有効期限が経過するか、一度決済に利用されると、無効となります。
有効期限はトークンが発行されてから約30分となります。
・日本語の扱いに関する制限について
「﨑」のようなJISX0213定義文字以降に新たに定義された文字は文字化けする可能性がございます。
そのため、JISX0208定義文字で定義されております「崎」など他の文字で代用をお願いいたします。

4.受信パラメータ

以下パラメータをxml形式で応答します。

No. 項目名 パラメータ名 属性 必須 説明
1 トランザクションコード trans_code 半角数字 12345678 イプシロンから発番される注文受付番号です。
パラメータ相違等により取引を受け付けられなかった場合には設定されません。
2 決済結果 result 半角数字 1 0:決済NG
1:決済OK
5:3DS処理 (カード会社に接続必要)
9:システムエラー(パラメータ不足、不正等)
3 エラーコード err_code 半角英数字 602 エラーコード一覧(決済API版)をご参照ください。
4 エラーメッセージ err_detail S-JIS 2byte文字 オーソリ処理NG(有効期限が不正です) エラーコード一覧(決済API版)をご参照ください。
5 3DS接続URL acsurl 桁数不明 https://secure.co.jp/XXXX 決済結果:5 の場合設定されます。
3DS処理時カード会社への接続用URL
URLエンコードされています。
6 3DS認証要求電文 pareq 桁数不明 XXXXXXXXXXXXXXXXXX 決済結果:5 の場合設定されます。
3DS認証処理に必要な項目です。
7 仮実フラグ kari_flag 半角数字1桁 1 決済結果:1 の場合設定されます
対象取引の決済状況
1:課金済み
2:仮売上

No.3、No.4のエラー内容についてはエラーコード一覧(トークン版)をご参照ください。
決済結果(result)の値によって後続処理の対応をお願いします。