J-Payment クレジットカード決済システム接続仕様書

Size: px

Start display at page:

Download "J-Payment クレジットカード決済システム接続仕様書"

かんじひらみね
5 years ago
Views:

1 クレジットカード決済 3D セキュア設定マニュアル ( トークン決済方式 )

2 目次概要 : トークン決済方式概要 P.3 : 対応ブラウザ P.4 :3D セキュア概要 P.5 必要パラメータ通知パラメータ一覧 : ポップアップ方式実装方法 P.6 : カスタマイズ方式実装方法 ( サンプル ) P.8 : トークン生成 JavaScript 送信パラメータ P.10 : 商品登録なしの決済 P.11 : 商品登録ありの決済 P.12 : カード有効性チェック P.13 : 決済後に通知されるパラメータ P.14 その他 : エラーコード表 P.15 2

トークン決済方式概要ユーザーが入力するクレジットカード番号を別の文字列 ( トークン ) に置き換えて通信を行いお支払いを完了させる情報漏洩リスクを軽減できる決済方法です加盟店様はトークン決済をご利用いただくことでクレジットカード番号を保持することなく決済処理が可能となりますユーザーが入力するクレジットカード番号を JavaScript へリンクし当社へ送信し

3 トークン決済方式概要ユーザーが入力するクレジットカード番号を別の文字列 ( トークン ) に置き換えて通信を行いお支払いを完了させる情報漏洩リスクを軽減できる決済方法です加盟店様はトークン決済をご利用いただくことでクレジットカード番号を保持することなく決済処理が可能となりますユーザーが入力するクレジットカード番号を JavaScript へリンクし当社へ送信し当社はその番号を別の文字列 ( トークン ) に置き換えて加盟店様へご返却し決済を行う仕様です決済方式とポップアップ方式カスタマイズ方式の 2 種類がございますポップアップ方式 JavaScript でユーザーのブラウザ内に弊社で用意しました決済画面をポップアップで呼び出しカード情報をトークンに置き換えて加盟店様へ返却し決済を行う方式となります < ポップアップ方式決済画面イメージ > カスタマイズ方式加盟店サイト内でカード情報を入力後 JavaScript で弊社サーバーへ通信しカード情報をトークンに置き換えて加盟店様へ返却し決済を行う方式となります 3

4 対応ブラウザトークン情報は Javascript の非同期通信より生成されるため対応ブラウザは下記となります Internet Explorer(Microsoft がサポート対象としているバージョンに限る ) Microsoft Edge 最新版 Google Chrome 最新版 Firefox 最新版 Safari 最新版上記以外のブラウザに関しましては正常に動作しない可能性がございますのでブラウザのアップデート等を行いご確認いただきますようお願い致します JavaScript の利用できない端末 ( 一部フィーチャーフォン等 ) ではトークン決済を行う事が出来ません 4

5 3D セキュア概要 3D セキュアは国際カードブランドの VISA(VISA 認証サービス ) MasterCard(SecureCode) JCB(J/Secure) の提供するサービスですネット通販でクレジットカードを利用する際カード番号のほかに本人しか知らない ID パスワードを事前に登録し都度入力することにより利用者を確認し認証できるサービスです 3D セキュアの最大のメリットとしてネット決済でも実店舗での決済と同様に本人確認をすることができるために加盟店様でなりすまし被害等によるチャージバックを防ぐことができる点があげられます 3D セキュアご利用のご注意点 3D セキュアの認証には通常の Gateway 方式とは違った接続方法になりますので別途 3D セキュア認証用ソースコードを準備する必要がございます 3D セキュアの認証方法サンプルソースにつきましては次ページ以降をご確認ください通常のトークン方式との違い決済データ送信先 URL は専用の URL にご送信ください決済結果通知方法パラメータ rt の値は 0( キックバック ) を推奨いたします決済データ送信時 ( ソケット通信 ) の HTTP メソッドは GET 送信のみとなります POST 送信をされますとエラーとなるのでご注意ください通常の Gateway 方式接続時の値に結果受け取り URL url を追加してください url 3D セキュア Gateway 方式の返り値を受け取るための URL となります外部からアクセスできる有効な URL を設定してください 5

