トークンの取得

トークン取得と、初回課金に必要なもの

本ページは接続仕様書ver,3.0.0以降をご覧の方を対象に公開しています。

1. 当社が公開しているJavaScriptファイルを参照する

記述場所は<head>内を推奨します。

  1. <script src="https://token.ccps.jp/UpcTokenPaymentMini.js"></script>  

2. 店舗IDの識別と、各種フィールド名を定義するJavaScript

記述場所は</body>の直前を推奨します。なお末尾の</script>は省略して「3.」の記述と繋げることも可能です。設置ページに他のJavaScriptの記述がある場合、それ以降に(読み込みが最後になるよう)記述することを推奨します。

  1. <script type="text/javascript">    
  2. function getMemberToken() {  
  3.     //ボタンの無効化  
  4.     document.getElementById("token").disabled = true;  
  5.     var cardno, securitycode, expire, holderfirstname, holderlastname, memberid, membercode,  
  6.     email, phonenumber;  
  7.     cardno = document.getElementById('cardno').value;  
  8.     securitycode = document.getElementById('securitycode').value;  
  9.     expire = document.getElementById('expire_month').value + '' +  
  10.     document.getElementById('expire_year').value;  
  11.     holderfirstname = document.getElementById('holderfirstname').value;  
  12.     holderlastname = document.getElementById('holderlastname').value;  
  13.     memberid = document.getElementById('memberid').value;  
  14.     membercode = document.getElementById('membercode').value;  
  15.     email = document.getElementById('email').value;  
  16.     phonenumber = document.getElementById('phone_number').value;  
  17.     Multipayment.init('100001'); //当社発行の店舗ID  
  18.     Multipayment.getMember({ //決済フォームより取得した情報  
  19.         cardno: cardno, //カード番号  
  20.         securitycode: securitycode, //セキュリティコード  
  21.         expire: expire, //カード有効期限  
  22.         holderfirstname: holderfirstname, //カードホルダー名  
  23.         holderlastname: holderlastname, //カードホルダー姓  
  24.         memberid: memberid, //会員番号  
  25.         membercode: membercode, //会員コード  
  26.         email: email, //メール  
  27.         phonenumber: phonenumber//電話番号  
  28.         },  
  29. execMemberPurchase);  
  30. }  
  31. </script>  

3. 取得したトークンで課金リクエストするためのJavaScript

リクエストに基づくトークン化が完了した際に、それを受け取って課金リクエストするために必要な記述です。19行目のコメントアウトを解除して記述すれば、課金時の消費者によるボタン押下を自動化することで省略します。

カード情報保持/通過に関する重要事項告知

「カード番号など不要な(保持・通過すべきでない)データを削除する」とコメントされた記述は絶対に変更しないでください。PCI DSSに準拠していない加盟店がカード情報を保持/通過させた場合、加盟契約の打ち切りの可能性があるばかりか、アクワイアラないしカードブランドから罰金が課せられる可能性があり、その場合、当社は加盟店様へ罰金の全額と対応にかかる実費を請求いたします。

  1. <script type="javascript">  
  2. function execMemberPurchase(response) {  
  3.     if (response.resultCode !== "000" && response.resultCode !== 0) {  
  4.         var lang = "ja";  
  5.             if (document.getElementById('lang') != null)  
  6.                     lang = document.getElementById('lang').value;  
  7.             window.alert('Error: ' + getResultCodeDetail(response.resultCode, lang));  
  8.             } else {  
  9.                 //カード番号など不要な(保持・通過すべきでない)データを削除する  
  10.                     document.getElementById('cardno').value = "";  
  11.                     document.getElementById('securitycode').value = "";  
  12.                     document.getElementById('expire_year').value = "";  
  13.                     document.getElementById('expire_month').value = "";  
  14.                     document.getElementById('holderfirstname').value = "";  
  15.                     document.getElementById('holderlastname').value = "";  
  16.                     // TokenをセットしフォームをSubmitする  
  17.                     document.getElementById('upcmemberid').value = response.tokenObject.token;  
  18. // 決済処理まで行う場合はコメントアウトを外す   
  19. //submit();  
  20. }  
  21. }  
  22. </script>  

