2023.12.11

【Google】無効(返金やチャージバック)となった購入の情報をリアルタイムに通知で取得する

saratogax

記事内に商品プロモーションを含む場合があります

GooglePlay のアプリ内課金で無効扱いになった購入。

「voidedpurchases」の API を利用すると取得できるのですが、発生頻度が少ないのに定期的にチェックするのはリソースがもったいない。

っとみんな思っていたと思いますが、2023 年 11 月に、ついにデベロッパー通知に対応されました。

今回は、デベロッパー通知の内容とハンドリングを紹介していきます。

Contents

voidedPurchaseNotification
voidedpurchases API
まとめ

voidedPurchaseNotification

新しくデベロッパー通知に追加されたのは「voidedPurchaseNotification」で、無効な購入が発生した場合は、既存の通知メッセージの最初の階層に設定されます。

{
    "version": string,
    "packageName": string,
    "eventTimeMillis": long,
    "oneTimeProductNotification": OneTimeProductNotification,
    "subscriptionNotification": SubscriptionNotification,
    "voidedPurchaseNotification": VoidedPurchaseNotification,
    "testNotification": TestNotification
}

VoidedPurchaseNotification オブジェクトの中身は以下の通りで、無効となった理由などは含まれないので、詳細を知りたい場合は voidedpurchases の API 実行が別途必要です。

{
    "version": string,
    "packageName": string,
    "eventTimeMillis": string,
    "voidedPurchaseNotification": {
        "purchaseToken": string,
        "orderId": string,
        "productType": integer
    }
}

voidedPurchaseNotification

voidedpurchases API

voidedpurchases API では以下の情報が取得できますが、取得時のリクエストパラメータに orderId や purchaseToken を指定できないので面倒です。

{
    "kind": string,
    "purchaseToken": string,
    "purchaseTimeMillis": string,
    "voidedTimeMillis": string,
    "orderId": string,
    "voidedSource": integer,
    "voidedReason": integer
}