注文状況を追跡する
注意
SDKはアプリケーションのクライアント側で注文のステータスを追跡することを可能にします。ただし、完了した購入の追加の検証を実装するために、アプリケーションのバックエンドで支払いウェブフックハンドラを設定することをお勧めします。これにより、注文情報を受け取ることができます。
ユーザーが購入した後、アプリケーションは以下のアクションを実行することができます：
- アプリケーションUIに注文状態を表示する
- 支払い完了後、ユーザーの残高を計上する
- 支払い完了後、購入したアイテムを付与する
SDKを使用してこれらのアクションのロジックを実装する場合、次の方法で注文ステータスを追跡できます：
注文ステータスの変更をサブスクライブする
注文状況の変更をサブスクライブするには、ストアライブラリのgetOrderStatus SDKメソッドを使用し、以下のパラメータをメソッドに渡します：
listener—OrderStatusListenerタイプのリスナーオブジェクト。orderId— ショッピングカートでの購入、ワンクリック購入、または仮想通貨での購入で受け取った注文IDをパラメータとします。
XStore.getOrderStatusメソッドの呼び出し例：
Copy
- kotlin
XStore.getOrderStatus(object : OrderStatusListener() {
override fun onStatusUpdate(status: OrderResponse.Status) {
if(status == OrderResponse.Status.DONE) {
Log.d("MainActivity", "Success")
}
}
override fun onFailure() {
Log.d("MainActivity", "Failure")
}
}, orderId)
決済UIを開く際にXStore.getOrderStatusメソッドを呼び出すことをお勧めします。
購入メソッドは、注文ステータスを追跡するためのいくつかのメソッドをカプセル化します。追跡は、以下のアルゴリズムに従って行われます：
- ウェブソケット接続が確立されます。
- ウェブソケット接続が正常に確立され、注文ステータスが
doneまたはcancelに変更された場合、トラッキングは停止します。ウェブソケット接続が失敗した場合、またはレスポンスに不正なデータが含まれている場合、注文ステータスはショートポーリングを使用して追跡されます。 - 注文ステータスの追跡はショートポーリングで継続されます。シンプルなHTTPオーダーステータスリクエストが3秒に1回送信されます。注文ステータスが
doneまたはcancelに変更された場合、追跡は停止します。
注文状況をリクエストする
決済UIからユーザーをアプリケーションにリダイレクトする時などに、注文ステータスをリクエストすることもできます。XPaymentsクラスによって返されるステータスを使用して、決済UIがいつ閉じられたかを追跡します。
注意
XPaymentsクラスによって返されるステータスは、ユーザーが決済UIで購入フローを完了したかどうかを示し、支払いトランザクションのステータスとは異なります。XPaymentsクラスは、次のステータスを返すことができます：
XPayments.Status.COMPLETED— ユーザーが支払いを完了し、アプリケーションに戻りました。XPayments.Status.CANCELLED— ユーザーが決済UIを閉じて支払いを完了しませんでした。XPayments.Status.UNKNOWN— 例えば銀行がトランザクションを拒否した場合など、決済中にエラーが発生しました。
支払いトランザクションの現在のステータスを取得するには、ストアライブラリのgetOrderメソッドを使用してください。ショッピングカート経由の購入、ワンクリック購入、または仮想通貨の購入で受け取った注文IDをパラメータとして渡します。
この記事は役に立ちましたか？
ご意見ありがとうございました！
あなたのメッセージを確認し、体験を向上させるために利用させていただきます。このページを評価する
このページを評価する
答えたくない
ご意見ありがとうございました！
お役立ちリンク
最終更新日: 2024年3月26日誤字脱字などのテキストエラーを見つけましたか？ テキストを選択し、Ctrl+Enterを押します。