6 ポップアップ方式実装方法 ( サンプル ) 1 決済システムにて提供する JavaScript をインポートする <head> <script type="text/javascript" src=" <script type="text/javascript" src=" </head> 2 受け取ったトークンを格納するフィールドとポップアップ表示用の <div> タグを設置する <form id="mainform"> <input id="tkn" name="tkn" type="hidden" value=""> <div id="card_input_form" /> <input type="button" value=" 購入する " onclick="dopurchase()"/> </form> 3 カード情報入力フォーム表示の JavaScript を実装する // カード情報入力フォーム表示 functiojn dopurchase() { } //CP 非同期通信よりカード番号入力画面を表示する CPToken.CardInfo ( { aid: 'xxxxxx' }, execpurchase ); 次のページへ続く 6

7 ポップアップ方式実装方法 ( サンプル ) 4 受け取ったトークン情報を設定しフォームの送信処理を行う JavaScript を実装する // コールバック関数 function execpurchase(resultcode, errmsg) { if (resultcode!= "Success") { // 戻り値が Success 以外の場合はエラーメッセージを表示 window.alert(errmsg); } else { // スクリプトからフォームを submit $("#mainform").submit(); } } 7

8 カスタマイズ方式実装方法 ( サンプル ) 1 決済システムにて提供する JavaScript をインポートする <head> <script type="text/javascript" src=" <script type="text/javascript" src=" </head> 2 受け取ったトークンを格納するフィールドを設置する <form id="mainform"> カード番号 : <input type="text" value="" name="cn" id="cn" /> カード有効期限 : <input type="text" value="" name="ed_year" id="ed_year" /> / <input type="text" value="" name="ed_month" id="ed_month" /> カード名義人 : <input type="text" value="" name="fn" id="fn" /> <input type="text" value="" name="ln" id="ln" /> <input id="tkn" name="tkn" type="hidden" value=""> <input type="button" value=" 購入する " onclick="dopurchase()"/> </form> 次のページへ続く 8

9 カスタマイズ方式実装方法 ( サンプル ) 3 トークンを生成するための JavaScript を実装する functiojn dopurchase() { } // CP 非同期通信よりトークンを生成する CPToken.TokenCreate ( { aid: 'xxxxxx', cn: $("#cn").val(), ed: $("#ed_year").val() + $("#ed_month").val(), fn: $("#fn").val(), ln: $("#ln").val() }, execpurchase ); 4 受け取ったトークン情報を送信するための JavaScript を実装する // コールバック関数 function execpurchase(resultcode, errmsg) { if (resultcode!= "Success") { window.alert(errmsg); } else { // カード情報を消去 $("#cn").val(""); $("#ed_year").val(""); $("#ed_month").val(""); $("#fn").val(""); $("#ln").val(""); // スクリプトからフォームを submit $("#mainform").submit(); } } サイト内でユーザー様が入力したカード情報は必ず消去するように構築をお願い致します 9

10 トークン生成 JavaScript 送信パラメータトークン生成用の JavaScript 関数 CPToken.TokenCreate ( { 送信する JSON パラメータ }, コールバック関数 ); ポップアップ方式の送信パラメータ一覧項目フィールド詳細必須指定条件店舗 ID aid ご契約時に発行されます半角英数 (6) カスタマイズ方式の送信パラメータ一覧項目フィールド詳細必須指定条件店舗 ID aid ご契約時に発行されます半角英数 (6) カード番号 cn ご利用のカード番号半角数字カード有効期限 ed ご利用カードの有効期限 (YYMM 形式 ) 半角数字カード名義 ( 名 ) fn ご利用カードの名義 ( 名 ) 半角英字カード名義 ( 姓 ) ln ご利用カードの名義 ( 姓 ) 半角英字セキュリティコード cvv VISA MSTER JCB DINERS はカード裏面の 3 桁の番号 AMEX のみカード表面の 4 桁の番号 1 半角数字支払方法 md 10 一括払い 61 分割払い 80 リボ払い 2 定型分割回数 pt 3,5,6,10,12,15,18,20,24 から選択支払方法 (md) 指定時のみ必須定型 < 1> セキュリティーコードをご契約頂いている場合は必須パラメータとなります < 2> 分割払いリボ払いのご利用にカード会社の審査が必要ですご利用の際は弊社サポートセンターにご連絡ください 10

