wealth/docs/decisions/0059-invite-code-in-checkou...

963 B

0059 Checkout takes an invite code from its link once, then forgets the URL

Status: Accepted · Area: architecture · Date: 2026-10-10 · Decided by: user · Supersedes: 0044

Context

J06-7: the capacity-opened alert and SMS open /checkout/@user?code=… with the investor's code applied. 0044 kept the code out of checkout's URL.

Decision

  • The channel reads ?code= and checkout reads ?code= on arrival. Either one saves it in the persisted session.checkout-draft store under inviteCodes[creatorId], written only after the draft is restored.
  • Checkout then removes code from the address bar with router.replace, fills the field, marks it as from the link and checks it.
  • The code is dropped after a paid subscription to that creator or on sign-out.

Alternatives

  • Link the alert to the channel (0044): one extra tap before paying while capacity lasts.

Consequences

A shared checkout link carries a code only until it is opened.