If you sell an Android app, you spend real time on things that are not the app. A customer says they paid but cannot get in. Someone wants a refund. Your service was down for a day and you want to give subscribers a few free days. A one-star review sits unanswered. All of that runs through Google Play, and the Android ecosystem exposes it through an API, which means your support tools, your backend, or an AI assistant can handle it for you.
An API is a set of doors into a service that other software can knock on. A program sends a request, like “is this purchase valid?” or “refund this order,” and gets an answer back. That is what lets your support desk fix billing problems without logging into a console.
What Android offers
Android is the collection of APIs and services available in the Android ecosystem, from the core platform and Jetpack libraries to Google Play services, Firebase and the Play Console. You can find it at android.com. This story is about the business side: selling inside your app and hearing from your customers.
What you can get done
Check and manage subscriptions
Plan & Entitlement Design covers the plans you sell and the state of each customer’s subscription. When a purchase comes in, Google gives you a token, a receipt your server can check.
GET /applications/{packageName}/purchases/subscriptionsv2/tokens/{token}returns the current state of a subscription.POST /applications/{packageName}/purchases/subscriptions/{subscriptionId}/tokens/{token}:acknowledgeconfirms you have received a purchase.POST /applications/{packageName}/purchases/subscriptions/{subscriptionId}/tokens/{token}:cancelstops a subscription from renewing.POST /applications/{packageName}/purchases/subscriptions/{subscriptionId}/tokens/{token}:deferpushes the renewal date out, a goodwill credit.POST /applications/{packageName}/purchases/subscriptions/{subscriptionId}/tokens/{token}:revoketakes access away immediately.
Make sure people get what they paid for
Entitlement Enforcement is about granting access to exactly what was bought. An entitlement is simply the right to use something. For one-time purchases, like coins or a level pack:
GET /applications/{packageName}/purchases/products/{productId}/tokens/{token}checks whether a purchase is real.POST /applications/{packageName}/purchases/products/{productId}/tokens/{token}:acknowledgeconfirms it.POST /applications/{packageName}/purchases/products/{productId}/tokens/{token}:consumeuses it up, so the customer can buy it again.
Issue refunds
In-App Purchases & App Store Billing covers money handled through the app store. POST /applications/{packageName}/orders/{orderId}:refund refunds a Google Play order.
Answer your reviews
Customer Feedback Management is listening and replying to what customers say. Route reviews to your support team, or draft replies with an assistant.
GET /applications/{packageName}/reviewslists your app’s reviews.GET /applications/{packageName}/reviews/{reviewId}reads one review.POST /applications/{packageName}/reviews/{reviewId}:replyposts your reply.
Workflows that put it together
A workflow is a recipe: several API calls made in a set order to finish one job. These are written in Arazzo, an open format for describing those recipes so software can follow them.
- Cancel a Subscription Purchase stops auto-renewal from your support tools while the customer keeps access until it expires.
- Defer a Subscription Renewal reads a subscriber’s expiry and pushes it forward to make good on an outage.
- Refund a Play Order finds the order behind a purchase, refunds it, and can remove access.
- Grant and Consume a Consumable Purchase verifies, acknowledges and uses up a one-time purchase.
- Reconcile Voided Purchases checks for refunds and chargebacks so access can be pulled back.
- Launch a Subscription Product with an Introductory Offer creates a new subscription with a starter deal.
- Retire an Unpublished Subscription Product deletes or archives a plan you no longer sell.
Getting started
Access is freemium with self-serve signup, and these are hosted services you call. Cost details we have gathered are in the Pricing section of the Android profile. Google’s documentation covers Android development, Google Play services and authorizing calls to the Play publishing API.
On APIs.io you can browse the full Android profile and APIs such as the Google Play Billing API, the Google Play Console API and Google Play Services APIs.
Start with the support ticket you see most, probably “I paid but cannot get in,” and have your backend check the purchase token for you.
