Administration
Control the consumer VHP product safely
Configure VHP launch, price, Stripe mapping, gifts, promotions, dealer credits, ownership support, refunds and release readiness.
The consumer product has a separate launch flag from the GarageOS VHP module. Keep public launch off until the backend, indexes, Stripe mapping, DVLA configuration and staging smoke checks have passed.
Stripe setup
- Configure the Stripe publishable key, encrypted secret key and encrypted webhook secret in the dedicated Stripe settings area.
- Create and map the one-time consumer product and price, plus any dealer credit-package products and prices.
- Use TEST mode for staging and confirm the account mode returned by a minimal backend connection test.
- Configure the existing webhook endpoint for checkout.session.completed, invoice events used by GarageOS and charge.refunded.
- Never copy real secret values into documentation, screenshots, support tickets or normal Mongo documents.
Launch readiness
- Consumer product, public signup and checkout have independent switches.
- The backend blocks paid launch when product/price mapping or Stripe credentials are missing.
- TEST and LIVE are visibly distinct and normal staff cannot switch them.
- Existing GarageOS VHP remains independent when consumer launch is off.
Complimentary activation channels
A qualifying garage-customer activation requires a same-tenant real vehicle, real customer relationship and completed qualifying job. Staff-benefit credits are a separate configurable garage ledger and do not require a job. Admin gifts require recipient, vehicle, reason and explicit confirmation. A full free promotion never fabricates a Stripe transaction.
Dealer and staff credit ledgers
Dealer purchases, grants and redemptions are separate from garage staff-benefit allowances and adjustments. Do not edit mutable balances. Each usable balance is derived, tenant-scoped and cannot go negative; funding and handover are transactional and idempotent.
Refunds and ownership support
A refund changes commercial entitlement state and marks support review. It does not delete the Passport or vehicle history. Ownership claim decisions require a recorded reason; registration, email matching, a public QR or a dealer credit alone cannot prove ownership.
Prelaunch operator checklist
- Verify encrypted Stripe credential state without printing values.
- Verify DVLA/DVSA environment readiness without making production changes.
- Run the explicit VHP index duplicate scan and exact-definition verification.
- Run backend tests, focused frontend tests, full tests, build, SEO and docs validation.
- Keep public launch OFF for deployment and internal smoke.
- Enable only after explicit commercial approval.