最短5営業⽇で決済機能付きのフォームを公開
する⼿順
◆必要な契約 株式会社ゼウスと契約 SPIRAL基本契約 SPIRALAPIオプション(分間10件以上決済の発⽣が想定される場合) ◆必要なスキル HTML,CSS,PHP ◆作業⼯数 1営業⽇ ※デザイン抜きの場合 ※必要最低限の⼿順のみ公開しております。要件に合わせて変更してください。 ※現時点の仕様を記載しております。仕様変更による動作保証はしておりません。ご了承ください。2 1.必要な契約の準備 2.SPIRALの設定 (1)DB発⾏ (2)イベント申込フォーム発⾏ (3)決済後リダイレクトページ発⾏ (4)決済結果処理⽤ページ発⾏ 3.ZEUSの設定 (5)システム利⽤内容申込 (6)IPコード取得 4.連携設定 (7)APIトークン発⾏ (8)決済ページ呼び出し (9)決済結果受け取り処理 5.動作確認
⼿順
⼿順
1.必要な契約の準備 2.SPIRALの設定 (1)DB発⾏ (2)イベント申込フォーム発⾏ (3)決済後リダイレクトページ発⾏ (4)決済結果処理⽤ページ発⾏ 3.ZEUSの設定 (5)システム利⽤内容申込 (6)IPコード取得 4.連携設定 (7)APIトークン発⾏ (8)決済ページ呼び出し (9)決済結果受け取り処理 5.動作確認ZEUS
4
1
.
必要な契約の準備
ZEUS
1.契約の流れ [1.お申込] ①仮申込のご⼊⼒ ※参照URL:https://secure.cardservice.co.jp/cgi-bin/account/index.cgi ②申込書類送付 ※仮申込から1〜2営業⽇でメールにてご案内 ③必要書類と併せてご返送 ※書類不備チェック [2.カード会社審査 /3.審査結果報告] ④審査 ※審査提出前、審査中に追加で資料をいただくケース有 ※VISA,MASTER:約1〜3営業⽇(審査資料によっては5〜7営業⽇) JCB,AMEX:約3〜6営業⽇(審査資料によっては5〜10営業⽇) Diners:約10営業⽇ ※審査落ちの場合はお断りのご連絡 [4.システム設定] ⑤IP発⾏ ※システム設定に関する質問事項に回答をいただいた後1〜2営業⽇で設定完了 ⑥納品 [5.テスト・サービス開始]1
.
必要な契約の準備
ZEUS
2.お申込み時に必要なもの • 商業登記簿謄本 • 印鑑証明書(コピー可) • 振込先⼝座の通帳コピー 詳細は以下を参照ください。 http://www.cardservice.co.jp/support/flow.html6
⼿順
1.必要な契約の準備 2.SPIRALの設定 (1)DB発⾏ (2)イベント申込フォーム発⾏ (3)決済後リダイレクトページ発⾏ (4)決済結果処理⽤ページ発⾏ 3.ZEUSの設定 (5)システム利⽤内容申込 (6)IPコード取得 4.連携設定 (7)APIトークン発⾏ (8)決済ページ呼び出し (9)決済結果受け取り処理 5.動作確認SPIRAL
2
.SPIRAL
の設定
当⼿順書では以下フローを作成します。SPIRAL
イベント申込 画⾯ (SPIRAL) 申込完了画⾯(SPIRAL) 決済画⾯(ZEUS) 決済完了画⾯(SPIRAL)
決済結果受取 (SPIRAL) イベント 申込DB 登録 更新 決済結果を更新 申込情報を登録 以下をPOST送信 ・決済情報 ・申込No(⾃動発番) 以下をGET送信 ・決済結果 ・申込No
8
⼿順
1.必要な契約の準備 2.SPIRALの設定 (1)DB発⾏ (2)イベント申込フォーム発⾏ (3)決済後リダイレクトページ発⾏ (4)決済結果処理⽤ページ発⾏ 3.ZEUSの設定 (5)システム利⽤内容申込 (6)IPコード取得 4.連携設定 (7)APIトークン発⾏ (8)決済ページ呼び出し (9)決済結果受け取り処理 5.動作確認SPIRAL
(1)
DB
発⾏
当⼿順書では以下のDBを使⽤します。SPIRAL
※⾚枠部分の差替えキーワードは当⼿順書でご紹介するソースコード内で利⽤します。 [SPIRAL マニュアル] 通常DB http://support.smp.ne.jp/function/3510
⼿順
1.必要な契約の準備 2.SPIRALの設定 (1)DB発⾏ (2)イベント申込フォーム発⾏ (3)決済後リダイレクトページ発⾏ (4)決済結果処理⽤ページ発⾏ 3.ZEUSの設定 (5)システム利⽤内容申込 (6)IPコード取得 4.連携設定 (7)APIトークン発⾏ (8)決済ページ呼び出し (9)決済結果受け取り処理 5.動作確認SPIRAL
イベント申込フォーム発⾏します。 [SPIRAL マニュアル] フォーム http://support.smp.ne.jp/function/58
(2)イベント申込フォーム発⾏
SPIRAL
イベント申込 画⾯ (SPIRAL) 申込完了画⾯(SPIRAL) 決済画⾯(ZEUS) 決済完了画⾯(SPIRAL)
決済結果受取 (SPIRAL) イベント 申込DB 登録 更新 決済結果を更新 申込情報を登録
12
⼿順
1.必要な契約の準備 2.SPIRALの設定 (1)DB発⾏ (2)イベント申込フォーム発⾏ (3)決済後リダイレクトページ発⾏ (4)決済結果処理⽤ページ発⾏ 3.ZEUSの設定 (5)システム利⽤内容申込 (6)IPコード取得 4.連携設定 (7)APIトークン発⾏ (8)決済ページ呼び出し (9)決済結果受け取り処理 5.動作確認SPIRAL
決済後リダイレクトページを発⾏します。 [SPIRAL マニュアル] フォーム http://support.smp.ne.jp/function/58
(3)決済後リダイレクトページ発⾏
SPIRAL
※当⼿順書ではリダイレクトページの設置場所としてフォームを利⽤しますが、 外部からアクセスできるページであれば、設置場所は問いません。 イベント申込 画⾯ (SPIRAL) 申込完了画⾯(SPIRAL) 決済画⾯(ZEUS) 決済完了画⾯(SPIRAL)
決済結果受取 (SPIRAL) イベント 申込DB 登録 更新 決済結果を更新 申込情報を登録 P.16「3.ZEUSの設定>(5)利⽤内 容申込」で利⽤しますので メモ帳等にお控えください。
14
⼿順
1.必要な契約の準備 2.SPIRALの設定 (1)DB発⾏ (2)イベント申込フォーム発⾏ (3)決済後リダイレクトページ発⾏ (4)決済結果処理⽤ページ発⾏ 3.ZEUSの設定 (5)システム利⽤内容申込 (6)IPコード取得 4.連携設定 (7)APIトークン発⾏ (8)決済ページ呼び出し (9)決済結果受け取り処理 5.動作確認SPIRAL
決済結果処理⽤リダイレクトページを発⾏します。 ※当⼿順書では、決済結果の受取先にフォームを指定します。 [SPIRAL マニュアル] フォーム http://support.smp.ne.jp/function/58
(4)決済結果処理⽤ページ発⾏
SPIRAL
イベント申込 画⾯ (SPIRAL) 申込完了画⾯(SPIRAL) 決済画⾯(ZEUS) 決済完了画⾯(SPIRAL)
決済結果受取 (SPIRAL) イベント 申込DB 登録 更新 決済結果を更新 申込情報を登録 P.16「3.ZEUSの設定>(5)利⽤内 容申込」で利⽤しますので メモ帳等にお控えください。
16
⼿順
1.必要な契約の準備 2.SPIRALの設定 (1)DB発⾏ (2)イベント申込フォーム発⾏ (3)決済後リダイレクトページ発⾏ (4)決済結果処理⽤ページ発⾏ 3.ZEUSの設定 (5)システム利⽤内容申込 (6)IPコード取得 4.連携設定 (7)APIトークン発⾏ (8)決済ページ呼び出し (9)決済結果受け取り処理 5.動作確認ZEUS
(5)システム設定内容を申込
ZEUSで利⽤したい機能・設定内容を申込みます。 システム環境の準備が整うと、ZEUSより通知がきます。 当⼿順書で申込内容(⼀部)は以下となります。 ■システム構成 リンク型(Link Point) ■CGI利⽤ 利⽤する CGIコール先URL:(P.13で発⾏したフォームURL) ■CGI利⽤パラメータ ・result(結果) ・ordd(ゼウス発⾏のオーダNo) ・sendid(フリーパラメータ) ■決済完了後ページ(リンク型PCのみ) 2.リダイレクト設定を⾏う リダイレクト先URL⇒(P.12で発⾏したフォームURL) リダイレクト秒数⇒0秒ZEUS
18
⼿順
1.必要な契約の準備 2.SPIRALの設定 (1)DB発⾏ (2)イベント申込フォーム発⾏ (3)決済後リダイレクトページ発⾏ (4)決済結果処理⽤ページ発⾏ 3.ZEUSの設定 (5)システム利⽤内容申込 (6)IPコード取得 4.連携設定 (7)APIトークン発⾏ (8)決済ページ呼び出し (9)決済結果受け取り処理 5.動作確認ZEUS
(6)
IP
コード取得
ZEUSで利⽤したい機能の申込後、連携に必要な「IPコード」が通知されます。 P.22「4.連携設定>(8)決済ページ呼び出し」で利⽤します。
20
⼿順
1.必要な契約の準備 2.SPIRALの設定 (1)DB発⾏ (2)イベント申込フォーム発⾏ (3)決済後リダイレクトページ発⾏ (4)決済結果処理⽤ページ発⾏ 3.ZEUSの設定 (5)システム利⽤内容申込 (6)IPコード取得 4.連携設定 (7)APIトークン発⾏ (8)決済ページ呼び出し (9)決済結果受け取り処理 5.動作確認SPIRAL
(7)
API
トークン発⾏
SPIRAL
スパイラルAPIを利⽤して、決済結果を該当ユーザーのDB情報を更新します。 以下のマニュアルに沿ってスパイラルAPIを発⾏してください。 http://support.smp.ne.jp/function/161 ※「トークン発⾏」から参照ください。22
⼿順
1.必要な契約の準備 2.SPIRALの設定 (1)DB発⾏ (2)イベント申込フォーム発⾏ (3)決済後リダイレクトページ発⾏ (4)決済結果処理⽤ページ発⾏ 3.ZEUSの設定 (5)システム利⽤内容申込 (6)IPコード取得 4.連携設定 (7)APIトークン発⾏ (8)決済ページ呼び出し (9)決済結果受け取り処理 5.動作確認SPIRAL
(8)決済ページ呼び出し
SPIRAL
<form action="https://linkpt.cardservice.co.jp/cgi-bin/credit/order.cgi">
<!-- 【変更箇所】IPコード -->
<input type="hidden" name="clientip" value=”1234567890" />
<!–決済⾦額 -->
<input type="hidden" name="money" value="%val:usr:money%" />
<!–電話番号 -->
<input type="hidden" name="telno" value="%val:usr:phoneNumber%" />
<!–メールアドレス -->
<input type="hidden" name="email" value="%val:usr:email%" />
<!–フリーパラメータ(申込No、SPIRAL⾃動発番) -->
<input type="hidden" name="sendid" value="%val:usr:entryNo%" /> <input class="submit" type="submit" name="submit" value="参加費⽀払"> </form> ①【変更箇所】を変更し、イベント申込フォーム>サンキューページに設置。 ・IPコード…P.18で取得したIPコード P.10 で作成した「イベント申込フォーム」のサンキュページに 決済画⾯へ進むボタンを設置します。 ※決済画⾯の呼び出しの詳細は、ZEUSから提供されるマニュアルを参照ください。 イベント申込 画⾯ (SPIRAL) 申込完了画⾯
(SPIRAL) 決済画⾯(ZEUS) 決済完了画⾯(SPIRAL)
決済結果受取 (SPIRAL) イベント 申込DB 登録 更新 決済結果を更新 申込情報を登録 以下をPOST送信 ・決済情報 ・申込No(⾃動発番) 以下をGET送信 ・決済結果 ・申込No 進む
24
⼿順
1.必要な契約の準備 2.SPIRALの設定 (1)DB発⾏ (2)イベント申込フォーム発⾏ (3)決済後リダイレクトページ発⾏ (4)決済結果処理⽤ページ発⾏ 3.ZEUSの設定 (5)システム利⽤内容申込 (6)IPコード取得 4.連携設定 (7)APIトークン発⾏ (8)決済ページ呼び出し (9)決済結果受け取り処理 5.動作確認SPIRAL
(9)決済結果受け取り処理
SPIRAL
イベント申込 画⾯ (SPIRAL) 申込完了画⾯(SPIRAL) 決済画⾯(ZEUS) 決済完了画⾯(SPIRAL)
決済結果受取 (SPIRAL) イベント 申込DB 登録 更新 決済結果を更新 申込情報を登録 以下をPOST送信 ・決済情報 ・申込No(⾃動発番) 以下をGET送信 ・決済結果 ・申込No ※決済結果(CGIコール)の詳細は、ZEUSから提供されるマニュアルを参照ください。 決済後、ZEUSより指定したURL(CGIコール先URL)へ決済結果がGET送信されます。 イベント申込DBの該当レコードへ受け取った決済結果を更新する処理を作成します。
<!-- SMP_DYNAMIC_PAGE DISPLAY_ERRORS=ON NAME=ZEUS_RESULT --> <?php // 【変更箇所】SPIRAL APIトークンタイトル $SPIRAL->setApiTokenTitle("default"); // 申込No $entryNo = $_GET["sendid"]; // ゼウス発⾏のオーダーNo $z_ordd = $_GET["ordd"]; // 結果 $resultString = $_GET["result"]; if($resultString == "OK"){ $result = "1"; }else{ $result = "2"; } $db = $SPIRAL->getDataBase("zeusEntryDB"); $db->addEqualCondition("entryNo", $entryNo); $db->doUpdate(array( "lastUpdate" => "now", // 更新⽇時
"z_ordd" => $z_ordd, // [ZEUS] オーダNo
"z_result" => $result // [ZEUS] 結果
)); ?> 26 4.連携設定
(9)決済結果受け取り処理
SPIRAL
①【変更箇所】を変更し、決済結果処理⽤ページ>⼊⼒ページに設置。 ・SPIRAL API トークンタイトル … P.20で発⾏したAPIトークンタイトル⼿順
1.必要な契約の準備 2.SPIRALの設定 (1)DB発⾏ (2)イベント申込フォーム発⾏ (3)決済後リダイレクトページ発⾏ (4)決済結果処理⽤ページ発⾏ 3.ZEUSの設定 (5)システム利⽤内容申込 (6)IPコード取得 4.連携設定 (7)APIトークン発⾏ (8)決済ページ呼び出し (9)決済結果受け取り処理 5.動作確認ZEUS
SPIRAL
28
5
.
動作確認
①イベント申込 (P.10 「2.SPIRALの設定>(2)イベント申込フォーム発⾏」 で発⾏したフォームへアクセス) ②イベント申込後、決済ページへ遷移するボタンをクリックSPIRAL
5
.
動作確認
③決済実⾏
※ZEUS 売上管理画⾯に「テスト⽤カード番号」「テスト決済時の注意点」が掲載されております。 動作確認時にご確認ください。(参照P.31〜)
30
5
.
動作確認
④イベント申込DBに「申込情報」「決済結果」が登録されていることを確認。 <データ操作(DBオペレーション)> [SPIRAL マニュアル] データ操作(DBオペレーション) http://support.smp.ne.jp/function/46SPIRAL
5
.
動作確認
【テスト決済時の注意点を確認(ZEUS売上管理画⾯内に記載)】
(1)ZEUS 売上管理画⾯にログイン
(2)ログイン後、左メニューより「テストカード番号管理」をクリック
32