注文状況を追跡する
注意
SDKはアプリケーションのクライアント側で注文のステータスを追跡することを可能にします。ただし、完了した購入の追加の検証を実装するために、アプリケーションのバックエンドで支払いウェブフックハンドラを設定することをお勧めします。これにより、注文情報を受け取ることができます。
- アプリケーションUIに注文状態を表示する
- 支払い完了後、ユーザーの残高を計上する
- 支払い完了後、購入したアイテムを付与する
注文追跡ロジックは、次のSDKメソッドに含まれています:
Cart.Purchase
— カートを購入するのに使用されますCart.PurchaseFreeCart
— カート経由で無料アイテムを購入するために使用されますCatalog.Purchase
— ワンクリックでアイテムを購入するために使用されますCatalog.PurchaseForVirtualCurrency
— 仮想通貨のアイテムの購入に使用されますCatalog.PurchaseFreeItem
— ワンクリックで無料アイテムを購入するために使用されます
SDK参照ドキュメンテーション
SDKメソッドとそのパラメータの詳細については、こちらをご覧ください。
購入が成功した場合の処理としては、注文がdone
ステータスに遷移したときに呼び出される関数をonSuccess
パラメータに渡すだけです。
購入メソッドには、注文ステータスを追跡するためのいくつかのメソッドがカプセル化されています。メカニズムは、アプリケーションが構築されているプラットフォームによって異なります:
- WebGLビルドの場合、追跡は決済インターフェイスウィジェットの
postMessage
イベントに基づいています。「ペイステーション」ウィジェットが注文状態が「done
」または「cancel
」に変更されたというメッセージを送信すると、追跡は停止します。
- 他のプラットフォーム向けのビルドの場合、追跡には単純なHTTPリクエスト(ショートポーリング)とウェブソケットリクエストが使用されます。追跡は、次のアルゴリズムに従って実行されます:
- ウェブソケット接続が確立されます。
- 5分以内に注文状態が「
done
」または「cancel
」に変更されなかった場合、ウェブソケット接続閉じられています。注文状態が「done
」または「cancel
」に変更された場合、追跡は停止します。 - 注文状態の追跡は、ショートポーリングで続行されます。シンプルなHTTP注文状態リクエストが3秒ごとに送信されます。追跡は以下の場合に停止します:
- 注文状態が「
done
」または「cancel
」に変更されます - 注文状態が10分以内に「
done
」または「cancel
」に変更されます
- 注文状態が「
お知らせ
ウェブソケット接続に失敗した場合、ショートポーリングを利用して注文状態を追跡します。
onSuccess
コールバック関数の中で渡される注文コンテンツデータの処理を実装することもできます。この記事は役に立ちましたか?
ご意見ありがとうございました!
あなたのメッセージを確認し、体験を向上させるために利用させていただきます。お役立ちリンク
最終更新日: 2024年1月22日誤字脱字などのテキストエラーを見つけましたか? テキストを選択し、Ctrl+Enterを押します。