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.