11 必要なパラメータ商品登録なしの決済商品登録なしの決済を行う場合商品金額税額送料の合計値を決済サーバに通信頂きます決済金額の指定を動的に行える為ショッピングカートとの連携等を行う際に有効的です決済データ送信先 URL 必要パラメータ一覧項目フィールド詳細必須指定条件店舗 ID aid ご契約時に発行されます半角数字 (6) ジョブタイプ jb 決済処理方法 AUTH ( 仮売上 ) 1 CAPTURE ( 仮実同時売上 ) 2 定型決済結果返信方法 rt 0 キックバック 1 レスポンス店舗オーダー番号 cod オーダーを識別する為のパラメータを任意で送信することができます定型半角英数 (50) トークン情報 tkn トークン情報半角数字メールアドレス em メールアドレス半角英数 (100) 電話番号 pn 電話番号半角数字 (20) 商品金額 am 商品金額をご指定下さい 3 半角数字税金額 tx 税額をご指定下さい 4 半角数字送料 sf 送料をご指定下さい 5 半角数字結果受け取りURL url 3Dセキュア決済となった場合決済結果を受け取り表示するURL その他データその他パラメータを自由に設定し任意で送信することが出来ます 6 半角英数指定なし 1024Bite 以内 < 1 2> AUTH( 仮売上 ) を指定した場合決済後 90 日以内に実売上を行ってください実売上を行って頂かないとお客様への請求が確定いたしません CAPTURE( 仮実同時売上 ) を指定した場合決済時に自動的に実売上が行われます < 3 4 5> 決済金額 + 税金額 + 送料の値がカード会社に送信されます商品金額に送料税額を含む場合 tx sf は 0 をご指定下さい < 6> その他パラメータで改行コードスペースを送信される場合必ずエンコード処理を行ってください 11

12 必要なパラメータ商品登録ありの決済商品登録ありの決済を行う場合事前に管理画面上にて商品情報の登録を行って頂く必要がございます登録頂いた商品情報をもとに決済を行う為商品種類が予め決まっている場合に有効的です決済データ送信先 URL 必要パラメータ一覧項目フィールド詳細必須指定条件店舗 ID aid ご契約時に発行されます半角数字 (6) 決済結果返信方法 rt 0 キックバック 1 レスポンス店舗オーダー番号 cod オーダーを識別する為のパラメータを任意で送信することができます定型半角英数 (50) トークン情報 tkn トークン情報半角文字メールアドレス em メールアドレス半角英数 (100) 電話番号 pn 電話番号半角数字 (20) 商品コード iid 商品コード半角英数 (50) 結果受け取りURL url 3Dセキュア決済となった場合決済結果を受け取り表示するURL その他データその他パラメータを自由に設定し任意で送信することが出来ます 1 半角英数指定なし 1024Bite 以内 < 1> その他パラメータで改行コードスペースを送信される場合必ずエンコード処理を行ってください 12

13 必要なパラメータカード有効性チェック対象のクレジットカードの有効性のみを確認する処理方法です 0 円での課金処理を行いますので決済処理費用が発生いたします決済データ送信先 URL 必要パラメータ一覧項目フィールド詳細必須指定条件店舗 ID aid ご契約時に発行されます半角数字 (6) ジョブタイプ jb CHECK カード有効性チェック定型決済結果返信方法 rt 0 キックバック 1 レスポンス店舗オーダー番号 cod オーダーを識別する為のパラメータを任意で送信することができます定型半角英数 50 字以内トークン情報 tkn トークン情報半角文字メールアドレス em メールアドレス半角英数 (100) 電話番号 pn 電話番号半角数字 (50) 結果受け取りURL url 3Dセキュア決済となった場合決済結果を受け取り表示するURL その他データその他パラメータを自由に設定し任意で送信することが出来ます 1 半角英数指定なし 1024Bite 以内 < 1> その他パラメータで改行コードスペースを送信される場合必ずエンコード処理を行ってください 13

