Checkout Top-Ups & Stored Value Configuration
Inline checkout sign-up and top-up for new customers, custom top-up presets, and merchant branding color fixes.
Checkout Top-Ups for New Customers
Customers who aren't signed in or enrolled in a merchant's Stored Value program can now tap the balance top-up addon at checkout to sign up and add a top-up in a single inline flow — no navigation away from the order required.
When a customer opens the Stored Value payment sheet with zero or insufficient balance, they now see a contextual top-up amount grid instead of a disabled button. After signing in or completing onboarding, they're correctly registered as a merchant customer and can proceed immediately.
Stored Value Top-Up Configuration
Merchants can now configure custom top-up preset amounts and a low-balance reload reminder for their Stored Value programs. Settings are available in the dashboard under the new Top-Ups tab. The checkout page and balance page respect these settings; programs without custom configuration continue to use platform defaults.
Merchant Branding Fixes
Several branding color issues have been resolved:
- Merchants using "single" color mode now correctly see their configured scheme regardless of the visitor's OS dark mode preference — previously, the platform's default dark palette bled through for unconfigured color variables.
- The branding system now derives and emits all CSS variables used by UI components, eliminating color mismatches caused by variables falling back to dark-mode defaults.
- The branding editor's phone mock preview now reflects custom colors in real time.
- Advanced color overrides (primary button text, secondary button text, card background, card text, muted text, input background) are now editable under an "Advanced Colors" toggle.
Minor Improvements
- Guest customers and unenrolled customers are now protected from inadvertently purchasing balance top-ups at checkout. If a guest attempts to pay an order containing a top-up line item, the item is automatically removed and the customer is shown an updated order.
- Added checkout auth token for the crypto wallet deep-link wallet flow, preserving top-up items when customers open external wallet apps like Phantom or Solflare.
