> ## Documentation Index
> Fetch the complete documentation index at: https://docs.flexype.io/llms.txt
> Use this file to discover all available pages before exploring further.

# FAQ

> Common questions about onboarding, checkout, payments, billing, the dashboard, and webhooks.

Answers to the questions merchants and developers ask most. Each answer links to the full guide if you need more detail.

<CardGroup cols={3}>
  <Card title="Getting started" icon="rocket" href="#getting-started-and-onboarding">
    Onboarding, timelines, and going live
  </Card>

  <Card title="Checkout" icon="cart-shopping" href="#checkout-and-platforms">
    Shopify, headless, and mobile apps
  </Card>

  <Card title="Payments" icon="credit-card" href="#payments-and-gateways">
    Gateways, credentials, and webhooks
  </Card>

  <Card title="Billing" icon="wallet" href="#billing-and-credits">
    Prepaid credits, tiers, and GST
  </Card>

  <Card title="Dashboard" icon="gauge" href="#dashboard-and-features">
    Coupons, upsells, RTO, customization
  </Card>

  <Card title="Developers" icon="code" href="#webhooks-and-api">
    Webhooks, retries, and API keys
  </Card>
</CardGroup>

## Getting started and onboarding

<AccordionGroup>
  <Accordion title="How long does onboarding take?">
    Typically **24–48 hours**. Onboarding is fully managed — you share Shopify collaborator access, our team builds the integration on a duplicate of your theme, and you approve a preview before going live. See [Shopify onboarding](/platforms/shopify).
  </Accordion>

  <Accordion title="What do I need to provide to get started?">
    Your Shopify **collaboration code** and **store URL**, your business and GST details, team members, and payment gateway credentials for the gateways you want enabled. Full checklist in the [Shopify guide](/platforms/shopify).
  </Accordion>

  <Accordion title="Will FlexyPe change my live theme?">
    No. We integrate on a **duplicate** of the theme you nominate (your live theme if you don't specify one), and you review a preview/testing link before anything goes live.
  </Accordion>

  <Accordion title="Why shouldn't I regenerate my collaboration code?">
    Regenerating it revokes our access mid-integration. Don't click **Generate New Code** until your FlexyPe checkout integration is fully completed.
  </Accordion>

  <Accordion title="Do I need to be onboarded before integrating a headless storefront or mobile app?">
    Yes — Shopify onboarding is **mandatory** first. Your store must be onboarded and your domain registered with FlexyPe before you can integrate on [Hydrogen/headless](/platforms/hydrogen) or [mobile apps](/platforms/mobile-apps).
  </Accordion>
</AccordionGroup>

## Checkout and platforms

<AccordionGroup>
  <Accordion title="Which platforms does FlexyPe checkout support?">
    * **Shopify** — managed theme integration ([guide](/platforms/shopify))
    * **Hydrogen and other headless/React storefronts on Shopify** — browser SDK ([guide](/platforms/hydrogen))
    * **Mobile apps backed by a Shopify store** — hosted checkout in a webview ([guide](/platforms/mobile-apps))
  </Accordion>

  <Accordion title="How does FlexyPe know which store a checkout belongs to?">
    On headless storefronts, FlexyPe detects your store from the **domain the script runs on**, which must match the domain you registered during onboarding. On `localhost`, add `data-shop-domain` to the script tag. See [store detection](/platforms/hydrogen#how-store-detection-works).
  </Accordion>

  <Accordion title="Checkout won't open on my headless storefront. What's wrong?">
    The most common cause is a **domain mismatch** — the domain serving the script isn't the one registered with FlexyPe. Confirm the registered domain, and in local development set `data-shop-domain` explicitly. Remove that attribute in production.
  </Accordion>

  <Accordion title="How do I open checkout inside my mobile app?">
    Create a checkout session from your backend, then load `https://checkout.flexype.io/?session={session_id}` in a webview. Creating the session server-side keeps your API key out of the app binary. See [Mobile Apps](/platforms/mobile-apps).
  </Accordion>

  <Accordion title="Can I customize how checkout looks?">
    Yes. [Checkout Customization](/handbook/customizations/overview) covers general styling, and the login, address, and payment steps individually.
  </Accordion>
</AccordionGroup>

## Payments and gateways

<AccordionGroup>
  <Accordion title="Which payment gateways can I connect?">
    Razorpay, Easebuzz, Cashfree, PayU, XPay, PhonePe, Snapmint, and CCAvenue. See [Payment Providers](/integrations/payment/razorpay) for per-gateway setup.
  </Accordion>

  <Accordion title="Which gateways need webhook configuration?">
    PayU, Cashfree, XPay, and Easebuzz require webhook setup. Razorpay requires account authorization and no webhook setup. PhonePe requires sharing your **MID** with our team — mapping is manual and can take up to a week.
  </Accordion>

  <Accordion title="Can I add gateways after going live?">
    Yes. Configure them any time from **Settings → [Payment Settings](/handbook/settings/payments)**.
  </Accordion>

  <Accordion title="Who supports gateway-side issues?">
    Your gateway's own support team. We can refer you to a provider if you don't have an account yet, but technical questions about the gateway itself go to them.
  </Accordion>

  <Accordion title="Can I run discounts tied to a specific payment method?">
    Yes — [Payment Offers](/handbook/paymentoffers) creates payment-method-specific discounts, for example prepaid-only offers to shift volume away from COD.
  </Accordion>
</AccordionGroup>

## Billing and credits

<AccordionGroup>
  <Accordion title="How does FlexyPe billing work now?">
    FlexyPe bills from a **prepaid credit balance**. Charging starts with your first processed order, cumulative sales determine your tier, and charges are deducted daily. Full detail in [Billing and Payments](/misc/billing).
  </Accordion>

  <Accordion title="Did my plan change when you moved to prepaid?">
    No. Your selling plan, tiers, and rates are unchanged — only **when** charges are calculated and collected. See [what changed](/misc/billing#what-changed-postpaid-prepaid).
  </Accordion>

  <Accordion title="How do I add credits?">
    **Settings → Billing & Usage → Add Credits**, or the **Available Credits** shortcut in the left navigation. [Step-by-step](/misc/billing#how-to-add-credits).
  </Accordion>

  <Accordion title="Is GST included in my recharge amount?">
    No — **18% GST is added on top**. A ₹1,000 recharge is billed at ₹1,180 and adds ₹1,000 to your balance. Add your GSTIN in [Store Details](/handbook/settings/storedetails) to claim input credit. See [GST and taxes](/misc/billing#gst-and-taxes).
  </Accordion>

  <Accordion title="How much should I keep in my balance?">
    Your estimated monthly charges plus a buffer of about **4–5 days** of expected charges. Watch **days of credit left** and the projected balance on the Billing & Usage balance strip. See [billing analytics](/misc/billing#billing-analytics).
  </Accordion>

  <Accordion title="Why is there a credit or debit line in my usage history?">
    Crossing a tier threshold triggers reconciliation — the cycle is recalculated at the new tier and the difference posts as a credit or a debit. See [how it works](/misc/billing#how-prepaid-billing-works).
  </Accordion>

  <Accordion title="If I go live mid-month, do I pay the full plan amount?">
    No. The plan amount is divided across the days of the month and you're charged only for days used. [Worked example](/misc/billing#worked-examples).
  </Accordion>
</AccordionGroup>

## Dashboard and features

<AccordionGroup>
  <Accordion title="How do I set up my first discount campaign?">
    Go to [Coupons](/handbook/coupons/overview) and pick a type — Amount Off, Buy X Get Y, Purchase Driven, Exclusive Free Gift, Free Shipping, or Bundle. Configure the rules and activate.
  </Accordion>

  <Accordion title="How can I reduce RTO?">
    Enable the [RTO Suite](/handbook/rtosuite) for OTP verification, address validation, and fraud signals so risky orders are caught before fulfillment.
  </Accordion>

  <Accordion title="How do I recover abandoned carts?">
    The [Abandoned Cart](/handbook/abandonedcart) dashboard lists incomplete checkouts, and you can wire recovery flows to the [ACR webhook](/webhooks/2026-05/acr) to trigger your own messaging.
  </Accordion>

  <Accordion title="Can I increase average order value at checkout?">
    Yes — [Smart Upsells](/handbook/upsell) supports pre- and post-purchase offers.
  </Accordion>

  <Accordion title="How do I control who on my team can access what?">
    Assign roles in [Users & Permissions](/handbook/settings/usersandpermissions) and audit actions in [Activity Logs](/handbook/settings/activitylogs).
  </Accordion>

  <Accordion title="Where do I configure taxes and duties?">
    [Taxes & Duties](/handbook/settings/taxesandduties) — add your GSTIN, choose inclusive or exclusive pricing, and define regional rules.
  </Accordion>

  <Accordion title="Can I connect Meta Pixel and Google Analytics?">
    Yes. [Ads & Integrations](/handbook/settings/integrations) covers [Meta](/integrations/analytics/meta), [Google Ads](/integrations/analytics/google-ads), and [Google Analytics](/integrations/analytics/google-analytics).
  </Accordion>
</AccordionGroup>

## Webhooks and API

<AccordionGroup>
  <Accordion title="What webhook events are available?">
    Abandoned Checkout Recovery, Abandoned Session Recovery, Collection Viewed, Product Viewed, and New Customer. See [available events](/webhooks/overview#available-events) and [event triggers](/webhooks/event-triggers) for exact firing conditions.
  </Accordion>

  <Accordion title="How do I verify a webhook is really from FlexyPe?">
    Compare the `X-Flexype-Authorization` header against the secret you set when creating the endpoint, before processing anything. See [verifying webhooks](/webhooks/overview#verifying-webhooks).
  </Accordion>

  <Accordion title="What happens if my endpoint is down?">
    FlexyPe retries three times — after 1 minute, 5 minutes, and 15 minutes. After that the delivery is marked failed, and you can retry it manually from the dashboard. See [retry logic](/webhooks/overview#retry-logic).
  </Accordion>

  <Accordion title="Why did I receive the same event twice?">
    Retries reuse the original `X-Event-Id`. Deduplicate on that header and persist processed IDs so it survives restarts. See [idempotency](/webhooks/overview#idempotency).
  </Accordion>

  <Accordion title="How fast must my endpoint respond?">
    Return **HTTP 200 within 10 seconds**. Acknowledge first, then process asynchronously in a queue or background job.
  </Accordion>

  <Accordion title="Where do I get API keys?">
    Dashboard → **Settings → [API Keys](/handbook/settings/apikeys)**. Rotate them regularly, keep them in environment variables, and revoke any key you suspect is exposed. Authentication details are in the [API Reference](/api-reference/introduction).
  </Accordion>
</AccordionGroup>

## Still stuck?

<CardGroup cols={2}>
  <Card title="Contact Support" icon="headset" href="mailto:support@flexype.io">
    Reach the FlexyPe support team
  </Card>

  <Card title="WhatsApp community" icon="whatsapp" href="https://chat.whatsapp.com/FefLuQOz4TL2bCpIebzPOH">
    Product updates, tips, and other merchants
  </Card>
</CardGroup>