オートデスク デベロッパーネットワーク(ADN)

Autodesk App ストア: IPN 通知フォーマット

Instant Payment Notification(IPN)– 即時支払い通知 – は、アプリに関連する購入処理について自動的に通知するメッセージ サービスです。アプリ公開元の開発者は、自動的に注文を完了させたり、注文状況の通知やアクティベーション用のシリアル番号の送信をおこなったりする、バックオフィス系の処理を自動化するために、この通知を利用することが出来ます。


どのように動作するか?

IPN リスナー Web サービスを作成して、Autodesk App ストアのプロファイル内のリスナーの URL を指定する必要があります。これにより、ストアはすべての処理イベントの通知を、その URL に送信するようになります。


有償アプリ用のサンプル IPN(Instant Payment Notification)フォーマット

transaction_subject=200703030249937
&txn_type=web_accept
&payment_date=23%3A36%3A36+Jan+11%2C+2014+PST
&last_name=Userlastname
&residence_country=AU
&item_name=MyAppNameInStore
&payment_gross=5.50
&mc_currency=USD
&business=Mypaypalid@company.com
&payment_type=instant
&protection_eligibility=Ineligible
&payer_status=verified
&verify_sign=AFcWxV21C7fd0v3bYYYRCpSSRl31AsmAEVMn38537K1tk5tZMnvtnW6
&tax=0.50
&payer_email=name@company.com
&txn_id=0AG18756HD086633A
&quantity=1
&receiver_email=publihserPaypal@company.com
&first_name=UserFirstName
&payer_id=NEH6BJPL9LBYG
&receiver_id=GDGRD3PAZBMD8
&item_number= appstore.exchange.autodesk.com%3ascreenshot%3aen
&handling_amount=0.00
&payment_status=Completed
&payment_fee=0.43
&mc_fee=0.43
&shipping=0.00
&mc_gross=5.50
&custom=200703030249937
&charset=windows-1252
&notify_version=3.7
&auth=A6P4OiUSwAL6901WUc3VK.fiUaYTR5AND5h.XpBaMqrI8gSmid.n0tFsfAMP6u3unDXUuiABwGtZWQlN
RFtDcA
&form_charset=UTF-8
&buyer_adsk_account=useremail@company.com


重要なトークン

txn_type:IPN メッセージが送られた処理の種類を表現
txn_type:次の値のいずれかを示す
subscr_signup:購入者が Subscription にサインアップした場合
subscr_cancel:購入者が Subscription をキャンセルした場合
subscr_payment:購入者が Subscription の支払いをおこなった場合(新規、または、継続)
web_accept:購入者が有償アプリの支払いをおこなった場合(永久ライセンス、Subscription ではない)
item_name:アプリ名
item_number:Autodesk App ストア内でのアプリの一意な ID(App Id)
mc_gross:購入者によって完了した支払い額
buyer_adsk_account:オートデスクに登録された購入者の Email アドレス


無償アプリ/試用版アプリ用の IPN(Instant Payment Notification)フォーマット

txn_id=Q6VJNCYFP5HYautodesk.appstore.exchange.autodesk.com:ADNPlugins_ClipboardManager:en
&custom=Q6VJNCYFP5HY
&payment_status=Completed
&item_number=autodesk.appstore.exchange.autodesk.com:ADNPlugins_ClipboardManager:en
&buyer_adsk_account=user.email@company.com
&mc_gross=0.00

無償アプリの場合には、アプリの一意な ID と、だれがアプリをダウンロードしたかのみを取得することが出来ます。

item_number:Autodesk App ストア内でのアプリの一意な ID(App Id)
buyer_adsk_account:オートデスクに登録された購入者の Email アドレス


その他の情報

ADN チームは、成功裏に Autodesk App ストアへの公開元/パブリッシャーになるお手伝いをします。もし、ご質問等があれば、appsinfo@autodesk.com まで電子メールをお送りください