Skip to main content

Checkout Overview

Waffo Pancake uses a two-step checkout flow optimized for conversion. This design collects customer details first, then payment information, reducing abandonment and supporting accurate tax calculation.

Checkout URLs

Checkout pages use a session-based URL structure:
https://your-domain.com/store/{store-slug}/checkout/{sessionId}
ComponentDescription
store-slugYour store’s unique URL slug
sessionIdCheckout session identifier created when a customer initiates checkout
Checkout sessions are generated server-side and contain product, pricing, and currency information.

Two-Step Flow

Step 1: Customer Details

Collects information needed for tax calculation and order processing. Required Fields:
FieldPurpose
Email addressReceipt, account creation, Customer Portal access
CountryTax jurisdiction determination
Conditional Fields (Based on Country):
FieldWhen Shown
ZIP/Postal CodeMost countries (US, CA, UK, etc.)
State/ProvinceUS, CA, AU, IN, and other applicable countries
Business Purchase Option: Customers can toggle “I’m purchasing as a business” to provide:
  • Business name
  • Tax ID (for VAT/tax exemption)

Step 2: Payment

Card Payment

  • Card number
  • Expiry date (MM/YY)
  • CVC/CVV
  • Cardholder name

Digital Wallets

  • Apple Pay (iOS, Safari)
  • Google Pay (Android, Chrome)
  • One-click with biometric auth
Order Summary is displayed alongside the payment form with product name, image, subtotal, tax, and total.

Subscription Checkout

For subscription products, additional billing information displays:
ElementExample
Billing frequency”Billed monthly”
Recurring amount”$29.00/month”
Next billing dateCalculated from today
Trial duration”7-day free trial” (if the product has trials enabled)

Customization

Make your checkout page match your brand through the Checkout Settings in your dashboard. Upload a custom logo displayed on the checkout page. Supported formats include PNG, JPG, and SVG.

Theme Mode

Light Mode

White background, dark text. Best for most brands.

Dark Mode

Dark background, light text. Modern aesthetic.
Switch between Light and Dark mode presets. Each mode maintains its own set of color values.

Color Settings

SettingField NameDefault (Light)Default (Dark)
Primary ColorcheckoutColorPrimary#7CCB02#ADFF85
Background ColorcheckoutColorBackground#FFFFFF#0A1A1F
Card ColorcheckoutColorCard#F3F4F6#0A1A1F
Text ColorcheckoutColorText#111827#FFFFFF
Secondary Text ColorcheckoutColorTextSecondary#8C8C8C#8C8C8C

Border Radius

Control the roundness of UI elements with the checkoutBorderRadius setting. Default is 8px. Options range from 0px (sharp corners) to 16px (extra-large rounding).
Ensure sufficient contrast between text and background colors for accessibility. WCAG recommends a contrast ratio of at least 4.5:1.

Store Information

OptionDescription
Store NameShown in header
Support EmailFor customer questions
Terms LinkLink to your terms of service (required)
Privacy LinkLink to your privacy policy (required)

Multi-Language Support

Checkout automatically displays in the customer’s browser language:
LanguageCode
Englishen
Chinese (Simplified)zh
Japaneseja

Processing & Results

After payment submission:
  1. Card validation — Luhn check, expiry, CVC verification
  2. 3D Secure — Bank verification (if required by the issuing bank)
  3. Authorization — Charge to card
  4. Order creation — Record in system
Success Page: Order confirmation number, receipt email notification, next steps, Customer Portal link. Failed Page: Clear error explanation, suggested action, retry button, support contact option.

Error Handling

ErrorCauseCustomer Action
Card declinedInsufficient funds or bank blockTry different card
Invalid cardIncorrect card numberCheck and re-enter
Expired cardCard past expirationUse valid card
CVC mismatchWrong security codeRe-enter CVC
3DS failedBank verification failedContact bank

Test Checkout

Use Test Mode to try the checkout flow without real charges.
CardNumberResult
Visa Success4242 4242 4242 4242Success
Declined4000 0000 0000 0002Declined
3DS Required4000 0027 6000 31843D Secure flow
Test mode is indicated by a banner: “Test Mode - No real charges will be made”

Merchant of Record Notice

At checkout footer, customers see:
“This order is processed by our online reseller & Merchant of Record, Waffo Pancake, who also handles order-related inquiries and returns.”
This disclosure is required for MoR compliance and helps customers understand the payment relationship.