アプリケーション上のアイテムを購入する、もしくはacebook Creditsを購入するようにユーザを促します。追加のパーミッションは必要ありません。JS SDKで、なおかつpageモード指定の場合のみサポートしています。iframeやpopupモード、携帯電話端末は対象外です。Pay Dialogを利用するには、Facebook Creditを利用するようにアプリケーションの設定をし、Credits API documentationに沿ってコールバックURLが機能するようにしなくてはいけません。
Properties
app_id | Your application's identifier. Required, but automatically specified by most SDKs. アプリケーションID。必須ですが、ほとんどのSDKでは自動的に指定されます。 |
redirect_uri | ユーザがDialogのボタンをクリックした後にリダイレクトするURLです。必須ですが、ほとんどのSDKでは自動的に指定されます。 |
credits_purchase | Facebook Creditsの購入か否かです。 |
order_info | 販売するアイテムの内部的なキーです。credits_purchaseが偽のときに必須で、あなたにとって意味のあるものでなくてはなりません。 |
dev_purchase_params | 開発者用のパラメータです。詳細についてはCredits API documentationをご覧ください。 |
Return Data
order_id | 成功したオーダーのIDです。 |
error_code | エラーだった場合のエラーコードです。 |
error_message | エラーだった場合のエラー文言です。 |
Example
アプリケーションの設定が済んでコールバックURLの用意ができたら、ユーザを下記URLにリダイレクトしてください。
http://www.facebook.com/dialog/pay?
app_id=APP_ID&
redirect_uri=http://example.com/response&
credits_purchase=false&
order_info=ORDERID
ユーザには下記のようなDialogが表示されます。
支払いが完了したら、ユーザは下記URLへとリダイレクトされます。
http://example.com/response?order_id=ORDERID
エラーがあった場合には、下記へのリダイレクトです。
http://example.com/response?error_code=ERROR_CODE&error_msg=ERROR_MSG