Request parental approval for a purchase
POST/transaction/request-purchase
Ask the player's trusted adult to approve one purchase. Use this endpoint
before charging, and complete the purchase only once the approval
arrives. The request is held until expiresAt, after which it can no
longer be approved or denied.
The outcome is delivered as a Transaction.PurchaseApprovalResult
webhook carrying approved, denied or expired. Treat expiresAt as
the deadline rather than waiting on the webhook indefinitely.
Resubmitting an id that is already awaiting a decision is a safe no-op:
the pending request is returned unchanged and no second request is
created, so retries after a network failure won't prompt twice.
A player may hold at most 20 purchases awaiting a decision; beyond that
the call is rejected with INVALID_INPUT until one resolves.
Request
Responses
- 200
- 400
Approval request accepted.
Invalid request - the response body's error field carries a
specific code (e.g. INVALID_INPUT, NOT_FOUND,
FEATURE_DISABLED).