Connect Stripe / Migrate Customers
Connect Stripe
Stripe is a 3rd party payment processor that integrates with Momence to take payments from your customers. It gives them the option to save their card on file and sends payments from Momence to your stripe account.
To integrate Stripe, in Momence click Settings > Administrative > Get Paid > click Connect Stripe > create a new account (you cannot use an existing account for this step).
Stripe helps expedite the new account creation: After selecting 'Create new account', if you've previously used Stripe, you'll see an option create a new account using your existing accounts details.
Select the corresponding business details and click "Continue".
On the last screen, verify your details are correct, and click on "Agree and submit". Your new Stripe account is now connected and ready to process payments.
If you have customer data in your old Stripe account that you'd like to migrate, refer to 'Migrating Stripe customer data' in this article.
Why do I need a new Stripe account?
Attempting to connect a stripe account that you previously used with an older platform will result in a message that basically says: "we don't have the permissions we need to provide you payment services."
When you switch platforms, Stripe requires a clean slate. Creating a new account takes just a few minutes and won't affect your payments and renewals.
If you have customer data in your old Stripe account that you'd like to migrate, follow the process outlined in the section below titled 'Migrating Stripe Customer data to your new Stripe account.'
Order a Stripe Reader
Momence POS is compatible with Stripe's BBPOS WisePOS E device. To order a card reader, click here https://dashboard.stripe.com/terminal/shop > select the BBPOS WisePOS E device > add to cart > and, using the 'cart' icon (top right), checkout.
Set up a BBPOS WisePOS E Card Reader
Install/charge the battery
Remove the cover. A house key or small coin may help. Slide battery into the exposed slot with gold connectors aligned. Charge the reader.
Power on the device. Even when its not in use, leave the BBPOS Wise POS E plugged in and powered on to receive automatic software updates.
Register your reader with Stripe
Follow these directions: https://docs.stripe.com/terminal/payments/connect-reader?terminal-sdk-platform=server-driven&reader-type=internet
Connect the reader to the internet
Select Settings > Wifi Settings > choose the network and connect
Stripe has 2 wifi requirements to enable this device:
Your WiFi network must use WPA-Personal or WPA2-Personal encryption and be password protected.
Both your computer and the reader must be on 2.4 GH wifi.
To check your computer's current GH setting, hold the Option/Alt key and click on the Wi-Fi icon. This will give you information on your Wi-Fi including the channel your Wi-Fi is using right now.
If you are currently on 5GHz and need to switch to 2.4GHz, this change must be made from the router.
Pair it to Momence POS
In Momence, click Home > Point of Sale > Actions > New Card Reader > Choose a location & name the card reader
On the BBPOS device, from the left edge of the screen, swipe right to reveal a settings button -- Tap it and enter the admin PIN 07139
Under Admin Options, tap 'Generate a pairing code' for device registration > enter the newly generated code into the Momence section titled Registration Code, then click 'Confirm registration'.
On the BBPOS device, click the back arrow in the top left corner to exit.
Test the connection
If the device is connected to your network, Momence POS will detect and display the reader when a card is used for payment.
To view that its connected, click Home > Point of Sale > add an item to the cart > then under the Payment section at the bottom, select Card Reader > Open Card Reader.
Having trouble or seeing an error? See our 'troubleshooting' section in this article.
Migrate Stripe customer data to your new Stripe account
To migrate your customers data from your old Stripe account to the new one to keep your renewing memberships running, Momence support will assist you to prevent disruption to recurring charges.
1. Create a new Stripe account / copy your destination account ID
Create your new stripe account using the directions listed earlier in this article. Then locate your destination account ID in stripe from settings > account details.
It should appear in the top right as something like acct_xxxx. Copy this ID.
Note: at the end of this process we'll need you to email Momence support with both your old ID and your new ID. So paste this new ID somewhere safe that you can refer to later. Label it 'new' so you know which one it is.
2. Migrate your customers data
Log out of your new Stripe account > Log into your old one > navigate to Customers > click copy > select 'copy all customers'.
A pop up should read 'Enter recipient's account ID.' Paste that account id you copied earlier into the account ID field > click Continue and confirm the request.
Before you log out, grab your old Stripe account ID from settings > account details. Copy and paste this old ID next to the new one and label it 'old.'
Log out of the old stripe account. Log back into the new one. Navigate to 'Customers.' You'll see a banner to authorize the reception of the customer data. Click "Authorize and accept".
The data migration may take up to 72 hours, although it's generally completed in a matter of minutes, depending on the number of customers. Once it's complete, you'll see a green banner with a link to view a mapping file.
Click the link and download the mapping file.
3. Reach out to support to finalize the import
Email [email protected] and attach mapping file. In your email, list both your old Stripe account ID, and the new one.
We'll take it from here and notify you when the transfer is complete. All your payments and renewals will then be loaded to your new Stripe account, allowing us to create reports for you.
Connect Multiple Bank Accounts to One Dashboard
Connecting multiple bank accounts to one Dashboard is helpful if:
Your business has several momence accounts and you want to consolidate them into one dashboard; or
You have all your locations in one dashboard and want to segregate funds for each location's sales.
Note: Stripe requires you create a new Stripe account from your Momence dashboard for each separation. We cannot connect a pre-existing Stripe account to Momence.
How do I set up multiple bank accounts?
Create a new Stripe account from your Momence Get Paid page (in Momence, click Settings > Get Paid > Connect Stripe > create the new Stripe account). Repeat for as many Stripe accounts as are needed.
Send an email to [email protected] with your Stripe account IDs (found in each Stripe account under Settings > Account Details), and the corresponding Momence location it should be linked to.
For example:
Granada - acct_sdkwmer1fdfgs
Madrid - acct_poifgm87adsfg
Support will confirm once connections are finalized and include next steps.
Why use multiple bank accounts?
Using multiple bank accounts allows you to use one Momence dashboard for all of your operations while routing payments into multiple bank accounts. The most typical use case for this is when you have multiple physical locations which each have their own unique business entity or owner. In this case, connecting multiple bank accounts to one Momence dashboard will allow you to route payments into the bank account associated with each respective location. This will save you time and money on end-of-period accounting and ensure that each business entity always receives the funds it should receive.
Using one dashboard when having multiple business entities is advisable if all of your locations operate under the same brand. For instance, using one dashboard allows you to offer one version of an Unlimited membership that can be used across all — or some — of your locations without needing to duplicate it or manage it in separate dashboards. If your business operates as a franchise, using one dashboard isn’t advisable; please get in touch with us about access to the Corporate dashboard.
Currently, we only allow multiple bank accounts to be used with Stripe as the payment processor. Since Stripe only allows you to connect one bank account per Stripe account, the first step is to create a unique Stripe account for each of your business entities. Creating a Stripe account is free. Once you have a Stripe account created for each of your business entities, you can then connect each Stripe account to your Momence dashboard. If you don’t see the option to connect multiple Stripe accounts in your dashboard, please reach out to [email protected] to have it connected.
Customer home locations
A customer home location is the location that a given customer belongs to, allowing you to send marketing messages and filter reports by home location. You can enable home locations under Settings > Locations > Location settings > Enable home locations.
Customer home locations play an important role in routing payments to the multiple bank accounts that are connected to your Momence dashboard. More on this later in this article, but in order to be able to connect multiple bank accounts to one Momence dashboard, you need to enable customer home locations and required customers to select a home location when new customer accounts are created. This will ensure that each of your customers has a home location assigned to them, thus allowing each of your payments to be routed correctly for online purchases.
When connecting a new Stripe account to your Momence dashboard, you will be asked to indicate which Home location the given Stripe account belongs to. Ultimately, this is where you indicate which bank account belongs to a given location.
How payments get routed
Once you have multiple bank accounts connect to your Momence account and support for multiple bank accounts has been enabled in your Momence dashboard, payments will be routed to the appropriate Stripe accounts as follows:
When making a sale through the Point of Sale, you will be asked to indicate which location you are making the sale from. All sales from the Point of Sale will be routed to the Stripe account that belongs to the selected location. Note that you will only be able to select from Home locations.
Purchases that are made by customers online for classes (including payment plan payments), appointments and retail products that take place at a home location will be routed to the Stripe account that belongs to the given location.
All other purchases that are made by customers online will be routed to the home location of the customer. The most popular case for this is when a customer purchases a membership online: the purchase of the membership and all subsequent renewals will be routed to the Stripe account connected to the customer’s home location
If Momence isn’t able to determine a specific Stripe account to route a particular payment to, the default Stripe account that is connected to the Momence dashboard will be used.
Managing payment methods on file
When using multiple bank accounts it is important to remember that each payment method that is stored on file for a customer belongs to the home location where it was created. This means that, for instance, if a customer makes an in-person purchase at Studio A, their card on file will be accessible when making subsequent sales at Studio A. Conversely, the card will not appear on file when making sales at Studio B, unless the customer adds the card on file themselves or makes a subsequent purchase at Studio B. This is important to remember when changing the home location of a given customer. You will see an alert if you are at risk of running into an issue with the payment method on file management while changing a customer’s home location.
Reporting
You are able to filter all of your sales reports by Home location. When filtering a sales report by Home location, you will see all the sales made by customers who belong to that Home location. Note that this is distinct from filtering sales reports by Location, which instead shows all the sales that were made for classes and appointments that belong to that given Location.
You will also be able to run a report that indicates which Bank accounts individual sales have been routed to in the Bank account reconciliation report.
Troublshooting
Terminal Connection Issues with Momence POS
The following suggestions cover the most common issues that may prevent your Terminal from connecting when launching the Momence POS:
Ensure Network and DNS Settings Are Correct
Make sure your device is connected to the same Wi-Fi network as the card reader.
Set your device’s DNS to 8.8.8.8 as the only DNS server (use 8.8.4.4 only if a secondary is required).
If you’ve just changed your DNS settings, clear your browser’s cache and cookies, then quit and restart the browser.
Here’s how to change DNS on macOS:
How to Clear Cache on Google Chrome:
Open Chrome.
Click the three-dot menu in the top-right corner.
Go to Settings > Privacy and security > Clear browsing data.
Select All time for the time range.
Check Cookies and other site data and Cached images and files.
Click Clear data.
Quit and reopen the browser.
Wi-Fi Frequency
Your router and computer should both be on a 2.4 GHz network.
How to Check Your Wi-Fi Band:
On a Mac:
Hold Option/Alt and click the Wi-Fi icon in the top menu bar.
Check the channel information for “2.4 GHz” or “5 GHz.”
On Windows:
Connect to your Wi-Fi network.
Open the network panel from the taskbar.
Click “Properties” for the connected network.
Scroll to “Properties” and check “Network Band.”
Using Wi-Fi Boosters?
If you're using a booster, make sure its frequency matches the router’s. If they differ, the Stripe POS device may not work properly.
Allow List Requirements
Stripe Terminal requires that both the POS application and the card reader can access certain domain names. These must be allow listed on your network.
You can also restrict your router to specific devices by adding their MAC addresses to the Access Control list. This can usually be found by logging into your router (e.g., Xfinity) and checking the Security or Network settings.
----
After trying the above, if you continue to experience issues, email [email protected] with a description of the issue and what you've tried. Listing what you've tried will help our team narrow down possible causes, and expedite a solution for you.
Change DNS on MacOS to resolve login & page view issues
If you're on a mac and having login issues, first make sure you've attempting resetting your password before trying this.
Sometimes, your Internet Service Provider's DNS can be faulty momentarily, preventing you from performing actions on Momence such as logging in or visiting certain pages.
DNS stands for Domain Name System, and it's like the phonebook of the internet. For every site you type into your browser, your computer needs to find the IP address for that domain name so it can connect to the website's server. DNS servers are responsible for translating these domain names into IP addresses.
When a DNS has trouble finding the IP address, it results pages not displaying on your end.
There's a remedy for this faulty behavior. Google offers a public DNS service that you can use instead of your Internet Service Provider's (ISP) default DNS servers. Here's a few more reasons to consider using Google DNS: Faster Browsing, improved privacy, and increased security.
To change your MacOS settings to use Google DNS, you'll need to follow these steps:
Open System Preferences by clicking on the Apple menu in the top left corner of your screen and selecting "System Preferences" > Click on "Network".
Select your active network connection from the list (it will typically be labeled Wi-Fi or Ethernet) > Click on the "Advanced" button in the bottom right corner > Go to the "DNS" tab.
In the DNS Servers section, click the "+" button and add the following Google DNS addresses: 8.8.8.8
and 8.8.4.4
. > Click "OK" and then "Apply" to save your changes.
Your MacOS device will now use Google DNS for resolving domain names.
Payment FAQ's
Did you take payments before you connected Stripe? Here's how to request funds
Sometimes transactions are made in Momence before you connect your Stripe account. These early transactions will not make their way into your Stripe account and are held in escrow with Momence.
To check to see if you have funds to transfer, and allow us to transfer these funds your way, send the following to [email protected].
Subject: Escrow request
Host ID:
Legal Account Name:
Bank Type (Business/Personal):
Routing Number/ABA Number:
Account Number/ IBAN Number:
BIC/SWIFT (if applicable):
Sort Code (if applicable):
Beneficiary Address:
Please allow a couple of business days to process the request.
Where can I find my host ID?
From your Momence dashboard, copy the number you see in your browser bar. Its listed right after dashboard/.
When can I expect to receive my payouts?
Stripe's restrictions on payout timing can vary based on the country you’re operating in. In most cases, when you start processing payments from your customers, you won’t receive your first payout until 7–14 days.
The first payout may take longer for a number of reasons, including your country or being in a high-risk industry. Processing subsequent payouts then happens according to your account’s payout schedule. You can read more on the Stripe documentation about Receiving Payouts.
Where can I see my payouts?
A list of all of your payouts and the date that you can expect to receive them can be found in your Stripe Dashboard.
I received some payments before connecting Stripe, how do I receive these funds?
If you processed payments before connecting Stripe, we will need to issue a payout for this amount to your bank account. Reach out to [email protected] with the following:
Your legal name on the bank account
Bank Type
Routing Number/ABA Number
Account Number/ IBAN Number
BIC/SWIFT (if applicable)
Sort Code (if applicable)
Your Address
View Fees Charged in Stripe
To view fees assessed, log into Stripe > from the dashboard, click "Payments" > Locate the Desired Transaction (Scroll through the list of transactions or use the search and filter options) > Click on the transaction to open its details.
Within the transaction details, you'll find a breakdown of various components, including the amount, currency, and customer information, and a detailed breakdown of fees associated with the transaction.
Common fees include processing fees, international fees, and other applicable charges. The fee breakdown will include both fixed fees and percentage-based fees. Processing fees are standard and are charged for the service of processing the payment. International fees may apply if you're dealing with customers from different countries. Be sure to familiarize yourself with the specific fee types relevant to your business.
For a more comprehensive analysis, consider exporting the fee information. Stripe allows you to export data in various formats, such as CSV or Excel. This can be particularly useful for accounting purposes or in-depth financial analysis.
Payments for business in Indonesia
If your business is based in Indonesia, you won't be able to create a Stripe account to process your payments through Momence. In order to allow businesses in Indonesia to process payments through Momence, we've partnered with Xendit.
Connect Momence to Xendit:
Enable all payment methods on the Xendit end. This link explains how.
When finished, email [email protected] and we'll finalize the setup.