モリタポ決済簡単キット
◆概要
モリタポ決済簡単キットは、あなたが作るウェブ上のサービスに、
ユーザからモリタポを貰ったり、ユーザにモリタポを払ったりする機能を
簡単に付け加えるためのキットです。
◆用語集
・サービサー これからモリタポを使ったサービスをするあなた。わりとがんばる。
・ユーザー サービサーのサービスにモリタポを払う人。わりとありがたい。
・ブラジル社 モリタポサービスの決済をする会社。わりと真面目。
・モリタポ ブラジル社が提供する電子通貨。わりと便利。
自作の曲をモリタポで決済してダウンロードするサービスを提供しようとしているサービサーを例にして、決済システムの作り方を順を追って説明します。
◆モリタポを集めよう◆
１、モリタポ決済簡単キットダウンロード
サービサーは、モリタポ決済簡単キットをダウンロードします
http://api.razil.jp/easytools.zip
http://api.razil.jp/easytools.tar.gz
適当なところに解凍して中身を確かめてください。
下記のものが入っているはずです。
・復号用サンプルphpスクリプト moritapi.php moritapi.inc.php
・モリタポ決済簡単キット説明書（今読んでるものです）
２、MD5用認証キー登録
サービサーMD5用認証キーを、モリタポ決済の確認に使うので、
誰にもわからない暗号を決めます。
メモした後に、ユーザー情報変更ページで、MD5用認証キーを登録します。
http://find.2ch.net/regist.php
例） 「Nghvp7iqweHnoviWe1qew」
３、自作の曲アップロード
自作の曲をアップロードしてBASIC認証をかけます。
例）
ユーザー名 funfan
パスワード miracle
http://example.com/music/origin.mp3
BASIC認証のかけかたは下記のページ等を参照してください。
http://tohoho.wakusei.ne.jp/wwwxx007.htm
http://www.shtml.jp/htaccess/basic.html
４、フォーム設置
モリタポ決済簡単キットのform.htmlを参考にして、
ブラジルに登録してあるメールアカウントをname="SERVICER"に埋め込みます。
例）example@example.com ＞example%example.com
SPAM防止のために、@を%に置換してください。
決済するモリタポ額をname="AMOUNT"に埋め込みます。
例）2000モリタポのサービスだったらAMOUNTは2000です
ユーザーがモリタポ決済後に戻ってくるURLを埋め込みます。
例
５、ユーザーを集める
ユーザーが自作の曲をダウンロードしたくなったら、
さきほど作ったフォームにいきます。
ユーザーのメールアドレスなど、決済ごとのユニークな文字列を
入力してもらい、保存してください。
サービサーのシステムで自動生成してもOKです。
例）決済番号として0000043242を送るとします。
６、ユーザーが決済ページへ飛ぶ
フォームの内容を埋めたユーザーが送信ボタンを押すと、ブラジル社の決済ページに飛びます。
ユーザーは、ブラジル社でIDとパスワードを打ち込んで、サービサーにモリタポを支払います。
例）
７、ユーザーが決済後にサービサーのURLに戻る。
name="RET_URL"に埋め込んだURLにユーザーが戻ってきます。
引数として、決済番号とモリタポ額とサービサーMD5用認証キーでMD5化したものを決済完了キーとして付け加えています。
例）
http://example.com/thanks.php?md5key=fwenofwenfroipwetwpoietwet&UNIQUEKEY=0000043242&AMOUNT=2000
８、決済完了キーの確認をする
決済番号とMD5用認証キーをMD5して、ユーザー決済が完了したか確認します。
例）決済番号は0000043242で、モリタポ額が2000で、MD5用認証キーはNghvp7iqweHnoviWe1qewです。
if(md5("2000:Nghvp7iqweHnoviWe1qew:0000043242") == 'fwenofwenfroipwetwpoietwet')
９、ユーザーにパスワードを送る
サービサーはモリタポ決済が確認できたので、ユーザーに自作の曲をダウンロードするパスワードを表示します。
例）
「下記のURLから自作の曲をダウンロードしてください」
http://example.com/music/origin.mp3
ユーザー名 funfan
パスワード miracle
１０、そしてハッピーエンド
ユーザーがBASIC認証を終えて、自作の曲をダウンロード。
ユーザーは幸せ。
サービサーは、モリタポ通帳の残高が増えて満足。
http://find.2ch.net/amount.php
◆いろんな人にモリタポを配るよ◆
１、たっぷり溜まったモリタポを配ってみます。
サービサーのアドレスや送るモリタポの量などの設定は、
モリタポを受け取るときと一緒です。
サービサーのアドレスはexample@example.com
送るモリタポの量は200
適当に決めた決済番号は0000012345
例）
SERVICER=example@example.com
AMOUNT=200
UNIQUEKEY=0000012345
２、送る人のメールアドレスを設定します。
okuruhito@email.comのアドレスの持ち主に200モリタポを送ります。
例）
payto=okuruhito@email.com
３、MD5化します
サービサーアドレス:モリタポ量:MD5用認証キー:決済番号:受け取る人のアドレス
の順番でMD5化します。
例）
md5("example@example.com:200:Nghvp7iqweHnoviWe1qew:0000012345:okuruhito@email.com")
結果は「b4irnbuibe7hebnnuiear」だったとします。
４、モリタポ送付用データをブラジルに送ります。
GETでもPOSTでもかまいません。
例）
http://api.razil.jp/payto.php?SERVICER=example@example.com&AMOUNT=200&UNIQUEKEY=0000012345&PAYTO=okuruhito@email.com&MD5KEY=b4irnbuibe7hebnnuiear
５、結果が返ってきます。
OKだった場合は「OK」が帰ってきます。
モリタポが足りない、ユーザーがいないなどの理由のときは、「NG」が帰ってきます。
例）
「OK」
６、モリタポが相手に送られました。
ユーザーは幸せ。
サービサーはモリタポ残高が200減りました。
http://find.2ch.net/amount.php