Stripe QR Checkout Payments in FMX

Updated 2 weeks ago · 4 min readAdvanced
Accept payments at your photo booth with Stripe. Customers scan a QR code on the booth screen, pay on their phone, and the booth continues automatically after the QR code disappears.

What You Need

  • A Foto Master Cloud account with a Pro plan (or Scale plan, once released)
  • An active FMX license
  • A Stripe account connected through Stripe Connect
  • An internet connection at the booth

You do not need:

  • A card reader
  • A payment terminal
  • A tablet or phone running Stripe POS
  • A booth operator

How It Works

When the booth reaches the payment step:

  1. The booth creates a unique Stripe Checkout session for this customer and displays it as a QR code
  2. The customer scans it with their phone
  3. Stripe opens on the customer’s phone
  4. The customer pays
  5. The booth confirms the payment
  6. The QR code disappears
  7. The workflow continues to the next step

Setup

1. Connect Stripe in FMX Cloud

  • Open FMX Cloud at cloud.fotomaster.com and login.
  • Click your profile picture.
  • Choose Settings.
  • Click on Stripe tab
  • Finish the Stripe onboarding steps
If you already have a Stripe account, you can usually sign in and connect that existing account instead of creating a duplicate.

Stripe may ask for:

  • Business details
  • Identity verification
  • Bank account details
  • Tax information

2. What Stripe May Ask For

During onboarding, Stripe may ask for:

  • legal business name
  • EIN or tax ID
  • bank account details
  • government-issued ID

For most accounts, onboarding takes about 5 to 10 minutes.

Typical timing:

  • Most accounts are verified and charge-ready within minutes
  • Some accounts may need additional documents and take 1 to 2 business days
  • In rare cases, it can take 5 to 7 business days

3. Enable the Right Payment Methods in Stripe

  • Open Stripe Dashboard
  • Go to Settings > Payments > Payment methods
  • Select your connected account
  • Scroll to the bottom and click View settings (Photo 1)
  • Open the Eligible tab
  • Find the payment method you want to use
  • Click Request access (Photo 2)
Photo 1:

Photo 2:

If Stripe approves the request, the payment method will become available for your account.

4. Configure FMX Desktop

  • Open FMX
  • Go to Global Settings
  • Open the Devices tab
  • Set Payment Provider to Stripe
  • Click Test Connection
  • Save your changes

5. Add a Payment Step to Your Workflow
  • Open the Workflow Editor
  • Add an animation node with Payment trigger where you want to collect payment
  • Set the payment amount
  • Save the workflow

FMX will create the Stripe checkout for that amount automatically.

Daily Use

Once everything is set up, the booth handles the rest:

  • The customer reaches the payment step
  • The QR code appears
  • They scan and pay
  • The QR code disappears
  • The workflow continues

If the customer does not finish payment in time, the booth will show a new QR code so they can try again.

Where Transactions Appear

You can view Stripe payments in your Stripe Dashboard under Transactions > Payments.

That page shows:

  • the payment amount
  • the payment method
  • the customer
  • the date and time
  • whether the payment succeeded, failed, or was refunded
If you are testing in sandbox or test mode, the payments appear there too.



Payment Methods

Stripe checkout can accept the payment methods that are enabled in your Stripe account. Depending on your setup, that may include:

  • Credit or debit card
  • Apple Pay
  • Google Pay
  • Link


Troubleshooting

What you see

What to do

QR code does not appear

Make sure Payment Provider is set to Stripe

Stripe test connection fails

Check that Stripe is connected in FMX Cloud

Payment was made but the booth did not continue

Wait a few seconds, then check your internet connection

Payment times out

The customer did not finish in time. The booth will show a new QR code

Stripe says the account is not ready

Finish the remaining steps in Stripe onboarding

he payment method type provided: {payment method name} is invalid

Go back to Stripe and request access for that payment method.


FAQ

Do I need special hardware?
No. Customers pay on their own phones.

Do I need an operator?
No. The flow is automatic.

Do I need to create products in Stripe?
No. FMX sends the payment amount directly.

Can I use different prices for different events?
Yes. Set the payment amount in the workflow.

Can more than one booth use the same Stripe account?
Yes, if your FMX Cloud setup links them that way.

Was this helpful?

Related articles