REST Resource: purchases.voidedpurchases

  • VoidedPurchase resource represents canceled, refunded, or charged-back purchases in Google Play.

  • Includes details like purchase time, voided time, reason, and initiator (user, developer, or Google).

  • Accessible via the purchases.voidedpurchases.list method to retrieve a list of voided purchases.

  • Identifies purchases uniquely using purchaseToken (for older purchases) or orderId (for newer and subscription purchases).

  • Provides voidedSource and voidedReason fields for understanding the context of the void action.

Resource: VoidedPurchase

A VoidedPurchase resource indicates a purchase that was either canceled/refunded/charged-back.

JSON representation 
{
  "kind": string,
  "purchaseToken": string,
  "purchaseTimeMillis": string,
  "voidedTimeMillis": string,
  "orderId": string,
  "voidedSource": integer,
  "voidedReason": integer,
  "voidedQuantity": integer
}
Fields
kind

string

This kind represents a voided purchase object in the androidpublisher service.
purchaseToken

string

The token which uniquely identifies a one-time purchase or subscription. To uniquely identify subscription renewals use orderId (available starting from version 3 of the API).
purchaseTimeMillis

string (int64 format)

The time at which the purchase was made, in milliseconds since the epoch (Jan 1, 1970).
voidedTimeMillis

string (int64 format)

The time at which the purchase was canceled/refunded/charged-back, in milliseconds since the epoch (Jan 1, 1970).
orderId

string

The order id which uniquely identifies a one-time purchase, subscription purchase, or subscription renewal.
voidedSource

integer

The initiator of voided purchase, possible values are: 0. User 1. Developer 2. Google
voidedReason

integer

The reason why the purchase was voided, possible values are: 0. Other 1. Remorse 2. Not_received 3. Defective 4. Accidental_purchase 5. Fraud 6. Friendly_fraud 7. Chargeback 8. Unacknowledged_purchase
voidedQuantity

integer

The voided quantity as the result of a quantity-based partial refund. Voided purchases of quantity-based partial refunds may only be returned when includeQuantityBasedPartialRefund is set to true.

Methods

list

 Lists the purchases that were canceled, refunded or charged-back.

Error codes

The operations of this resource, return the following HTTP error codes:

Error code Reason Resolution
5xx Generic error in the Google Play server. Retry your request.

If the problem persists contact your Google Play account manager or submit a support request. Consider checking the Play Status Dashboard for any known outages.
409 Concurrency update error.

There was an attempt to update an object that is being updated. For example, a purchase is getting acknowledged by calling the Play Billing Library's acknowledgePurchase() method and by calling the Play Developer API's purchases.products.acknowledge at the same time.

 Retry your request.