4. カード情報(カード番号、有効期限、姓、名)を「5.」に"getMemberToken()"する<form>タグ

  1. <form action="「5.」の設置先URL。多くの場合この記述があるページ自身" method="get" name="purchaseForm" id="purchaseForm">  
  2.     <p>言語:<select name="lang" id="lang">  
  3.         <option value="ja">日本語(ja)</option>  
  4.         <option value="en">英語(en)</option>  
  5.         <option value="cn">中国語簡体字  
  6.         (cn)</option>  
  7.         <option value="tw">中国語繁体字(tw)</option>  
  8.         </select>  
  9.     </p>  
  10.     <p>カード番号:  
  11.         <input type="text" name="cardno" id="cardno">  
  12.     </p>  
  13.     <p>セキュリティコード:  
  14.         <input type="text" name="securitycode" id="securitycode">  
  15.     </p>  
  16.     <p>カード有効期限:  
  17.         <input type="text" name="expire_month" id="expire_month">/<input type="text" name="expire_year" id="expire_year">  
  18.     </p>  
  19.         <p>カード名(名):  
  20.         <input type="text" name="holderfirstname" id="holderfirstname">   
  21.         カード名(姓):  
  22.         <input type="text" name="holderlastname" id="holderlastname">  
  23.         </p>  
  24.         <p>会員番号:<!--継続課金をする場合必須-->  
  25.         <input type="text" name="memberid" id="memberid">  
  26.         </p>  
  27.         <p>会員コード:<!--注文や会員を識別する任意の文字列-->  
  28.         <input type="text" name="membercode" id="membercode">  
  29.         </p>  
  30.         <p>メール:  
  31.         <input type="text" name="email" id="email">  
  32.         </p>  
  33.         <p>電話番号:  
  34.         <input type="text" name="phonenumber" id="phonenumber">  
  35.         </p>  
  36.         <p>  
  37.         <input type="button" onclick="getMemberToken()" id="token" value="会員情報Token化">  
  38.         <input type="button" onclick="submit()" value="決済処理  
  39. ">  
  40.         </p>  
  41.         <p>ShopId:  
  42.         <input type="text" readonly="readonly" value="100001" id="sid" name="sid">  
  43.         </p>  
  44.         <p>UpcMemberId<input type="text" readonly="readonly" value="" id="upcmemberid" name="upcmemberid">  
  45.         </p>  
  46. </form>  

5. サーバ間通信を行うプログラム

ここでは一例としてphpを使い、 仮実働時処理をする記述を紹介しています。実装時には接続仕様書とゲートウェイ接続サンプルを参照の上、加盟店サイトのビジネスモデルに適したジョブ(処理)内容に編集してください。

  1. require_once 'HTTP/Request.php';  
  2.   
  3.     /*  
  4.         sid:店舗ID  
  5.         svid:サービス種別(1:固定)  
  6.         ptype:処理種別(1:Gateway接続)  
  7.         job:決済ジョブタイプ(CAPTURE:仮実同時処理)  
  8.         upcmemberid:トークン 
  9.         rt:結果返信方法(2:レスポンス)  
  10.         sod:店舗オーダー番号(店舗独自のパラメータ)  
  11.         siam1:商品金額  
  12.         sisf1:商品送料  
  13.     */    
  14.   
  15.     //upcmemberidが設定されていないと決済時エラーになりますので、適宜エラーハンドリングを行うようにしてください。  
  16.     $token="";  
  17.     $token = $_POST["upcmemberid"];  
  18.   
  19.     /* 接続URLの設定 */    
  20.     $url = 'https://gw.ccps.jp/memberpay.aspx?';    
  21.     $url = $url . 'sid=100010&svid=1&ptype=1&job=CAPTURE&rt=2';    
  22.     $url = $url . '&upcmemberid=' . $token;  
  23.     $url = $url . '&sod=testtransaction';  
  24.     $url = $url . '&siam1=1050&sisf1=0';    
  25.   
  26.     $request = &new HTTP_Request();  
  27.     $request->setURL($url);  
  28.   
  29.     /* 結果HTMLの取得 */  
  30.     $result = $request->sendRequest();  
  31.   
  32.     /* 結果が取得できれば処理継続 */  
  33.     if (!PEAR::isError($result)) {  
  34.         $data = $request->getResponseBody();  
  35.   
  36.         //&を区切りにレンスポンスデータを分割し配列にする  
  37.         $result_array = explode('&'$data);  
  38.   
  39.         for$i = 0; $i < count$result_array ); $i++ )  
  40.         {  
  41.             $target_array = explode'='$result_array[$i] );  
  42.             if$target_array[0] == "rst" ) {break;}  
  43.         }  
  44.   
  45.         if ( (int)$target_array[1] == 1 ) {  
  46.             /* 決済処理成功の場合はここに処理内容を記載 */  
  47.             print ( '決済成功' );  
  48.         } else {  
  49.             /* 決済処理失敗の場合はここに処理内容を記載 */  
  50.             print ( '決済失敗' );  
  51.         }  
  52.   
  53.     } else {  
  54.         /* 決済処理エラーの場合は個々に処理内容を記載 */  
  55.         print ( '決済エラー' );  
  56.     }  
  57.               

動作サンプル

動作サンプルは以下になります。