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

# Stripe Managed Payments

> Use the merchant of record (MoR) solution from Stripe in FunnelFox to offload tax compliance, fraud prevention, disputes, and post-purchase support to Stripe.

[Stripe Managed Payments](https://docs.stripe.com/payments/managed-payments) is a merchant of record solution from Stripe
that handles indirect tax compliance, fraud prevention, disputes, and
transaction-level customer support on your behalf.

You can enable Managed Payments per Checkout element in FunnelFox, so it can run
alongside your regular Stripe checkout in the same project.

## How it works

Once enabled, Stripe takes over key parts of the payment lifecycle for
checkouts that use Managed Payments:

* **Merchant of record**: Stripe acts as the merchant of record. Customers
  interact with Stripe Link at checkout, on receipts, and for post-purchase
  support.
* **Indirect tax compliance**: When a payment completes, Stripe withholds
  applicable indirect taxes (sales tax, VAT, GST). Managed Payments covers post-sale
  tax compliance across 80+ countries.
* **Fraud prevention**: Stripe applies real-time fraud detection that
  automatically blocks fraudulent transactions.
* **Dispute handling**: Stripe manages disputes for you using automated
  tools and manual review. If Stripe decides to counter a dispute, it
  submits evidence on your behalf without contacting you for more.
* **Customer support**: Stripe handles transaction-level customer support
  for purchases made through Managed Payments.
* **Prebuilt checkout**: Managed Payments is delivered through Stripe's Prebuilt
  checkout. Customers can pay with cards, Apple Pay, and Link, plus any
  local methods configured for your account.

<Warning>
  - Managed Payments doesn't support upsell for now.

  - [Cancellation funnels](/dashboard/funnels#cancellation-funnels) don't
    support Managed Payments for now.
</Warning>

Learn more about Managed Payments in [Stripe's documentation](https://docs.stripe.com/payments/managed-payments).

## Setup

You need an active [Stripe integration](/integrations/payments/stripe)
set up with API keys before you can enable Managed Payments.

<Steps>
  <Step title="Enable Managed Payments in Stripe">
    Go to the
    [Managed Payments settings](https://dashboard.stripe.com/settings/managed-payments)
    in your Stripe Dashboard and enable Managed Payments. During the
    flow:

    1. Review your products and assign each one a category eligible for
       Managed Payments when Stripe prompts you.
    2. Select **Prebuilt checkout** when choosing a checkout type.
    3. Click **Continue** until Managed Payments is enabled.

    <Frame>
      <img src="https://mintcdn.com/funnelfox/niyZd1Ag9uutmQ3a/assets/enable-smp-stripe.png?fit=max&auto=format&n=niyZd1Ag9uutmQ3a&q=85&s=4b0e5abd512df0bea539830920e8e7b9" width="1894" height="870" data-path="assets/enable-smp-stripe.png" />
    </Frame>
  </Step>

  <Step title="Set the tax code on new products">
    If you add new products after enabling Managed Payments, make sure each one uses a
    tax code eligible for Managed Payments.

    Learn more about Stripe's
    [product tax code requirements](https://docs.stripe.com/payments/managed-payments/eligibility#product-tax-code-requirements).
  </Step>

  <Step title="Review your tax settings in Stripe">
    Managed Payments handles indirect tax compliance, so your Stripe tax settings
    must be accurate. Go to
    [Settings > Tax](https://dashboard.stripe.com/settings/tax) in your Stripe Dashboard and
    adjust individual products if needed.

    <Frame>
      <img src="https://mintcdn.com/funnelfox/UMPCEHA4Hij-Juf5/assets/stripe-tax-settings.png?fit=max&auto=format&n=UMPCEHA4Hij-Juf5&q=85&s=0753c0912fea96b3b1fe08203648bbef" width="1892" height="867" data-path="assets/stripe-tax-settings.png" />
    </Frame>
  </Step>

  <Step title="Enable Managed Payments in FunnelFox">
    Go to
    [Integrations > Stripe](https://app.funnelfox.com/integrations/stripe)
    in FunnelFox and toggle on **Managed Payments**.

    <Frame>
      <img src="https://mintcdn.com/funnelfox/990whnOWXFCbD60V/assets/smp-toggle-ff.png?fit=max&auto=format&n=990whnOWXFCbD60V&q=85&s=0855e282905cd1f1098bde88281c0554" width="1920" height="989" data-path="assets/smp-toggle-ff.png" />
    </Frame>
  </Step>

  <Step title="Configure your Checkout element">
    Open your [Checkout element](/elements/checkout) in the Editor and enable **Managed Payments**, then configure the product you
    sell and its type.

    <Frame>
      <img src="https://mintcdn.com/funnelfox/990whnOWXFCbD60V/assets/smp-checkout.png?fit=max&auto=format&n=990whnOWXFCbD60V&q=85&s=bc7806339ca1c10562ea80a75624fcd6" width="1178" height="976" data-path="assets/smp-checkout.png" />
    </Frame>
  </Step>
</Steps>

<Check>
  Managed Payments is now active on that Checkout element. Republish
  your funnel to apply the changes.
</Check>

## Payment methods

Cards, Apple Pay, and Stripe Link are automatically enabled as payment
methods for Managed Payments and cannot be disabled.

Any additional payment methods can
be configured by the Managed Payments support team at Stripe.

Learn more about [payment method configurations for Managed Payments](https://support.stripe.com/questions/payment-method-configurations-for-managed-payments).

<Frame>
  <img src="https://mintcdn.com/funnelfox/990whnOWXFCbD60V/assets/smp-example.png?fit=max&auto=format&n=990whnOWXFCbD60V&q=85&s=5bcf2ccbb11097753eb4a332025986cc" width="1920" height="1068" data-path="assets/smp-example.png" />
</Frame>

## Digital wallets

FunnelFox supports Apple Pay and Google Pay with Stripe
Managed Payments for faster checkout. Apple Pay is enabled by default,
but you still need to verify your domains before customers can use it.

Google Pay must be configured by the Managed Payments support team at
Stripe.

<Info>
  This article covers digital wallets for Stripe Managed Payments. For
  regular Stripe checkout, go to the
  [Stripe integration](/integrations/payments/stripe#digital-wallets).
</Info>

### Apple Pay

Apple Pay for Managed Payments requires domain verification before you
can use it.

To verify your domain:

1. Go to **Settings > Payments > Payment method domains** in your [Stripe Dashboard](https://dashboard.stripe.com/dashboard).

<Frame>
  <img src="https://mintcdn.com/funnelfox/adC29xs54DhAVVj3/assets/payment-method-domains.png?fit=max&auto=format&n=adC29xs54DhAVVj3&q=85&s=12b897c89ab0930f965d77f59adb6548" width="1889" height="812" data-path="assets/payment-method-domains.png" />
</Frame>

2. Click **+ Add a new domain**.

3. Add your project domain from [Settings > Domains](https://app.funnelfox.com/settings/domains) in FunnelFox and click **Save**. If you have a custom domain, add it as well.

<Info>To use Apple Pay in funnel preview mode, add `http://app.funnelfox.com/` as a domain.</Info>

<Frame>
  <img src="https://mintcdn.com/funnelfox/j8O36tDipoHcKqB5/assets/stripe-add-domain.png?fit=max&auto=format&n=j8O36tDipoHcKqB5&q=85&s=17d1d696dcb9bf999cd1753f57ac057d" width="1887" height="756" data-path="assets/stripe-add-domain.png" />
</Frame>

4. Go to [Settings > Domains](https://app.funnelfox.com/settings/domains) in FunnelFox.

5. Select **Stripe** under **Apple Pay domain verification**.

<Frame>
  <img src="https://mintcdn.com/funnelfox/j8O36tDipoHcKqB5/assets/stripe-apply-pay-select.png?fit=max&auto=format&n=j8O36tDipoHcKqB5&q=85&s=d74e50d0d008118c78683d4f26545f34" width="1920" height="879" data-path="assets/stripe-apply-pay-select.png" />
</Frame>

6. Click **Save**.

<Check>Apple Pay will become available in your funnels after domain
verification completes.</Check>

#### Wallet-first checkout

By default, Apple Pay is shown alongside other payment methods during
checkout.

You can enable **Wallet-first checkout** to provide a seamless
one-click payment experience similar to a wallet button. It prioritizes
Apple Pay by showing it first to customers, while other payment methods
are placed under the **Pay another way** button:

<AccordionGroup>
  <Accordion title="Default behavior">
    Apple Pay is shown among additional payment methods:

    <Frame>
      <img src="https://mintcdn.com/funnelfox/n1OgKgikpe-ePGmv/assets/apple-stripemp-default.png?fit=max&auto=format&n=n1OgKgikpe-ePGmv&q=85&s=3d3839ea06b8b63749193019428225fd" style={{height: "650px"}} width="1179" height="2556" data-path="assets/apple-stripemp-default.png" />
    </Frame>

    Apple Pay is shown as payment method for Link:

    <Frame>
      <img src="https://mintcdn.com/funnelfox/n1OgKgikpe-ePGmv/assets/apple-stripemp-default2.png?fit=max&auto=format&n=n1OgKgikpe-ePGmv&q=85&s=59b0dd1fa8d49a9cbd954e7c3fa53e4d" style={{height: "650px"}} width="1179" height="2556" data-path="assets/apple-stripemp-default2.png" />
    </Frame>
  </Accordion>

  <Accordion title="Wallet-first behavior">
    Prioritized Apple Pay:

    <Frame>
      <img src="https://mintcdn.com/funnelfox/n1OgKgikpe-ePGmv/assets/apple-button-stripe-mp.png?fit=max&auto=format&n=n1OgKgikpe-ePGmv&q=85&s=ad9f196b2689bfee90d7bd2dfc3319d2" style={{height: "650px"}} width="1179" height="2556" data-path="assets/apple-button-stripe-mp.png" />
    </Frame>
  </Accordion>
</AccordionGroup>

To enable Wallet-first Apple Pay behavior:

1. [Verify your domain](#apple-pay).

2. Configure your [Checkout element](/elements/checkout):
   * Ensure **Managed Payments** is toggled on.
   * Toggle on **Wallet-First Checkout**.

<Frame>
  <img src="https://mintcdn.com/funnelfox/n1OgKgikpe-ePGmv/assets/apple-button-stripe-mp-setup.png?fit=max&auto=format&n=n1OgKgikpe-ePGmv&q=85&s=1762345d220012adb75ec72e8d38afa1" width="1365" height="972" data-path="assets/apple-button-stripe-mp-setup.png" />
</Frame>

## FAQ

<AccordionGroup>
  <Accordion title="Does FunnelFox charge extra fees for Stripe Managed Payments?">
    FunnelFox doesn't apply its own fees for Managed Payments. Stripe charges its own
    fees for Managed Payments.

    Learn more about [Stripe's Managed Payments pricing](https://stripe.com/en-es/pricing#managed-payments).
  </Accordion>

  <Accordion title="Can I use Managed Payments and regular Stripe checkout in the same project?">
    Yes. Managed Payments is enabled per Checkout element, so you can
    mix Managed Payments and regular Stripe checkouts within the same project or even within the same funnel.
  </Accordion>

  <Accordion title="Can I customize the checkout appearance with Managed Payments?">
    Not in the FunnelFox Editor. The checkout is managed by
    Stripe. You can edit basic branding (logo, colors, icon) in
    Stripe's
    [Branding settings](https://dashboard.stripe.com/account/branding).
  </Accordion>
</AccordionGroup>

## Next steps

* [Stripe integration](/integrations/payments/stripe)
* [Configure checkout element](/elements/checkout)
