サーバーがすでに受け取っている返金理由コードを読めば、アプリを修正すべきか顧客と争うべきかがわかる

Apple や Google があなたの顧客の一人に返金するとき、お金はたいてい、あなたが意見を言う前に消えています。その後サーバーに届くものはレシートのように見え、ほとんどのチームはそれをレシートとして扱います。それ以上のものです。すべての返金には返金理由コードが付いており、決定が下された後でもなお読み取れる返金の唯一の部分です。Google Play は、その返金がチャージバックだったのか、後悔による申請だったのか、あるいは自分のアプリが一度も承認しなかった購入だったのかを教えてくれます。Apple は、その返金がアプリ内の何かを責めたものかどうかを教えてくれます。そのコードを読めば、返金はレポートの一行であることをやめ、指示になります。これを修正せよ、これに対抗せよ、あるいはこれは手放せ、と。各コードの意味、それらの振り分け方、そしてそれぞれのコストを解説します。

返金理由コードとは実際に何か

返金理由コードとは、購入が取り消された理由に対するストア独自のラベルです。あなたが設定するものではなく、反論もできません。事後に返金へ付随して届き、2つのストアはそれぞれ異なる形で、まったく異なる粒度で公開します。

Google Play はすべての無効化に理由とソースを刻印する

Google Play の Voided Purchases API は、取り消された購入ごとに1件のレコードを返し、各レコードには重要な2つの整数が含まれます。voidedReason は購入が無効化された理由を示します。voidedSource はそれを動かしたのが誰かを示します。この2つが合わさると、ただの返金が一つの文になります。この注文はチャージバックのため Google によって開始されて無効化された、あるいは後悔としてユーザーによって開始されて無効化された、というふうに。これらは API をポーリングするか、無効化が届いたときに発火するリアルタイムのデベロッパー通知を購読することで読み取ります。いずれにせよ、この2つの数値こそ保持する価値のあるペイロードです。

Apple はより狭いが鋭いシグナルを与える

Apple は9通りの理由を渡してはくれません。返金されたトランザクションでは、Apple は revocationReason を2つの値のいずれかに設定します。1 は、App Store がアプリ内の実際のまたは知覚された問題を理由にそのトランザクションを返金したことを意味します。0 は、たとえば誤購入など、別の理由で返金したことを意味します。このフィールドは返金または取り消しがなされたトランザクションにのみ、revocationDate とともに、REFUND App Store Server Notification の署名済みトランザクション情報の中に現れます。2つの値は多くありませんが、重要なほうの 1 は、その返金が顧客の心変わりではなくあなたの製品に関するものだと Apple が告げているのです。

Google Play が与える9つの理由

Google の voidedReason は2つのうちより豊かなほうで、どの値もそれぞれ別の場所を指し示すため、ひと目で分かるようにしておく価値があります。VoidedPurchase リソースからそのまま取り出した全リストと、各コードが実際にあなたに何をせよと告げているのかを示します。

voidedSource は誰が引き金を引いたかを教える

理由の隣には voidedSource があり、別の問いに答えます。これを取り消したのは誰か。0 はユーザーが、セルフサービスまたは銀行を通じて行ったことを意味します。1 は開発者、つまりあなたやあなた自身のツールが返金を発行したことを意味します。2 は Google が独自の判断で行ったことを意味し、未承認購入に対する自動返金もこれに含まれます。無効化の急増を見たとき、ソースが最初の切り分けです。source 2 の壁は、Google があなたのアカウントに対して動いているということで、それはたいてい、顧客ではなくあなたの連携を指し示すシグナルです。

すべての返金を修正・対抗・容認に振り分ける

コードが役立つ理由は、その返金が3つの対応のうちどれに値するかを教えてくれるからです。ほとんどのチームはすべての返金を同じように扱い、決して勝てないものに労力を燃やします。コードはきれいに分かれます。

修正：製品が引き起こした返金

いくつかのコードは、返金の服をまとったバグ報告です。Google の欠陥（3）と未受領（2）、そして Apple の revocationReason 1 は、すべて同じことを言っています。顧客は支払ったのに、アプリが届けなかった、と。未承認購入（8）はその中で最も鋭いものです。落ち度が完全にあなたの請求コードにあるからです。これらは最も安く根絶できる返金です。誰かを説得することによってではなく、自分が持つものを修正することで根絶できるからです。この山で件数が増えることは、金額の付いた製品欠陥です。

対抗：誰かが仕掛けている返金

