Confidential

システム設定マニュアル
楽天Edy決済サービス（Link Point, Link Point Mobile）

2020/6/30 更新

株式会社ゼウス 営業部

Copyright (C) ZEUS CO.,LTD.All Rights Reserved.

楽天Edy決済サービスについて
楽天Edy決済サービスは、電子マネー「楽天Edy」のネット決済ソリューション2つ（Cyber Edy・Mobile Edy）をまとめてご導入いただけるサービスです。
年齢制限のない支払方法で、チャージ・お支払いも24時間いつでもでき、加盟店様も支払結果をリアルタイムに確認いただけるため、より早い商品・サービスの提供が可能です。
Mobile Edyは、非接触ICチップ（FeliCa）を搭載したAndroidスマートフォン、Androidフィーチャーフォン（ガラホ）の「おサイフケータイ」をご利用いただきます。フィーチャーフォン（ガラケー）は対応しておりません。

ご利用可能サービス一覧
初回決済

Confidential

継続決済

接続方法

L ink
Point

Secure
L ink

L ink Point
MobileL ink Point
MobileInter Cat

QuickChargeSecure
LinkBatch

管理画面楽天Edy決済
対応

●××●

××××

Copyright (C) ZEUS CO.,LTD.All Rights Reserved.

システム設定マニュアル 楽天Edy決済サービ ス

2

楽天Edy決済サービス 申込フロー （Link Point）
ユ ー ザー

加盟店_WEB

加盟店_DB

加盟店_人

ZEUS_WEBZEUS_DB

楽天Edy_WEB

楽天Edy_DB

パラメータ送信閲覧

楽天Edy決済選択

データ格納

支払受付内容入力

支払受付内容確認

データ格納
楽天Edyカードもしくはおサイフケータイをタッチして支払支払い手続き

支払完了

メ ー ル送信楽天Edyアプリ起動

ご利用明細画面メ ー ル送信

支払結果通知（ メール ・ＣＧＩ）

データ格納

データ格納

支払完了
共通ﾌﾛｰ

「Cyber Edy」選択ﾌﾛｰ
データ格納

Confidential

状況確認

売上管理画面

Copyright (C) ZEUS CO.,LTD.All Rights Reserved.

「Mobile Edy」選択ﾌﾛｰ

システム設定マニュアル 楽天Edy決済サービ ス

3

楽天Edy決済サービス 申込フロー （Link Point Mobile）
ユーザー

加盟店_WEB

加盟店_DB

加盟店_人

Z E US_WEBZ E US_DB

楽天Edy_WEB

楽天Edy_DB

パラメータ送信閲覧

楽天Edy決済選択

支払受付内容入力

データ格納

支払受内容確認

ﾒｰﾙｱﾄﾞﾚｽ認証

メ ー ル送信
決済開始メール

データ格納

メー ル送信

楽天Edyアプリ起動

ご利用明細画面メー ル送信支払結果通知（ メール ・ＣＧＩ）

支払完了

Confidential

データ格納

状況確認

Copyright (C) ZEUS CO.,LTD.All Rights Reserved.

データ格納

データ格納

売上管理画面システム設定マニュアル 楽天Edy決済サービ ス

4

送信パラメータ一覧（1）・当社決済ページへの遷移時、加盟店様より当社へ送信していただく情報送信パラメータは以下になります。
■接続先ＵＲＬ（POST） https://linkpt.cardservice.co.jp/cgi-bin/edy.cgi※ ● → 必須、 － → 任意

Confidential

意味条件

最大サイズ( byte)№

パラ メータ名

1clientip

IPコード

●

10半角数字

当社発行のIPコード （10桁固定）

2act

決済形態

●

12[order] or [mobile_order]

PCの場合は “order”、ｽﾏｰﾄﾌｫﾝの場合は “mobile_order” （固定）

3money

決済金額

●

5

半角数字

ユーザーの申込金額 ※100円未満、50,001円以上不可

4username

名前

－

40

全角カナ

ユーザーの氏名

5

telno

電話番号

－

11

半角数字

ユーザーの電話番号

6

email

メールアドレス－

50

半角英数字、記号

ユーザーのメールアドレス

7

sendidフリーパラメータ

－

25

半角英数字
一部記号

自由にご利用頂けます8

sendpoint

フリーパラメータ

－

50

半角英数字
一部記号

自由にご利用頂けます

(※)

値の条件

Copyright (C) ZEUS CO.,LTD.All Rights Reserved.

備考※記号は「 - 」、 「 _ 」 、「 . 」 のみ使用可※記号は「 - 」、 「 _ 」 、「 . 」 のみ使用可

システム設定マニュアル 楽天Edy決済サービ ス

5送信パラメータ一覧（2）※ ● → 必須、 － → 任意
条件

最大サイズ
( byte)№パラ メータ名意味

9success_url

リンク先URL

－

256

半角英数字
記号

「支払完了ページ」「楽天Edｙ決済完了メール」に表示する戻りリンクのURL
必ず success_str と同時に使用

