Buy a Store Bundle

Deducts effectivePrice of the bundle's price currency from the player and grants every reward in the bundle.

🚧

Idempotency

The Idempotency-Key header is required. Generate one key when the player taps "Buy" and send that same key on every retry of that tap, so a dropped response cannot charge the player twice. Use a fresh key for the next purchase.

After a successful purchase, re-fetch GET /player-rewards/brand/{brandId}/player/{playerId} so the player's balances reflect both the deduction and the granted reward. newBalance in the response covers the price currency only.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
uuid
required

Brand UUID returned by GET /brands/default/{tenantId}.

string
required

UUID of the bundle, from the Store bundle catalog (id).

string
required

Your internal player/customer identifier.

Headers
string
required

A key that stays stable across retries of the same purchase and is unique per new purchase. Generate one when the player taps "Buy" and reuse it for every retry of that tap, so a network failure cannot charge the player twice.

Responses

Language
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json