詐欺（5）、身内による詐欺（6）、チャージバック（7）は紛争です。純粋な詐欺（5）はあなたの顧客ではなく、そもそも得られるはずのない収益です。身内による詐欺（6）は、購入者が支払ったとおりのものをきちんと受け取ってから異議を申し立てるもので、あなたの証拠がなお動かし得る唯一の紛争です。そしてチャージバック（7）は、その証拠が提出される場です。これらのいずれかが届いたら、まだであればアクセスを取り消し、審査の窓が開いている場合はそのアカウントについて分かっていることで応じます。

容認：そもそも止められなかった返金

後悔（1）と誤購入（4）は、顧客自身の心変わりです。Apple の revocationReason 0 もここに入ります。機能が失敗したわけでも、詐欺が起きたわけでもありません。より明確な購入確認によって誤購入の山は和らげられますが、後悔による返金を言い負かすことはできません。それに費やす時間は、実際にお金がある修正の山から奪われた時間です。

理由コードを失いやすくする30日の落とし穴

Google の側には、これをレポート機能から締め切りへと変える厳格な制限があります。コードを継続的に取得していなければ、失っています。

Voided Purchases API は30日しか遡らない

Google は、この API が過去 30日 の無効化された購入しか表示できないと明言しています。それより古い無効化は、どんな startTime を渡しても返されず、startTime の値そのものも 30日 前より過去には設定できません。素朴な連携にとってさらに厄介なのは、この 30日 の窓が、購入がいつ行われたか、あるいはレコードの voidedTimeMillis によってではなく、Google のシステムが購入を無効化とみなした時点で測られることです。そのため、その窓の中で取得しない返金理由コードは失われ、少しでも隙間のある月次エクスポートのジョブは、追いつくのが遅すぎて捕まえ損ねた無効化を静かに取りこぼします。

理由コードが金額としてどれだけの価値を持つか

2つのコードには具体的な価格が付いており、それらを読むことが、そうでなければ集計された返金率の中に隠れてしまう問題に数字を付ける方法です。

あるコードは自分で書いた請求書

voidedReason 8、未承認購入は、あなたが引き起こした返金の最もわかりやすい例です。Google Play は、権利を付与してから 3日以内 に購入を承認することをアプリに求めており、そうしなければ Google は自動的に注文を返金し、アイテムを取り消します。8 が刻印されたすべての無効化は、製品を欲しがった顧客からの本物の売上であり、購入を承認する呼び出しが一度も発火しなかったために返されたものです。失われた金額は、満額の販売価格に加え、それを届けるためにすでに費やした計算資源、API 呼び出し、ストレージです。これは交渉する返金ではありません。閉じるべきバグであり、コードはそれを見つける手がかりです。

チャージバックのコードには今や手数料が付く

voidedReason 7、チャージバックは、August 3, 2026 にコストが変わりました。その日以降に行われた Google Play の注文では、チャージバックに負けると開発者は購入価格から Play のサービス手数料を差し引いた額に加えて銀行のチャージバック手数料を負担し、Google は自らのサービス手数料のみを負担します。チャージバック手数料は定額で製品価格はそうではないため、安価なアプリ内購入では手数料だけで顧客の支払額を上回ることがあります。コード 7 の無効化を数えることは、いまや単なる失われた売上ではなく費目を数えることであり、まさにそれこそ、あなたが作るどんな返金レポートでもチャージバックの山が独自の行に値する理由です。

Apple と Google はどう並ぶか

2つのストアは同じ問いに異なる解像度で答えるため、ストア横断の返金レポートは、両者が一致すると期待するのではなく、正規化しなければなりません。

ストアが同じ返金に対して同じコードをくれることは決してありませんが、それで構いません。重要なのは、どちらも機械可読な理由を渡してくれること、そしてどちらもそれを読むチームに報いることです。Apple の1ビットは、返金が製品の落ち度であるときを教えてくれます。Google の9つの理由とソースのフラグは、どの製品バグ、どの紛争、そしてどの自ら招いた請求の穴を見ているのかを教えてくれます。どちらのコードも返金を止めはしません。どちらも、次の一件が起きないように何をすべきかを教えてくれます。

RefundHalt は、両方のストアで、すべての返金の理由コードを届いた瞬間に取得し、Google の 30日 の窓の十分内側で保持するので、何も取りこぼしません。各無効化を修正・対抗・容認に振り分けるので、コード 3 欠陥の急増は製品アラートとして、コード 8 未承認の急増は、あいまいな収益の落ち込みとしてではなく連携のバグとしてあなたに届きます。Apple の CONSUMPTION_REQUEST には 12時間 以内、Google Play のチャージバック審査には 24時間 以内に応じ、返金やチャージバックが届いた瞬間にアクセスを取り消します。ストアが返金に刻印するコードを変えることはできません。すべてを読み、実際に自分が修正すべきものに対して行動することはできます。