更新ごとに Google Play の注文番号は別になる。返金の前に確認すべきはこの番号です

Google Play の顧客に返金する前に、注文番号の末尾を見てください。GPA.1234-5678-9012-34567 は定期購入の最初の請求で、GPA.1234-5678-9012-34567..2 は 3 回目の請求です。ベースは同じでも別々の支払いであり、返金時の Play Console での扱いも異なります。Google Play の注文番号は顧客が目にできる唯一の識別子なので、サポートの受信箱に届くのもこの番号です。正しく読めば、顧客が実際に不満を持っている請求を、一度だけ返金できます。

Google Play の注文番号からわかること

Google の Play Billing Library のドキュメントは、形式を例で示しています。注文番号は GPA で始まり、数字のグループが続きます。定期購入では、更新のたびにベースの注文番号に 2 つのドットと 0 から始まるカウンタが付きます。つまり、最初の購入にはサフィックスがなく、1 回目の更新は ..0、2 回目は ..1 と続きます。

このため、サフィックスを見れば顧客がどれだけの期間支払っているかがすぐにわかります。GPA.3333-4137-0319-36762..11 について問い合わせてきた顧客は、12 回更新しています。サフィックスのないベース番号を伝えてくる顧客は、1 回だけ購入したか、最初の支払いを指しているかのどちらかです。

注文番号がどこに表示され、どの形で届くか

多くのチームがここでつまずきます。場所によって、同じ番号が異なる形で渡されるのです。

• 顧客の Google Play 領収書には、更新を含め、その請求に対応する注文番号が表示されます。
• アプリでは、Play Billing Library の Purchase.getOrderId() が、定期購入の更新について最初の注文の注文番号を返します。Google 自身の例では、GPA.1234-5678-9012-34567..0 ではなく GPA.1234-5678-9012-34567 が返されます。
• サーバーでは、purchases.subscriptionsv2 が各明細項目に latestSuccessfulOrderId を返します。これはその項目で最後に成功した注文の番号です。Google はこのフィールドを 2025 年 5 月 21 日に追加しました。
• Voided Purchases API では、orderId が 1 回限りの購入、定期購入の購入、定期購入の更新を一意に識別します。Google のドキュメントは、更新を区別するには購入トークンではなく orderId を使うよう求めています。

購入トークンは何のためにあるのか

購入トークンは購入全体を識別します。定期購入の場合、1 つのトークンが最初の請求とその後のすべての更新をカバーします。だからこそ、権利の管理には適したキーであり、返金には不向きなキーなのです。返金やチャージバックは 1 件の請求に対して発生し、1 件の請求を指せるのは注文番号だけです。

Google Play の注文を調べる方法

Play Console で調べる

注文管理（Order management）の検索ボックスには、注文番号か顧客の完全なメールアドレスを入力できます。各注文には、処理済み（Processed）、キャンセル済み（Cancelled）、保留中（Pending）、返金保留中（Pending refund）、返金済み（Refunded）、一部返金保留中（Pending partial refund）、一部返金済み（Partially refunded）のいずれかのステータスが表示されます。顧客が領収書ではなくメールアドレスを伝えてきた場合は、メールで検索し、日付で請求を特定してから、操作の前にサフィックスを確認してください。

Orders API で調べる

2025 年 5 月 21 日以降、Google Play Developer API の Orders リソースには、1 件の注文を取得する orders.get と、複数件を取得する orders.batchget があります。実務上、注意すべき制限がいくつかあります。

• batchget は 1 リクエストあたり 1〜1,000 件の注文番号を受け付け、重複は認められません。
• 注文番号が 1 件でも見つからない、またはパッケージに属していない場合、batchget リクエスト全体が失敗します。
• Orders API の呼び出しは Play Developer API の割り当てにカウントされ、デフォルトは 1 日 200,000 回です。

役に立つのは返ってくる Order です。注文の state、purchaseToken、createTime と lastEventTime、合計額と税額、IN_APP や PLAY_STORE などの salesChannel、そして処理・キャンセル・返金・一部返金のイベントを記録した orderHistory が含まれます。さらに developerRevenueInBuyerCurrency も含まれ、Google はこれを購入者の通貨建てで、一部返金・税金・手数料を差し引いたデベロッパーの収益と定義しています。Google が販売者（merchant of record）である場合、購入者の住所には国のみが含まれます。

