Manual Purchase Handling
This section covers functions designed for developers who prefer to manually handle purchase verification and acknowledgment on their own server.
Instead of relying on automatic consumption or acknowledgment, these functions provide direct control over the purchase flow — allowing you to launch a purchase, receive its token, and confirm or consume it later after your backend validation.
Manual purchase handling is useful when:
- You need to verify purchases securely through your backend before granting items or subscriptions.
- You want to implement custom logic for fraud detection or entitlement management.
- You require more flexibility in managing purchase states and tokens across multiple devices or accounts.
Launch Billing Flow Manual
This asynchronous function works similarly to the standard LaunchBillingFlow, but it does not automatically acknowledge or consume the purchase after completion.
It is intended for developers who want full control over purchase validation and confirmation on their own backend.
When using this function, you’ll receive a purchase details struct that includes the purchase token. This token can then be verified on your server before calling Acknowledge Purchase or Consume Purchase.
This approach provides maximum flexibility and is recommended for apps that rely on secure server-side validation of transactions.
Acknowledge Purchase
This asynchronous function must be called for every completed purchase in order to finalize it.
Google Play requires that all purchases be acknowledged within three days, otherwise the transaction will be automatically refunded.
The function takes the purchase token as a parameter, confirms the purchase with Google Play, and then returns the same token back — allowing you to use it later for Consume Purchase, if the product is consumable.
This manual acknowledgment flow ensures that only verified purchases are finalized, giving your backend full control over entitlement logic and item delivery.
Consume Purchase
This function is used to consume a previously acknowledged purchase.
Consuming a purchase means marking it as used, so the same item can be bought again in the future.
This applies only to one-time consumable products (for example, in-game currency or resources).
The function takes the purchase token obtained during the purchase or acknowledgment process, performs the consume request, and confirms the operation with Google Play.
After a successful consume, the token becomes invalid and a new one will be issued on the next purchase.