14 決済後に通知されるパラメータ決済時に決済結果通知方法 rt=0 を選択した場合決済結果はキックバックにて通知され rt=1 を選択した場合は決済結果を HTML 出力しますキックバックパラメータ一覧項目フィールド詳細必須通知条件決済番号 gid 決済ごとに発行されるユニーク ID 半角英数決済結果 rst 決済成功は 1 決済失敗は 2 が通知されます半角数字 (1 字 ) カード会社承認番号 ap 決済ごとに発行されるユニーク ID 半角英数 (6~7 字 ) エラーコード ec 詳細はエラーコード一覧をご覧ください 1 半角英数 (12 字 ) オーダーコード god 決済ごとに発行されるユニーク ID 半角数字店舗オーダー番号 cod 決済データ送信時に送信された店舗オーダー番号決済金額 am 決済データ送信時に送信された決済金額半角英数 (50 字以内 ) 半角数字税金額 tx 決済データ送信時に送信された税額半角数字送料 sf 決済データ送信時に送信された送料半角数字合計金額 ta 決済金額 + 税金額 + 送料の値半角数字発行 ID id 弊社システムより発行された ID 半角英数 (50 字以内 ) 発行パスワード ps 弊社システムより発行されたパスワード半角英数 (50 字以内 ) その他決済データ送信時に送信されたその他データ指定なし (1024Bite 以内 ) < 1> カード会社通信後エラー (G から始まるエラーコード ) のみキックバックしますパラメータエラー (ER から始まるエラーコード ) はキックバックしませんのでご注意ください 14

15 エラーコード対応一覧表 (1) [ パラメータエラー ] カード会社との通信前に弊社サーバより通知されるエラーコードですエラーコードエラー情報対処方法 ER000 決済システム内部エラー ( 例外 ) 再度決済処理を行ってください ER001 リクエストエラー ( ゲートウェイ等例外 ) 送信パラメータに不備がございます今一度ご確認ください ER002 決済送信元 URL エラー (Referer エラー ) HTML リンク方式の場合のみ発生管理画面システム設定より決済データ送信元 URL 設定をご設定ください ER003 決済送信元 IP エラー Gateway 方式の場合のみ発生管理画面システム設定より決済データ送信元 IP をご設定ください ER004 未登録店舗恐れ入りますが ER005 未登録商品指定されている商品コード (iid) の値に不備がございます ER006 発行可能 ID/PW なし管理画面より発行可能な ID/PW をご登録ください ER010 決済処理が込み合ってます恐れ入りますが ER011 決済拒否 -IP アドレス恐れ入りますが ER012 決済拒否 -メールアドレス恐れ入りますが ER013 決済拒否 -カード番号ご利用頂けないカード番号です別のカードをご利用ください ER014 クレジットカードチェックデジットエラーご入力頂いたカード番号に不備がございますカード番号をご確認ください ER015 未取り扱いカード ( カードタイプエラー ) ご利用頂けないカード番号です別のカードをご利用ください ER016 ご利用可能金額上限決済可能上限額を超えています決済金額をご確認ください ER017 お取り扱いできない金額 ( 決済金額下限 ) 決済下限額を下回っています決済金額をご確認ください ER018 お取り扱いできない金額 ( 決済金額上限 ) 決済可能上限額を超えています決済金額をご確認ください 15

