Executable, step-by-step walkthroughs of the Ripster consumer API (/v1) against staging. Each journey shows the exact HTTP request, runs it live (with your Clerk JWT for authenticated calls), and explains what the contract guarantees. Sign up via the header — the staging Clerk instance allows self-signup, and your API user is auto-provisioned on the first authenticated call.
Contract of record: openapi/public.json · ReDoc · integration checklist issues (agency-integration)
Sign in with Clerk, make your first authenticated call, and get everything the app shell needs in one request.
In-app start (App Store 5.1.1): request deletion with handling=self (user drains) or on_behalf (we sell/pay out), then the account closes. A later authenticated call is 410 ACCOUNT_DELETED.
Categories → pack grid → full pack detail with the odds table: probability_ppm, ticket ranges, and both RTP bases.
Free preview spin — real RNG over the real odds table, but no auth, no debit, no inventory.
The real thing: atomic debit + RNG + inventory, then replay the exact same request to see idempotent_replay=true.
read the backoffice deposit rules → create the intent → pay via hosted checkout_url or the SDK mount (session_key + checkout_jwt) with a sandbox card → poll until the webhook confirms → see the cash land.
The same create → complete → poll shape without a payment provider: useful when Coinflow credentials are absent, and it demonstrates the cancel and idempotency contracts.
Check verification state → submit identity (US instant check, or a hosted selfie/document flow) → poll until approved. Approval unblocks withdrawals AND physical shipping.
Read the payout rules → link a bank account or debit card in Coinflow's hosted page → quote fees per speed → request a withdrawal against that destination → branch on awaiting_review (true = queued for staff; false = already sent). Requires approved KYC (journey 5c).
List held items, sell one back for instant cash credit, then prove INVALID_STATE on the second attempt.
Pick held item(s) → save a shipping address (provider-validated) → quote the shipping options → pay from the cash balance and create the shipment → track it → cancel for a full refund.
Paint the ticker from the JSON backfill, then watch opens arrive live over Server-Sent Events.
The full commit-reveal loop: open history → proof for one round → set your client seed → rotate to reveal the server seed → re-verify offline.
Public curated showcase: feed grouped by pack, then deep-link a single featured pull by user_item_id.
Consumer offers → (staging) discover codes → redeem once → see grant / free-pull balance → spend pulls. Adaptive for free_pull, cash codes, and deposit_match.
Compose pack/card artwork from bootstrap media_base_url + entity asset_key (Cloudflare R2 CDN). No absolute image host required in the client.
Paid journeys need a funded staging balance. Credit yourself from the staging-only faucet, or deposit for real with a Coinflow sandbox card.