Technical producer focus
Turn the purchase into named states and transitions. Separate the player-facing prototype from identity, persistence, native billing, security, and refund work.
Technical Producer guide · HTML5 Games · Koin purchase UX
Technical Producer Guide to Koin Purchase Recovery for HTML5 Games
Use a playable web prototype to work through purchase recovery for HTML5 games. The goal is to make the player journey concrete before the team commits to native commerce implementation.
Create this game flow
Define the HTML5 games scope
Platform context
Design for the input, layout, interruption, and return behavior players expect from HTML5 games.
Prototype boundary
Browser delivery does not prove native store billing or platform approval.
Purchase Recovery in practice
Starting state
Show one non-required item, its preview, specific Koin amount, current Koin balance, and ownership rule in a layout suited to HTML5 games.
Main task
Write how to handle reloads, interrupted delivery, duplicate clicks, and insufficient Koin without double granting. Keep each change visible to the player rather than hiding it in technical state.
Recovery
Make a player cancellation, too little Koin, pending, interrupted delivery, and reload visually distinct, with a safe next action.
Role decision
Map preview, confirmation, a cancelled choice, a Koin shortage, pending, success, delivery, owned, and reload. Give every failure a safe next action. Use the prototype to resolve player-facing questions before creating platform integration tasks.
Solve the purchase recovery details
Design for a shareable session
For a technical producer, this purchase recovery prototype should make every player action and result shown in the game easy to evaluate. Write how to handle reloads, interrupted delivery, duplicate clicks, and insufficient Koin without double granting. Map preview, confirmation, a cancelled choice, a Koin shortage, pending, success, delivery, owned, and reload. Give every failure a safe next action. Assume a player may open the game from a link in a new browser with limited prior context. Put item identity, Koin balance, and the return route inside the playable experience.
Handle tabs and navigation
Try refresh, back navigation, a second tab, and returning after the page was suspended. A browser interaction must not imply native-store ownership or silently repeat a delivery action.
Keep canvas and interface coordinated
If the game uses a canvas, make focus, keyboard input, scaling, and purchase overlays cooperate. Closing the choice should restore game controls without leaving hidden buttons or trapped focus.
Name every state and owner
Separate preview, confirmation, pending, success, delivery, owned, insufficient Koin, cancel, interrupted, and reopened states. Assign later production work for identity, persistence, native billing, security, refunds, policy, and monitoring.
Define idempotent recovery
Repeated confirmation, a slow response, navigation during delivery, and reopening must resolve to one result. Record which state is authoritative and how the player can safely retry without another grant or Koin deduction.
Turn the prototype into tickets
Capture the visible behavior first, then create implementation tasks with expected examples for each transition and platform boundary. Do not translate a working browser interaction into an unsupported claim that backend commerce is complete.
Keep pending understandable
If delivery is interrupted, explain whether the result is pending, safe to retry, or already complete. Do not show both failure and success. Test that behavior using HTML5 games. Browser delivery does not prove native store billing or platform approval.
Make retry idempotent
Repeated clicks and reloads should resolve to one purchase result. The player must never receive duplicate items or lose Koin twice. Test that behavior using HTML5 games. Browser delivery does not prove native store billing or platform approval.
Return to a safe game state
A cancelled choice, an insufficient balance, and recoverable errors should preserve progress and offer a clear return or retry action. Test that behavior using HTML5 games. Browser delivery does not prove native store billing or platform approval.
Prototype the player journey
1. Set the platform context
Choose the input and screen behavior for HTML5 games. State the platform limit beside the prototype brief.
Result: An honest scope
2. Map purchase recovery
Write how to handle reloads, interrupted delivery, duplicate clicks, and insufficient Koin without double granting. Describe the player action and visible response at each point.
Result: A clear purchase recovery sequence
3. Add the Koin choice
Show the item, exact price, balance, confirm, cancel, pending, success, and delivery without payment-provider screens.
Result: A complete player journey
4. Apply the technical producer lens
Map preview, confirmation, a player cancellation, too little Koin, pending, success, delivery, owned, and reload. Give every failure a safe next action.
Result: Technical producer focus
5. Test return and recovery
Interrupt delivery, repeat the input, and reload. The prototype should never grant twice or leave the player in an unexplained state. Repeat the test after interruption and reload.
Result: A stable prototype
Generate the HTML5 games prototype
Prompt 1
Create a shareable browser session for a technical producer. Focus the IAP prototype on handle reloads, interrupted delivery, duplicate clicks, and insufficient Koin without double granting. Use a direct Koin item transaction with preview, exact price, confirmation, cancel, insufficient balance, success, delivery, and reload behavior. The technical producer must be able to name every state, owner, failure path, and expected check. Do not add subscriptions, payment-provider UI, revenue analytics, or native platform claims. State this boundary: Browser delivery does not prove native store billing or platform approval.
Prompt 2
Keep the item optional. Show its full price in Koin, Koin balance now, confirm, cancel, low-balance, success, visible delivery, and reload states.
Technical Producer test checklist
- The purchase recovery sequence feels natural for HTML5 games.
- The technical producer can make the intended decision from the playable result.
- The item, Koin price, and balance appear before choosing confirm.
- Cancel, not enough Koin, pending, success, and reload have different outcomes.
- The page states this boundary: Browser delivery does not prove native store billing or platform approval.
- Interrupt delivery, repeat the input, and reload. The prototype should never grant twice or leave the player in an unexplained state.
Limits for HTML5 games
- Browser delivery does not prove native store billing or platform approval.
- This guide uses a direct Koin transaction for one optional game item. It does not create a subscription or recurring charge.
- The result is a prototype that runs in a browser. Native billing, identity, durable entitlements, security, refunds, and store approval need separate implementation.
- SEELE does not provide payment analytics, tax tools, payout reports, or guaranteed revenue through this flow.
Frequently asked questions
What does purchase recovery mean here?
Write how to handle reloads, interrupted delivery, duplicate clicks, and insufficient Koin without double granting. The result is shown as a playable Koin flow.
Is this a subscription?
No. The player spends Koin directly on one named item or unlock.
What happens if the player cancels?
Return to the same game state without spending Koin or delivering the item.
What if the Koin balance is too low?
Explain the shortage, preserve progress, and do not deliver the item.
Does this include payment or revenue reports?
No. It covers the player-facing purchase experience, not financial reporting.
Is the prototype ready for a native store?
No. Browser delivery does not prove native store billing or platform approval.
Create the purchase recovery prototype
Open the complete prompt in SEELE, adjust the item and Koin price, then generate a playable version you can test.
Open this prompt in Workspace