16 エラーコード対応一覧表 (2) [ パラメータエラー ] カード会社との通信前に弊社サーバより通知されるエラーコードですエラーコードエラー情報対処方法 ER019 分割払いエラーご利用頂いたカードの分割払い可能金額を満たしていません詳しくはご契約のクレジットカード会社様に直接お問い合わせください ER021 ER022 ER023 ER024 ワンタッチ課金 : 決済条件エラークイックチャージ : 決済条件エラーカード情報変更 : 情報変更可能条件エラー自動課金停止中エラー Gateway 処理のみワンタッチ課金実行時のパラメータに不備がございます今一度ご確認ください恐れ入りますが対象の自動課金が停止中となっています情報変更の際は自動課金を再開してください自動課金停止中のデータの為弊社管理画面をご確認下さいませ ER030 決済失敗 ( すべて ) 恐れ入りますが ER031 有効性確認失敗 (CEHCK) 恐れ入りますが ER032 実売上失敗 (SALES) 恐れ入りますが ER033 取消失敗恐れ入りますが ER042 通信エラー恐れ入りますが ER050 店舗 ID エラー店舗 ID(aid) の値に不備がございます ER051 ジョブコードエラージョブコード (jp) の値に不備がございます ER052 決済結果通知方法エラー決済結果通知方法 (rt) の値に不備がございます ER053 決済番号エラー決済番号 (tid) の値に不備がございます ER054 オーダーコードエラーオーダーコード (cod) の値に不備がございます ER055 クレジットカード番号エラークレジットカード番号 (cn) の値に不備がございます ER056 有効期限エラー有効期限 (ed) の値に不備がございます ER057 名前エラー名前 (fn) の値に不備がございます ER058 苗字エラー苗字 (ln) の値に不備がございます ER059 メールアドレスエラーメールアドレス (em) の値に不備がございます 16 16

17 エラーコード対応一覧表 (3) [ パラメータエラー ] カード会社との通信前に弊社サーバより通知されるエラーコードですエラーコードエラー情報対処方法 ER060 電話番号エラー電話番号 (pn) の値に不備がございます ER061 商品金額エラー商品金額 (am) の値に不備がございます ER062 税金額エラー税金額 (tx) の値に不備がございます ER063 送料エラー送料 (sf) の値に不備がございます ER064 支払い方法エラー支払い方法 (md) の値に不備がございます ER065 分割回数エラー分割回数 (pt) の値に不備がございます ER068 商品コードエラー商品コード (iid) の値に不備がございます ER069 コマンドコードエラーコマンドコード (cmd) の値に不備がございます ER072 自動課金番号エラー自動課金番号 (acid) の値に不備がございます ER079 セキュリティコードエラーセキュリティコード (cvv) の値に不備がございます ER107 リクエストメソッドエラー HTML FORM POST/GET 形式で決済フォームへリンクしてください ER114 店舗 ID 指定エラー店舗 ID(aid) の値に不備がございます ER117 ER119 店舗情報取得エラー恐れ入りますが ER125 次回課金日エラー次回課金日 (nad) の値に不備がございます ER126 課金周期エラー課金周期 (actp) の値に不備がございます ER127 課金指定日エラー課金指定日 (ac1) の値に不備がございます ER128 課金停止回数エラー課金停止回数 (ac3) の値に不備がございます ER129 課金終了日エラー課金終了日 (ac5) の値に不備がございます ER554 自動課金登録エラー恐れ入りますが ER559 新自動課金未設定エラー恐れ入りますが ER564 カード決済サービス未契約恐れ入りますが ER565 トークン決済 AES 暗号化キー未発行恐れ入りますが 17

