Skip to main content

Setting up in-person credit card payments with the Stripe Terminal

Learn how to set up a Stripe Terminal card reader and take in-person card payments from an invoice in splose.

Stripe Terminal lets you take card payments in person, at the front desk or right after a session, using a reader that connects to Stripe and settles the payment straight against a splose invoice. Clients tap their card, or their phone via Apple Pay or Google Pay, and the invoice updates to paid automatically.

This guide covers what you need before you start, how to set up your card reader, and how to take a payment from an invoice.


Before You Begin

  • Connect Stripe to splose.
    Stripe Terminal uses the Stripe account that is created when you connect Stripe to your splose workspace. If you have not connected Stripe yet, do that first. See Set up Stripe.

Use the Stripe account connected to splose

Your Terminal location and reader must be created in the Stripe account that splose created when you connected the integration. Standalone Stripe accounts you set up yourself are not supported, and a reader registered in one will not appear in splose.

When you connected Stripe to splose, you were asked to set an email address and password for the new account. Use those to sign in to Stripe.

If you sign in with that email and still cannot see your location, check the account selector in the top left of the Stripe Dashboard. You may have more than one account, and you need the one connected to splose.

  • Order a card reader from the Stripe Dashboard. Choose the BBPOS WISEPOS E device.

    Photo of the BBPOS WISEPOS E Stripe Terminal card reader device


Set up your card reader

The steps below outline how to register your reader in Stripe once it arrives.

  1. In Stripe, under More, click Terminal.

  2. Under Locations, click New.

  3. Create your location, then click Save.

  4. Under Readers, click New.

  5. On the reader, swipe from the left to open settings and enter the admin code 07139.

  6. On the reader, tap Generate pairing code — it produces three random words (for example, "apple-grape-orange").

  7. Back in Stripe, enter that code to register the reader, then click Save.

  8. Once registered, the reader appears under Readers, which confirms setup is complete.

⚠️ Match your Stripe location to your splose location

The location name and details you create in Stripe Terminal must match a location set up in splose under Settings → Locations. If they don't match, the Terminal option won't appear when you take payment on an invoice for that location. Note that each Stripe reader links to a single Stripe location, so make sure the invoice you're paying is for the matching location.

💡 If you have any issues, follow the official Stripe reader setup documentation.


Accept a payment from an invoice

The steps below outline how to charge a client's card in person against an invoice.

  1. Create an invoice and click Pay.

  2. In the drop-down, under Stripe, click Terminal.

  3. Select the amount payable.

  4. Select the Terminal to use.

  5. Click Send to terminal.

  6. splose sends the amount to the reader, which displays it for the client. The client taps their card, or their phone via Apple Pay or Google Pay, to pay, and once complete, the invoice status updates to Paid.


Fees

Terminal payments are charged at the same rate as other Stripe payments in splose; there's no additional fee for using Terminal. See Set up Stripe for the current rate.


Things to Note

  • The supported reader is the BBPOS WISEPOS E.

  • Payments taken on the Terminal settle through Stripe and update the matching splose invoice automatically.

  • Each Stripe location must correspond to a splose location (Settings → Locations) for the Terminal option to appear on that location's invoices.

  • When the client taps to pay, splose marks the invoice as Paid automatically; there's no separate payment to record and nothing to reconcile later.


Troubleshooting and FAQs

My reader is set up in Stripe but splose says "No terminal found"

Work through these in order:

  1. Check you created the location and registered the reader in the Stripe account connected to splose, not a standalone account. This is the most common cause. Use the account selector in the top left of the Stripe Dashboard to confirm which account you are in.

  2. Check the Stripe location name matches a location in splose under Settings, then Locations.

  3. Check the invoice you are paying is for that matching location.

  4. Check the reader shows as online under Readers in Stripe.

Did this answer your question?