保留中の購入は売上のように見えても、まだお金は届いておらず、先に付与すると製品をタダで渡すことになる

誰かがあなたのアプリで購入をタップします。ログには新しい注文が表示され、課金リスナーが発火し、あなたは商品を引き渡します。ほとんどの購入ではそれで正解です。しかし保留中の購入では間違いです。注文は存在しても、お金は存在しないからです。顧客は後で決済される支払い方法を選び、ストアはまだ入金を待っており、あなたは確定しないかもしれない課金のために有料機能を引き渡してしまったのです。これは返金の物静かな親戚です。ここでは何も取り消されません。そもそも何も回収されていないからです。あなたはただ製品をタダで渡しただけです。

保留中の購入は、まだ支払われていない状態にある実在の注文で、App Store も Google Play もこれを持っています。どちらのストアも、待つようにはっきりと伝えています。厄介なのは、保留中の注文がコード上では完了した注文とほとんど見分けがつかないことです。そのため、すべての新しい購入を売上として扱う実装は、ストアがまだ回収しようとしている注文で商品を出荷してしまいます。正しく扱えば何も失いません。誤って扱えば、成立しなかった遅い支払いはすべて、あなたの負担で引き渡された純粋なコストになります。

保留中の購入とは実際には何か

保留中の購入は、ストアが記録したものの、まだ課金していない注文です。買い手はフローを始め、ストアはそれを受け付け、決済はあなたのアプリからは見えないどこかで進行しています。Google Play はこれを PENDING 状態と呼びます。Apple は保留中、または延期されたトランザクションと呼びます。名前は違っても事実は同じです。ストアは入金を待つ間、注文を開いたまま保持しており、その注文をお金として扱わないようにと伝えているのです。

Google Play：支払いは別の場所で進んでいる

一部の支払い方法は帯域外で決済されます。実店舗での現金、銀行振込、一部のキャリア決済はいずれも、タップと課金の間に追加の手順を挟みます。顧客がそのひとつを選ぶと、Google は購入を PURCHASED ではなく PENDING 状態で返します。現金払いの場合、顧客は通知とメールでコードを受け取り、それを対応店舗に持って行き、レジで支払います。それが起きるまで、Google は何も回収しておらず、あなたも同じです。Google のルールは一行です。getPurchaseState() を使い、状態が PURCHASED のときにのみ権利を付与すること。また、PENDING の間は購入を確認応答しないようにとも伝えています。確認応答は支払い済みの注文に属するものであり、約束された注文のものではないからです。

Apple：この購入は誰かのタップを待っている

Apple の保留中の状態は、トランザクションが完了する前に外部のアクションを必要とすることを意味します。最も一般的なのは Ask to Buy で、子どもが購入を始め、ファミリーの管理者が承認しなければなりません。StoreKit 2 では購入呼び出しが Product.PurchaseResult.pending を返します。より古い StoreKit では、トランザクションは deferred として報告されます。いずれにせよ、Apple は誰にも課金しておらず、完了したトランザクションは、もし届くのであれば、Transaction.updates を通じて非同期に届きます。顧客には待機状態を表示し、完了したトランザクションが届くまで何もロック解除しないでください。

保留中の購入を付与するとなぜ実際にお金を失うのか

ここでの損失は、計上したお金が引き戻される返金のたぐいではありません。ある一点でそれより悪いのです。引き戻すお金がありません。そもそも一度も回収されていないからです。

あなたは引き渡すが、ストアは決して回収しない

後でキャンセルされる保留中の注文でロック解除すると、あなたはすでにそれを提供するために費やしています。機能を動かした計算リソース、あなたが料金を払った第三者の API 呼び出し、割り当てたストレージ、そして消耗型アイテムであれば、売ったものの実際の付与です。それらすべてが、収益を生まなかった注文のために外へ出て行きます。返金は少なくとも、実際に発生した課金から始まります。誤って付与された保留中の購入には、そもそも課金が一度もなかったので、出て行くお金としてすら表示されません。それは何も表示されません。だからこそ見落としやすく、繰り返しやすいのです。

キャンセルのシグナルと、その意味

保留中の注文が消えるとき、ストアはたしかにそれを知らせます。Google Play では、成立しなかった一回限りの商品は ONE_TIME_PRODUCT_CANCELED 通知、タイプ 2 を送り、保留中だったサブスクリプションは SUBSCRIPTION_PENDING_PURCHASE_CANCELED、タイプ 20 を送ります。同じ注文が逆に成立したときは、ONE_TIME_PRODUCT_PURCHASED、タイプ 1、または SUBSCRIPTION_PURCHASED、タイプ 4 を受け取ります。Apple では捕まえるべきキャンセルイベントはありません。拒否された延期トランザクションは、単に完了したトランザクションにならないからです。早くロック解除していたなら、その沈黙が請求書です。