正しい注文を返金する

顧客がどの請求のことを言っているかがわかったら、Play Console ではその注文が定期購入のどこに位置するかによって選択肢が変わります。

API では、orders.refund がパッケージ名と注文番号を受け取ります。3 年を超える注文は返金できません。省略可能な revoke パラメータを true にすると、定期購入やアプリ内アイテムへのアクセスが即座に終了します。Google のヘルプには、返金は一度実行すると取り消せないとも記載されているため、渡す注文番号がそのまま最終決定になります。

定期購入者に $0.00 の注文が表示されるのはなぜか

Google の定期購入ライフサイクルのドキュメントに説明があります。ユーザーが定期購入の期限切れ前に、アプリから同じ基本プランに再登録すると、Google Play は $0.00 の注文を作成します。ユーザーは現在の期間分をすでに支払っているため請求されず、通常の請求は元の更新日に再開されます。無料試用でもプロモーションでもありません。この注文に返金すべきものはありません。顧客が返金を求めている場合は、その前にある有料の注文を探してください。

誤った注文に返金するとどれだけ損をするか

返金で戻るのは価格です。一部返金も比例して同じように働きます。Google の例では、50% の一部返金で、あなたの受取額の 50% とサービス手数料の 50% も差し戻されます。戻ってこないのは、その顧客にサービスを提供するために使ったすべてのコストです。計算リソース、サードパーティ API の呼び出し、ストレージ、アフィリエイト報酬などです。誤った注文に返金すれば、これを二重に支払うことになります。

こうした事態は次のように起こります。月額プランの顧客が、先週の ..4 の請求について問い合わせてきます。チームの誰かがメールで検索し、一番上に表示された最初の注文を見て、数か月前のベース注文に「返金のみ」をクリックします。顧客はすでに利用した期間の代金を取り戻し、苦情の対象だった請求は手つかずのまま、定期購入も引き続き更新されます。顧客は先週の請求の取り消しを銀行に求めることもまだできます。

今では、この銀行経由のルートが最も高くつきます。Google によると、2026 年 8 月 3 日以降の注文では、チャージバックが成立すると、デベロッパーは購入価格（Play のサービス手数料を除く）に加え、銀行が請求するチャージバック手数料を負担します。チャージバックは銀行側で確定します。サフィックスを 1 つ読み違えただけで、返金 2 回分の金額と手数料を失うことになりかねません。

受信箱に届かない返金

Google Play の返金の大半は、あなたも注文番号も必要としません。Google の返金ポリシーでは、顧客は購入から 48 時間以内なら Google Play を通じて返金を受けられ、48 時間を過ぎたらデベロッパーに連絡するよう定めています。また Google は、3 日以内に承認されなかった定期購入を返金して取り消します。これらは後から Voided Purchases API で知ることになり、この API は voidedSource（0 はユーザー、1 はデベロッパー、2 は Google）と、Remorse、Chargeback、Unacknowledged_purchase などの voidedReason を報告します。

あなたの意見を求める Google Play の返金フローは 1 つだけです。チャージバックにデベロッパーの審査が必要な場合、24 時間以内に orders.reviewrefund で、APPROVE、DECLINE、NEUTRAL のいずれかの返金方針と購入の利用状況の証拠を添えて回答します。RefundHalt は、すでにお持ちの利用データを使ってこの審査に期限内で代わりに回答します。そのため、異議のある注文には沈黙ではなく、あなたの証拠が届きます。

注文番号に関するサポートチケットの簡単なチェックリスト

• Google Play の領収書にある完全な注文番号を、サフィックスを含めて尋ねる。
• Play Console または orders.get で調べ、まず状態を確認する。
• 請求日が顧客の説明と一致しているか確認する。
• 「返金して取り消す」は最新の注文にのみ使い、古い注文には「返金のみ」を使う。
• 返金した注文番号を記録し、後で別の注文にチャージバックが発生したときに見つけやすくする。