acknowledge purchase
This block is part of the android group and was last modified in core v15.0.0.
acknowledge purchase v15.0.0 Tells Play you have granted what the user bought. Not optional: Google revokes and refunds any purchase left unacknowledged for three days, so a flow that verifies a purchase and stops here gives the money back : days later, quietly.
- flow
flow - connection required
androidconnection - package name required
valueAndroid app package
- product id required
valueThe purchased product / subscription id.
- token required
valueThe purchase token to acknowledge.
- is subscription
conditionOn for a subscription, off for a one-time product : they are different endpoints.
- developer payload
valueOptional string stored alongside the purchase.
- flow
flow - success
conditionTrue when acknowledged : including when it already was.
- already acknowledged
conditionTrue when Play reported it was acknowledged before. Treated as success on purpose: retries and redelivered notifications must not look like the purchase went bad.
- response
object - error
value
play |
google play |
acknowledge |
ack |
iap |
in app purchase |
billing |
subscription |
Google refunds any purchase that is not acknowledged within three days, so this block is not optional bookkeeping: it is the step that keeps the payment. Verify first, unlock the entitlement, then call acknowledge purchase on the true side of the branch. The already_acknowledged pin means a retry is safe, which matters because this chain will be re-run by a client that lost its connection halfway.
Version history
Introduced in v15.0.0.
Service documentation
External API reference This block wraps a third-party service. Click here for the service's own documentation of the underlying endpoint.Back to
android Return to the main group to view all sub-groups Back to android Return to the group to view all blocks within this group