APIv2

Retail template

Use this template to sell flexible store gift value from a retail-branded frontend. The current Lifepeaks product is gift_card_value, delivered by email after payment and fulfillment are confirmed.

bash
bun run create:storefront -- \
  --template retail \
  --out ../my-retail-storefront

Customer journey

  1. Present the brand, range, and eligible redemption channels.
  2. Offer suggested values within current catalog limits and allow a custom amount.
  3. Render the authoritative Lifepeaks quote instead of calculating fees in the browser.
  4. Collect sender and recipient details through the partner backend.
  5. Redirect to Lifepeaks-hosted QuickPay.
  6. Read canonical order state on return and confirm email delivery only after fulfillment.

Suggested values can be framed by occasion or budget. They remain monetary gift value rather than a SKU.

Integration boundary

This template does not claim to sell physical goods, a fixed product bundle, store inventory, shipping, pickup, returns logistics, or a SKU reservation. Email delivery is digital; it is not physical gift-card delivery.

If your ecommerce system lets a customer redeem the value online, that redemption integration is separate from checkout. Keep product inventory and shipment status in the ecommerce platform, not in the Lifepeaks gift-card order.

Launch checks

  • State online and in-store redemption eligibility precisely.
  • Keep physical-delivery controls out of the form unless separately implemented.
  • Test currency formatting from whole numbers of the smallest unit of the currency (50000 is DKK 500.00).
  • Test canonical payment failure and cancellation states.
  • Deduplicate webhook-driven customer notifications.

Review Headless checkout and the shared Starter templates production checklist before launch.