その待ち時間と、誰が誰を待っているのか

保留中の購入は、あなたが競走している時計ではありません。あなたの側から見れば、まだ動き始めていない時計です。

Google Play が顧客に与えるのは数分ではなく数日

現金または銀行振込の支払いは、あなたのではなく顧客のスケジュールで決済されます。注文は、顧客が支払うか、期限が切れて Google がキャンセルするまで PENDING にとどまります。あなた自身の三日間の確認応答期限、つまり確認応答しなかった購入を自動的に返金するあの期限は、購入が PENDING から PURCHASED に移行するまで始まりすらしません。ですから保留中の注文を提供する必要は少しもありません。あるのはただ、状態が変わるのを待つ規律だけです。

Apple の承認はファミリー管理者の電話の中にある

Ask to Buy のリクエストは、管理者のデバイスにプロンプトとして届き、彼らは手が空いたときに承認または拒否します。それは数分後、数時間後、あるいは一日後かもしれず、あなたのアプリはそれを急かせません。唯一正しい振る舞いは、待機状態を反映し、承認が来たなら、そのときに StoreKit が完了したトランザクションを渡してくれるのに任せることです。

損失を出さずに保留中の購入を扱う方法

作業全体は四つの習慣に行き着きます。どれも難しくはなく、そのどれか一つでも飛ばすと、そこがお金の出て行く場所になります。

支払い済みの状態で付与し、保留中の状態では決して付与しない

Google Play では getPurchaseState() を確認し、PURCHASED のときにのみ付与し、PENDING の間は購入を確認応答しないでください。Apple では完了したトランザクションでのみロック解除し、保留中の結果では決して行わないでください。この一つのルールが漏れ全体を塞ぎます。あとはすべて、支払い済みの状態が届いたときにきちんと気づけるようにするための話です。

アプリが戻ってきたら再確認する

保留中から支払い済みへの移行は、あなたのアプリが動いていないときに起きることが多いです。Google Play では、onResume() ハンドラで queryPurchasesAsync() を呼び出して、バックグラウンドで PURCHASED になった注文を拾い、Real-time Developer Notifications リスナーをサーバー側の信頼できる情報源として保ってください。Apple では、承認されたトランザクションが元の購入呼び出しが返ってからずっと後に届くことがあるため、アプリの全生涯にわたって Transaction.updates を監視してください。

保留中のサポートを有効にし、両方の結末をテストする

Google は BillingClient を構築するときに enablePendingPurchases() を呼び出すことを要求しており、一回限りの商品で保留中のトランザクションをサポートすることは任意ではなく必須です。出荷する前にテストしてください。ライセンステスターには、遅延型の支払いのための二つの追加テスト手段が与えられ、そこでは支払いが数分後に自動的に完了するか自動的にキャンセルされるので、支払いの経路と成立しない経路の両方を端から端まで見届けられます。

注文がまだ終わっていないことを顧客に伝える

保留中の買い手は、購入の途中にいる実在の顧客であって、失敗ではありません。注文が彼らの支払いか承認を待っていることを示し、それを終えるために戻ってこられる明確な道を与えてください。沈黙した保留中の状態は、きちんとラベル付けすれば取り戻せる売上を失います。こうした買い手のほとんどはまだそのものを欲しがっており、あと一手順を残しているだけだからです。

RefundHalt が返金とチャージバックのためにすでに読み取っている、その同じ Real-time Developer Notifications と App Store Server Notifications のフィードは、これらのシグナルも運んでいます。保留中の注文がついに確定したと伝える購入済みの通知と、確定しなかったと伝えるキャンセルの通知は、あなたのダッシュボードで他の収益イベントの隣に届きます。ですから、成立しなかった保留中の注文は、うっかり代金を払わされたものではなく、目で見えるものになります。

手短に言うと

保留中の購入は支払いのない注文であり、両ストアともあなたが待つべきだと明言しています。Google Play は現金、銀行振込、一部のキャリア決済の注文を PENDING 状態で返し、PURCHASED のときにのみ権限を付与するようにと伝えます。Apple は Ask to Buy やその他の必要なアクションのために保留中または延期されたトランザクションを返し、完了したトランザクションを後から Transaction.updates を通じて届けます。支払い済みの状態でロック解除し、アプリが再開したら再確認し、保留中のサポートを有効にしてテストし、待機中の注文を顧客のためにラベル付けしてください。そうすれば保留中の購入は何のコストもかかりません。それを飛ばせば、決して来なかった課金のために有料製品を引き渡すことになります。それは、指し示せる領収書のない唯一の損失です。