MerchantFlow Payment Methods Guide

MerchantFlow payment methods are managed through your workspace's billing provider. Standard web signups use Stripe-hosted checkout for secure payment processing, while Shopify App Store installs handle payments through the Shopify billing system.

How Payment Works for Stripe-Billed Workspaces

Standard web signups use Stripe-hosted checkout.

During Onboarding

For a new web workspace:

1. The owner reaches /onboarding/payment
2. Selects monthly or annual billing
3. Clicks Start Free Trial
4. MerchantFlow creates a Stripe checkout session
5. Stripe collects the payment method on its hosted page

MerchantFlow requires a verified email before the Stripe checkout session can be created.

After Onboarding

From Settings > Billing:

• Add Payment Method is shown when the workspace does not yet have a completed Stripe billing setup
• Update Card opens the Stripe billing portal when a Stripe customer already exists

Stripe handles the payment form and billing portal UI. MerchantFlow does not expose raw card storage inside the app.

Important Limits

• Demo accounts cannot open the live Stripe billing portal
• Shopify-billed tenants cannot use Stripe payment management for that workspace

How Payment Works for Shopify-Billed Workspaces

Shopify App Store installs use Shopify billing.

• Plan approval happens in Shopify
• Payment methods are managed on the Shopify side
• Charges appear with the rest of your Shopify bill

How to Change Your Payment Details

Use the control that matches your billing provider:

• Stripe tenants are routed through Stripe checkout or the Stripe billing portal
• Shopify tenants update payment details in Shopify admin

Troubleshooting Payment Issues

"Billing says I need to verify my email"

That is expected on the Stripe path. MerchantFlow blocks checkout creation until the owner's email is verified. Check your inbox for the verification email or visit Security for details.

"Billing sent me to the wrong provider"

The billing provider is fixed at the tenant level:

• Standard web signup uses Stripe
• Shopify App Store install uses Shopify

If the tenant was created through Shopify, use the Shopify billing path even if you can also sign into MerchantFlow directly.

"Update Card is unavailable"

This usually means one of the following:

• The workspace is a demo or development-only billing state
• The tenant is Shopify-billed
• Stripe customer setup has not been completed yet

If you are unsure which path your workspace uses, check Billing Overview or contact [email protected].

Frequently Asked Questions

What payment methods does MerchantFlow accept?

For Stripe-billed workspaces, MerchantFlow accepts payment methods supported by Stripe checkout, including major credit and debit cards. Shopify-billed workspaces use whatever payment methods are configured in your Shopify account.

How do I update my credit card in MerchantFlow?

Go to Settings > Billing and click Update Card to open the Stripe billing portal. If the button is unavailable, check that your workspace uses Stripe billing and that checkout has been completed.

Is my payment information stored securely?

Yes. MerchantFlow does not store raw card data. All payment processing is handled by Stripe (for web signups) or Shopify (for App Store installs), both of which are PCI-DSS compliant.

Why can't I add a payment method to my MerchantFlow workspace?

This may happen if your email is not verified, the workspace is in demo mode, or the workspace uses Shopify billing. Verify your email first, then retry from Settings > Billing.

Can I use PayPal to pay for MerchantFlow?

Payment method availability depends on your billing provider. Check with Stripe or Shopify for their supported payment methods.

Related Pages

• Pricing Plans
• Trial Period
• Invoices

---

Last updated: March 14, 2026