10

success_str

表示するテキスト－

256

全角英数、漢字、かな、カナ
半角英数字、スペース

上記 success_url をリンクさせるテキスト内容
必ず success_url と同時に使用

11

failure_url

リンク先URL

－

256

半角英数字
記号

「受付失敗ページ」「支払失敗ページ」に表示する戻りリンクのURL
必ず failure_str と同時に使用

12

failure_str

表示するテキスト－

256

全角英数、漢字、かな、カナ半角英数字、スペース

上記 failure_url をリンクさせるテキスト内容
必ず failure_url と同時に使用

(※)

値の条件

備考

【 データ送信例 】<FORM METHOD="POST" ACTION="https://linkpt.cardservice.co.jp/cgi-bin/edy.cgi" TARGET="_top"><INPUT TYPE="hidden" NAME="clientip" VALUE="**********"><INPUT TYPE="hidden" NAME="act" VALUE="order"><INPUT TYPE="hidden" NAME="money" VALUE="10000"><INPUT TYPE=“submit” VALUE=“楽天Edy決済へ”></FORM>

Confidential

Copyright (C) ZEUS CO.,LTD.All Rights Reserved.

システム設定マニュアル 楽天Edy決済サービ ス6

CGI送信パラメータ一覧
・決済後、当社より加盟店様指定CGIへデータ送信可能な情報は以下になります。

Confidential

最大サイズ( byte)

値の条件

IPコード

10

半角数字

当社発行のIPコード （10桁固定）

money

決済金額

5

半角数字

ユーザーの支払金額

3username

名前

40

全角カナ

ユーザーの氏名4telno

電話番号

11

半角数字

ユーザーの電話番号

5

email

メールアドレス

50

半角英数字
一部記号

ユーザーのメールアドレス

6

sendidフリーパラメータ

25

半角英数字
一部記号

自由にご利用頂けます7

sendpoint

フリーパラメータ

50

半角英数字
一部記号

自由にご利用頂けます

8order_no

オーダー番号

50

半角英数字
一部記号

当社発行のシリアルナンバー(決済時に当社で発行いたします)9

tracking_no

注文番号

16

半角数字

当社発行の注文番号（加盟店様、楽天Edｙ株式会社、当社の3社保持情報）

10status

ステータス

2

半角数字

決済状況
（04=支払済、05=支払失敗）

N o.

パラメータ名1clientip

2意味備考

Copyright (C) ZEUS CO.,LTD.All Rights Reserved.

システム設定マニュアル 楽天Edy決済サービ ス

7

CGIコールの際の注意事項

