From 4ca5e34610c3d306ec722cd588dc866dcfa0cd7e Mon Sep 17 00:00:00 2001 From: shum Date: Mon, 24 Aug 2026 15:09:53 +0000 Subject: [PATCH] plan: expand badges flow diagram to every scenario --- badges-flow-mvp.svg | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/badges-flow-mvp.svg b/badges-flow-mvp.svg index 1738cff87a..a2a5431320 100644 --- a/badges-flow-mvp.svg +++ b/badges-flow-mvp.svg @@ -1 +1 @@ -Supporter badges - buying a badge in the app and on the webinteraction design - one canvas, mobile band above, web checkout belowplans/2026-08-21-badges-web-checkout.mdeditable SVGIn the appevery platform - the pay button is where they differSupport SimpleXSimpleX is built by people who believe privatemessaging should not depend on advertising.A badge helps pay for it.Why SimpleX is built this way★SUPPORTERChoose your levelRedeem badge code1. Where it startsBoth actions already exist in the shipped view.'Redeem badge code' is the only route to a badge oniOS and the Play build until store evidence is verified,so it is not a secondary action there - it is the path.‹SupportYour levelTwo levels. Both remove the file size limit;Legend raises it further.Supporter$7 / month2 GB filesLegend$70 / month5 GB filesPerks are app constants, not catalog data - thecatalog carries prices only.Continue2. Choose your levelPrices come from CRBadgeCatalog, never from the storeproducts - one source, so the app and the site cannotdisagree. A tier with no active price renders disabledrather than hidden.‹Your levelLegendPrepaid months. Nothing renews by itself.1 month$703 months$140save 33%12 months$420save 50%3 months is 2x the monthly price, 12 months is 6x.The saving shown is against the undiscounted totaland is never sent anywhere - the server computesevery amount it charges.Continue in browserRedeem badge code3. How longThe button is the only platform difference in this wholeband. Desktop and Android foss get 'Continue in browser'.iOS and Play get 'Redeem badge code' and never link out,because both stores reject steering to outside purchase.‹LegendHow to payCheckout happens in your browser. Nothing ischarged in the app.CardStripeBitcoinBTCPayMoneroBTCPayContinue in browserOpens badges.simplex.chat with your choicesalready filled in.4. Only where there is a choiceDesktop and Android foss only. The screen exists becausethose builds have three methods; the store builds havenone and never reach it. The choice is a hint - the siteasks again if the parameter is unusable.‹SupportRedeem codePaste the code from your receipt.SXB-9K2M4-7QRT1-XZ5WB-3NHD8PasteRedeemThis code has already been usedcode_usedFormats as you type and folds I/L to 1 and O to 0,matching the service's own normalisation - so a coderead off a screen cannot fail on ambiguity alone.5. RedeemingOne inline message per error the service can return:invalid, used, expired, rate limited. Anything else showsthe service's own text rather than a blank screen. Thesame code can be retried - redemption is idempotent.‹SettingsSupporter perks★Legendshown on your profileENDS24 August 2027Prepaid months have no billing date. The badge isreissued each month from the balance you alreadypaid for, and simply ends when it runs out.Add more months6. After redeeming'Ends', never 'renews' - nothing recurs, and the copymust not imply it does. The date is the paid-throughdate computed from the ledger balance, not thecredential's expiry, which is a week-aligned internal.Continue in browseropens the site with tier, months and method already chosenOn the webbadges.simplex.chat - one question per screen, no framework🔒badges.simplex.chat/?tier=legend&months=12&pay=xmr★Choose your levelSupporter$7 / month2 GB filesLegend$70 / month5 GB filesContinueQuestions? simplex.chat/contact7. The site, prefilledArrives with ?tier=legend&months=12&pay=xmr from the app,so every answered question is skipped. An unknown orunpriced parameter is ignored and its screen asked -the app may be older than the catalog.🔒badges.simplex.chat/#/monthsHow long?1 month$703 months$140save 33%12 months$420save 50%Continue8. How longEvery figure here comes from GET /api/catalog, whichserves the same totals the RPC catalog gives the app.The browser formats minor units; it never multipliesa price by a month count.🔒badges.simplex.chat/#/payHow would you like to pay?CardVisa, MastercardBitcoinon-chainMoneroon-chainContinue9. MethodA method whose provider is not configured is refused atcheckout with provider_unavailable, not hidden here -so a misconfigured deployment fails loudly rather thanquietly offering less.🔒badges.simplex.chat/#/checkoutCheck your orderLevelLegendDuration12 monthsMethodMoneroTotal$420.00Pay with MoneroYou will be shown an address and a QR code. The badgecode appears here once the payment confirms.10. One request, server-pricedPOST /api/checkout sends priceId, offerId and method -never an amount, never a badge type. Both are derivedserver-side from the ids, so a tampered request cannotbuy a Legend badge at a Supporter price.🔒badges.simplex.chat/?order=8f3a...c21eSend 1.482 XMR$420.00 - rate held for 58:12MONERO ADDRESS48HqK2...9fRtWcCopy!Waiting for the payment to confirmLeave this page open, or bookmark it - the address andthe countdown are both on this URL. If the invoiceexpires before it confirms, you are offered a new one.REFERENCEK7M2Qquote this to support11. Paying in cryptoFive states behind one screen: invoiced, pending, paid,expired, failed. An expired invoice that was underpaidshows what arrived and the reference - the shortfall ismeaningless once the rate window has closed.🔒badges.simplex.chat/?order=8f3a...c21e✓Paid. Here is your code.SXB-9K2M4-7QRT1-XZ5WB-3NHD8Copy codescan to carry it to your phoneREDEEM IT IN THE APPSimpleX -> Settings -> Supporter perks -> Redeem codeThis is the only place the code is shown.This page keeps working until 23 September, and stopsas soon as the code is redeemed. The link is the code.12. The code, onceThe code is derived from the order id, not stored - so areload recomputes it while only its hash is ever at rest.Disclosure stops at redemption, at revocation, or 30 daysafter settlement, whichever comes first.the code goes back to screen 5the only thing that crosses from the site to the appDesign document. Screens are drawn in the app's iOS idiom and in the site's own simple layout; they are not screenshots. What is built today: the service schema, the pricing catalog, the ledger, code derivation and classification, credential signing, and the RPC dispatcher.What is design, not yet built: every screen above, the web listener and its endpoints, both payment providers, and the client redeem path. Store purchase is removed on iOS and Play for the duration of this plan - store evidence is not verified, so a store purchase would charge for a badge that is never issued. \ No newline at end of file +Supporter badges - every screen, in the app and on the webinteraction design - the app in its native idiom, the site in its ownplans/2026-08-21-badges-web-checkout.mdeditable SVGIn the appiOS idiom shown; Android and desktop differ only in chromeSupport SimpleXSimpleX is built by people who believeprivate messaging should not depend onadvertising. A badge helps pay for it.Why SimpleX is built this waySUPPORTERChoose your levelRedeem badge codeA1. Where it startsBoth actions ship today. On iOS and Play, 'Redeembadge code' is not a secondary path - it is the onlyone, because store evidence is not verified and thestore purchase was removed rather than left chargingfor nothing.‹SupportYour levelBoth levels remove the file size limit.Legend raises it further.Supporter$7 / month2 GB filesLegend$70 / month5 GB filesPerks are app constants, not catalog data -the catalog carries prices only.ContinueA2. Choose your levelPrices come from CRBadgeCatalog, never the storeproducts. One source, so the app and the site cannotdisagree about what a badge costs.‹Your levelLegendPrepaid months. Nothing renews by itself.1 month$703 months$140save 33%12 months$420save 50%3 months is 2x the monthly price, 12 is 6x. Thesaving compares against the undiscounted totaland is never sent anywhere - the server pricesevery charge it makes.Continue in browserRedeem badge codeA3. How long - desktop and Android fossThe only builds with more than one way to pay, andthe only ones that link out. 'Continue in browser'carries the answers so far as URL parameters.‹Your levelLegendPrepaid months. Nothing renews by itself.1 month$703 months$140save 33%12 months$420save 50%Buy a code at badges.simplex.chat from anybrowser, then redeem it here.Redeem badge codeno purchase button on this buildA4. How long - iOS and PlaySame screen, different ending. The store purchaseaction is removed for the whole of this plan, and nolink out replaces it: Apple and Google rejectsteering to outside purchase for digital goods, sothe screen simply ends at redemption.‹LegendHow to payCheckout happens in your browser.Nothing is charged in the app.CardVisa, MastercardBitcoinon-chainMoneroon-chainContinue in browserOpens badges.simplex.chat with tier, monthsand method already chosen.A5. Only where there is a choiceDesktop and Android foss only. The store builds haveno methods at all and never reach this screen. Thechoice is a hint: the site asks again if theparameter is unusable.‹SupportRedeem codePaste the code from your receipt.SXB-9K2M4-7QRT1-XZ5WPasteRedeemFormats as you type and folds I and L to 1,O to 0 - the same normalisation the servicedoes, so a code read off a screen cannot failon ambiguity alone.A6. RedeemingTwenty Crockford characters in five groups. The checkcharacter is verified before anything is sent, so amistyped code never reaches the service and nevercosts a throttle token.‹SettingsSupporter perksLegendshown on your profileENDS24 August 2027Prepaid months have no billing date. The badgeis reissued each month from the balance youalready paid for, and ends when it runs out.Add more monthsA7. After redeeming'Ends', never 'renews' - nothing recurs and the copymust not imply it does. The date is the paid-throughdate from the ledger balance, not the credential'sexpiry, which is a week-aligned internal the usernever sees.‹ChatsAliceAAliceLegendlast seen recentlyIN GROUPSAAliceLegendBBobSupporterCCarolThe badge travels with the profile, so it showswherever a profile does - in chats, in a memberlist, on a contact card.A8. How everyone else sees itThe point of the whole flow. The badge is a signedcredential carried in the profile and verified by therecipient's own client against the issuer key italready ships - not a flag the server asserts, andnot something a client can set for itself.For the operatorthe CLI that mints and resolves codessimplex-badge-service$simplex-badge-service codes issue \--type legend --months 12 --count 3 \--batch conf-2026 --expires 2027-08-24SXB-9K2M4-7QRT1-XZ5WB-3NHD8SXB-2W7XP-4LMQ8-9DKR3-6TVZ5SXB-8HYNC-1FGJ6-5PBW2-7QSXD3 codes issued. Printed once; only hashes stored.OP1. Minting codesCompensation and promotional codes have no orderbehind them, so they are random rather than derived.Printed once to stdout and never again - the databaseholds only SHA-256 hashes, which is what makes astolen copy useless.support$simplex-badge-service codes status \--ref K7M2Qorder 8f3a...c21e paid 24 Augbadge legend, 12 monthscode redeemed 2 Sep--reveal refused: code already redeemedOP2. Resolving a referenceThe customer quotes the five-character reference fromtheir receipt - never the order id, never the code.--reveal is refused once a code is redeemed orrevoked, on the same reasoning that stops the webpage disclosing it.On the webbadges.simplex.chat - one centred column, max-width 560, the logo the only imagebadges.simplex.chat/?tier=legend&months=12&pay=xmrChoose your levelBoth levels remove the file size limit.Supporter$7 / month2 GB filesLegend$70 / month5 GB filesContinuesimplex.chat/contactB1. The site, arriving prefilledOne centred column, generous whitespace, the SimpleX symbol as the only image -deliberately not the app's chrome. Arrives with ?tier&months&pay from the app, soevery answered question is skipped.badges.simplex.chat/#/monthsHow long?Prepaid months. Nothing renews by itself.1 month$703 months$140save 33%12 months$420save 50%Continuesimplex.chat/contactB2. How longEvery figure comes from GET /api/catalog, the same totals the RPC catalog gives theapp. The browser formats minor units and computes the comparison only - it nevermultiplies a price by a month count.badges.simplex.chat/#/payHow would you like to pay?Card is handled by Stripe. Bitcoin and Moneroare on-chain, through BTCPay.CardVisa, MastercardBitcoinon-chainMoneroon-chainContinuesimplex.chat/contactB3. MethodA method whose provider is not configured is refused at checkout withprovider_unavailable rather than hidden here, so a half-configured deployment failsloudly instead of quietly offering less. See C4.badges.simplex.chat/#/checkoutCheck your orderLevelLegendDuration12 monthsMethodMoneroTotal$420.00Pay with MoneroYou will be shown an address and a QR code.simplex.chat/contactB4. One request, priced by the serverPOST /api/checkout carries priceId, offerId and method - never an amount, never abadge type. Both are derived server-side from the ids, so a tampered request cannotbuy a Legend badge at a Supporter price.badges.simplex.chat/?order=8f3a...c21eSend 1.482 XMR$420.00 - this rate is held for 58:12MONERO ADDRESS48HqK2...9fRtWcCopyWaiting for the payment to confirmREFERENCEK7M2QBookmark this page - the address and the countdownboth live on this URL.simplex.chat/contactB5. Paying in cryptoPolls GET /api/order every 2s for the first minute then every 10s, and stops while thetab is hidden. A partial payment stays 'pending' - partials are the normal first eventof a multi-transaction payment, not a failure.badges.simplex.chat/?order=8f3a...c21e✓Paid. Here is your code.SXB-9K2M4-7QRT1-XZ5WB-3NHD8Copy codescan to carry it to your phoneREDEEM IT IN THE APPSimpleX -> Settings -> Supporter perks -> Redeem codeThis is the only place the code is shown.This page works until 23 September, and stops as soon asthe code is redeemed. The link is the code - treat it so.simplex.chat/contactB6. The code, onceDerived from the order id rather than stored, so a reload recomputes it while only itshash is ever at rest. Disclosure stops at redemption, at revocation, or 30 days aftersettlement - whichever comes first.badges.simplex.chat/?order=51c7...9d02Payment receivedWaiting for the card network to confirm.Still processingThis usually takes a few seconds. The page updates itself.If nothing happens for 15 minutes, we stop waitingand show you what to do next.simplex.chat/contactB7. Coming back from the card flowStripe's success_url returns here with ?order=. The return is NOT proof of payment -only the webhook settles an order, so this screen polls rather than celebrating. Thecancel URL deliberately carries no order reference at all.When it does not go to planevery failure the design has to answer for‹SupportYour levelBoth levels remove the file size limit.Supporter—price unavailableLegend—price unavailableCould not reach the badge serviceinternalContinueDisabled, not hidden - a level that exists butcannot be priced still exists.C1. The service is unreachableEvery option renders disabled and nothing crashes.The same state covers a tier whose price was disabledby the operator - the app cannot tell the two apart,and does not need to.‹SupportRedeem codeThis code isn't validcode_invalidThis code has already been usedcode_usedThis code has expiredcode_expiredToo many attempts. Try again in 4 minutes.rate_limited - retryAfter 240Could not verify the credentialinternalOne message per error the service can return.Anything else, including a credential that failsto verify locally, shows the service's own textrather than a blank screen.C2. Every redemption errorA revoked code is deliberately indistinguishable froman unknown one - both say 'isn't valid', so a guesserlearns nothing from a revocation. Support tells themapart with codes status; the wire does not.‹SettingsSupporter perksLegendended 24 August 2027Your badge has endedThe months you paid for have all been issued.The badge stopped showing on your profile;nothing was cancelled and nothing is owed.Add more monthsC3. The balance runs outAn exhausted balance is not an error: the servicereturns no credential and a zero-balance statement,and the app says so plainly. Prepaid means it simplystops.badges.simplex.chat/#/payHow would you like to pay?Monero is temporarily unavailableTry another method, or come back later.CardVisa, MastercardBitcoinon-chainMonerounavailableContinuesimplex.chat/contactC4. A provider is not configured503 provider_unavailable from /api/checkout. Themethod is shown and disabled rather than omitted, soan operator who forgot a section sees it immediatelyinstead of wondering why nobody pays in Monero.badges.simplex.chat/#/checkoutThese prices have changedStart again with the current pricesThe badge you chose was repriced while you were deciding.Nothing was charged.Start againprice_disabled / offer_disabled / offer_mismatchsimplex.chat/contactC5. The catalog moved underneathPrices are checked at checkout and only there. Adeprecated price is still honoured for someone mid-flow; a disabled one is refused. Repricing appends anew price rather than editing the old, so this israre but reachable.badges.simplex.chat/#/checkoutToo many attemptsTry again in 46 secondsThe Pay button is disabled until then.Pay with Monero429, with Retry-After. The polling loop backs off tothat value rather than treating it as a failure.simplex.chat/contactC6. Rate limitedFive checkout requests a minute per IP, because eachone reaches a payment provider. Order polling getssixty. The redemption path has no IP at all - it runsover SimpleX RPC and is throttled per signer instead.badges.simplex.chat/?order=8f3a...c21eThis invoice expired0.734 XMR arrived, which is not the full amountThe rate window has closed, so the shortfall is no longermeaningful. Quote the reference below and we will sort it out.REFERENCEK7M2QStart a new invoiceNever shows the code, and never the ?order= URL.simplex.chat/contactC7. Expired, and underpaidThe one state that needs a human. An expired-but-paidinvoice still settles later - late on-chainsettlement is routine and moves the order to paid -but an underpaid one stops here with the referencesupport resolves by.badges.simplex.chat/?order=8f3a...c21eThis code has been redeemedThe code is no longer shown hereIt was redeemed on 2 September. If that was not you,get in touch.Legend, 12 monthspaid 24 AugustThe order stays; the capability does not.simplex.chat/contactC8. The page outlives the codeDisclosure ends at redemption, at revocation, or 30days after settlement. The order is still herebecause support resolves a reference against it - butthe URL stops being equivalent to the code, which isthe whole point.Continue in browsercarries tier, months and method as URL parametersthe code goes back to A6the only thing that crosses from the site to the appDesign document. The app screens are drawn in the iOS idiom; Android and desktop differ only in chrome. The site is drawn in its own idiom - one centred column, max-width 560, the SimpleX symbol as the only image, accent #0053D0 - and is deliberately not a copy of the app's.Built today: the service schema, the pricing catalog, the ledger, code derivation and classification, credential signing, the RPC dispatcher and the operator CLI. Design, not yet built: every screen above, the web listener and its endpoints, both payment providers, and the client redeem path.Store purchase is removed on iOS and Play for the duration of this plan: store evidence is not verified, so a store purchase would charge for a badge that is never issued. \ No newline at end of file