18 エラーコード対応一覧表 (4) [ パラメータエラー ] カード会社との通信前に弊社サーバより通知されるエラーコードですエラーコードエラー情報対処方法 ER567 RSA 暗号化キー未発行恐れ入りますが ER583 トークン未設定リクエストパラメータの tkn 値が未設定の場合 tkn 値が送信されているかご確認ください ER584 トークン情報無効決済のリクエストパラメータから取得した tkn 値で決済システムからトークン情報が取得できなかった場合 ER585 トークン有効期限切れトークンが発行されてから有効期限 (15 分 ) 過ぎて決済のリクエストが送られてきた場合 ER586 ER900 ER901 トークン決済でカード番号送信されている 3D セキュアエラー決済のリクエストパラメータに cn ( カード番号 ) が指定されている場合ご利用されたカードが 3D セキュアに対応しているかをご確認ください ER570 課金周期パラメータエラー課金周期 (actp) の値に不備がございます ER571 自動課金ジョブタイプエラージョブタイプ (jb) の値に不備がございます ER572 お試し期限エラーお試し期限 (tr3) の値に不備がございます ER573 自動課金金額エラー自動課金金額 (acam) の値に不備がございます ER574 ER581 ER575 ER582 自動課金下限金額エラー決済可能下限額を超えています決済金額をご確認ください自動課金上限金額エラー決済可能上限額を超えています決済金額をご確認ください ER576 課金日指定エラー課金周期が毎週 / 隔週の場合は課金日指定は利用できません ER577 お試し日数エラーお試し日数 (tr1) の値に不備がございます ER578 お試し月数エラーお試し月数 (tr2) の値に不備がございます ER579 お試し期限エラーお試し期限 (tr3) の値に不備がございます ER580 お試し金額エラーお試し金額 (tram) の値に不備がございます ER902 郵便番号エラー郵便番号の値に不備がございます ER903 名前エラー名前の値に不備がございます ER904 住所エラー住所の値に不備がございます ER905 支払期限制限エラー恐れ入りますが 18

19 エラーコード対応一覧表 (4) [ パラメータエラー ] カード会社との通信前に弊社サーバより通知されるエラーコードですエラーコードエラー情報対処方法 ER998 アカント停止中恐れ入りますが ER999 メンテナンス中メンテナンス中ですしばらくお待ちください 19

20 エラーコード対応一覧表 (5) [ カード与信エラー ] カード会社への通信後カード会社サーバより通知されるエラーコードですエラーコードエラー情報対処方法 G0442G 残高不足エラー ( デビットカー / プリペイドカード ) お客様ご利用のカード会社へお問合せください G1242G 取扱不可カードお客様ご利用のカード会社へお問合せください G3042G 取扱不可カードお客様ご利用のカード会社へお問合せください G4242G 暗証番号エラーお客様ご利用のカード会社へお問合せください G4442G セキュリティコード不正エラーお客様ご利用のカード会社へお問合せください G4542G セキュリティコードエラーお客様ご利用のカード会社へお問合せください G5442G 取扱不可カードお客様ご利用のカード会社へお問合せください G5542G 限度額オーバーお客様ご利用のカード会社へお問合せください G5642G カード読込エラーお客様ご利用のカード会社へお問合せください G6042G 事故カードお客様ご利用のカード会社へお問合せください G6142G 無効カードお客様ご利用のカード会社へお問合せください G6542G 会員番号エラーお客様ご利用のカード会社へお問合せください G6842G 金額エラーお客様ご利用のカード会社へお問合せください G6942G 税送料エラーお客様ご利用のカード会社へお問合せください G7442G 分割回数エラーお客様ご利用のカード会社へお問合せください G7842G 支払区分エラーお客様ご利用のカード会社へお問合せください G8042G 取消区分エラーお客様ご利用のカード会社へお問合せください G8342G 有効期限エラーお客様ご利用のカード会社へお問合せください G9742G 取扱不可カードお客様ご利用のカード会社へお問合せください G9842G 取扱不可カードお客様ご利用のカード会社へお問合せください G9942G 取扱不可カードお客様ご利用のカード会社へお問合せください G から始まるエラーコードについて実店舗決済 ( リアル決済 ) では使用できるカードであってもインターネット上では稀に決済できない場合が御座います S から始まるエラーコードについて表示された場合は弊社設定に関するエラーの場合がございます弊社カスタマーサポート宛にご確認下さい 20

J-Payment クレジットカード決済システム接続仕様書

J-Payment クレジットカード決済システム接続仕様書クレジットカード決済エラーコード表 2013.08.09 目次エラーコード一覧パラメータエラー P.3-6 カード与信エラー P.7 2 エラーコード対応一覧表 (1) [ パラメータエラー ] ER000 決済システム内部エラー ( 例外 ) 再度決済処理を行ってください ER001 リクエストエラー ( ゲートウェイ等例外 ) 送信パラメータに不備がございます今一度ご確認ください ER002

J-Payment クレジットカード 決済システム接続仕様書

J-Payment クレジットカード決済システム接続仕様書