・加盟店様側サーバからのレスポンスについて
ゼウスからCGIコールを行い、加盟店様側サーバより 200OK の応答が得られない場合(404 NotFound、500 Internal Server Error等)には「CGI送信エラー通知」 メールが送信されま すのでご 確認ください。
また、CGIの受け取りが失敗した場合は、都度売上管理画面より再送信を行うことができま す。
・タイムアウトについて
ゼウスからCGIコールを行い、40秒間加盟店様側サーバより応答がない場合には タイムアウト として処理いたします。
この場合も、上記同様に「CGI送信エ ラー通知」 メールが送信されま すのでご 確認ください。
・CGIの送信方式
GETで行います。POSTで行う場合は、 営業担当までご連絡ください。
・CGIコールのリ トライについて
CGIコールのリトライ設定が可能ですので、ご希望の際には営業担当までご 相談ください。
(注1）サーバより404 NotFound、500 Internal Server Error等のエラー応答があった場合には、 CGIコールのリトライは実施されません。
(注2）タイムアウト等の場合、実際には正常処理されている可能性もありま すので、 CGIコールのリトライによって重複処理等が発生しないようにご注意ください。
・送信元情報について
ゼウスからは下記のIPアドレス、エ ージ ェント名で送信されま す。
■IPアドレス：210.164.6.67 または 202.221.139.50■エージェント名：Zero CGI-Kikker（ポート80使用時のみ、ポート443などの場合はエ ージ ェント名なし）
加盟店様側のセキュリティ強化を図るため、上記の送信元を見てチェックを行ってく ださい。
なお、このアドレス及びCGI名は、非公開として取り 扱って下さい。

Confidential

Copyright (C) ZEUS CO.,LTD.All Rights Reserved.

システム設定マニュアル 楽天Edy決済サービ ス

8決済状況ステータス一覧
・当社とのシステム接続後、加盟店様へ提供する売上管理画面にて決済状況をリアルタイムでご確認いただけます。
ユーザーが受付を行ってから、支払が完了するまでのステータスと処理内容は以下のとおりです。
ゼ ウス⇒加盟店様

ステ ータス

支払方法

メ ー ル送信

CGI送信

支払対象

メ ー ル送信Cy berEdy

MobileEdy

受付失敗 ユーザーの受付手続きが失敗した

×

×

×

○

○

○

未入金

ユーザーの受付手続きが完了した

×

×

×

○
（Mobile Edyのみ）○○「楽天Edy決済開始メール」を送信したが、ユーザー側で何らかの理由により受信できなかった

×

×

×

×

×

○

ユーザーは支払期限内に支払いを行い、完了した

○

○

○

○

○

○

支払失敗 ユーザーが支払期限内に支払いをしたが、失敗した

○

○

×

×

○

×

期日切×

×

×

×

○

○

×

×

×

×

○

○

メール不達

支払済

ユーザーは受付をしたが、支払期限までに支払わなかった

番組停止 ユーザーがサービス停止処理後に、楽天Edy支払いを行った

Confidential

ゼ ウス ⇒ユーザー

内容

Copyright (C) ZEUS CO.,LTD.All Rights Reserved.

システム設定マニュアル 楽天Edy決済サービ ス

9

支払期日と戻りURLについて
支払期日について
楽天Edy決済開始メールに記載されている支払先URLへアクセス可能な有効期限は発行日から1日（24時間）です。（Mobile Edyのみ）

戻り URLについて
表示・送信先

ゼウス

ゼウス

楽天Edy

ゼウス

楽天Edy

支払
完了
メール

楽天
Ｅｄｙ
決済
完了
メー
ル

メール

決済
形
態

PC版
携帯版

お支払
い
受付完了

お支払
い
受付失敗

お支払
い完了

お支払
い失敗

○

●

支払方法テスト

Cyber Edy－－●

Mobile Edy－－●

Mobile Edy－－

受付
完了
メー
ル

受付
失敗
メール

楽天
Ｅｄｙ決済開始
メール－－－－○－－－－○－○ → success_url（とsuccess_str）を使用した場合● → failure_url（とfailure_str）を使用した場合－ → パラメータを送信されても表示されません※Mobile Edyの場合のみ楽天Edy側(楽天Edy株式会社)よりメールが送信されます。
テストの場合は、楽天Edyから送信されるメール「楽天Edy決済開始メール」「楽天Edy決済完了メール」は送信されませんので、「楽天Edy決済完了メール」に記載される「success_url」の確認は行えません。

Confidential

Copyright (C) ZEUS CO.,LTD.All Rights Reserved.

システム設定マニュアル 楽天Edy決済サービ ス10

運用テスト 実施手順
◆運用テスト・システム設定完了後、システム接続の完了を確認するため、運用テストを実施してください。
・運用テストは土・日・祝祭日を除く9:00～17:30の間に実施してください。
上記の時間外にテストを実施した場合、当社側のシステム設定が完了していないことがあったり、予期しないトラブルが発生した場合に対応ができませんので、必ず時間内の実施をお願いいたします。

・各処理が正常に行われない場合は、加盟店様側でのご確認と対応をお願いいたします。
また、ご依頼いただきました設定に不備が見受けられる場合は、お手数でございますが当社までご連絡ください。
◆「売上管理画面」について
・売上管理画面では、決済状況をご確認いただいたり、各種設定の登録・変更をしていただくことが可能です。
売上管理画面をご利用いただくための、IDとパスワードは営業担当者よりご案内させていただきます。

運用テ スト手順
１） 加盟店様のページから「楽天Edy決済」を選択、当社ご利用楽天Edyの選択ページから、お支払いページへ移動できるかを確認し、当社から発行されたテストIDを用いて決済をします。
◆確認項目１

あらかじめ設定しているパラメータの内容が楽天Edy決済お支払いページに正しく引き継がれているか【ご 注意ください】
テストを行う場合は、 名前（お客様名）欄に、「お客様名」＋「_（アンダーバー）」＋「テストID」を入力
例） ゼウステスト_12345678 （※テストIDが正しく入力されていない場合、テスト決済と認識されません。正確な入力をお願いいたします。）※テストＩＤは当社売上管理画面「テストカ ード番号管 理」よりご確認い ただけま す。

２） 楽天Edy決済お支払いページに移動しましたら、必要な情報を入力します。
３） 「お支払い内容確認」ボタンを押すと確認画面が表示されますので、内容をご確認の上「次へ」ボタンを押してください。
４） お支払い受付完了ページが表示されますので、「成功テスト」ボタンまたは「失敗テスト」を押しテストを実行してください。
テ スト完了画面が表示されれば完了です。
◆確認項目２「楽天Edy決済テスト」というページが表示されているか◆確認項目３

CGIやテスト用支払結果通知メールを送信する仕様の場合、CGIの処理やメール受信が正常に行われているか※CGIやテスト用支払結果通知メールを“送信しない” 設定にしている場合、CGI・メールの送信はありません。

◆確認項目４

売上管理画面上で上記TESTデータが正常に確認できるか【ご 注意ください】
テストページに切り替わらない場合、テストIDの入力が間違っている可能性があります。入力内容をご確認ください。

Confidential

Copyright (C) ZEUS CO.,LTD.All Rights Reserved.

システム設定マニュアル 楽天Edy決済サービ ス11