Worth Knowing!
If you're getting stuck in anyway at all with Stripe, please speak to us on web chat. We can be granted developer access to your Stripe account without compromising any personal information your side, and we'll happily take care of setting up webhooks, API keys and everything else.
If you're struggling, please don't! We're here to help, and it's free and included with your membership. Please jump onto web chat. Thank you!
Stripe is our recommended payment gateway for clubs. It's fast, easy to use, developer friendly and super flexible, with lots of extra functionality for you to invoice manually (for example) outside of the ClubManager by BMABA setup. Best of all, not only does it work well for e-commerce transactions in your Wordpress site (should you wish to open a kit store, for example) but it also allows for recurring, automatic payments from your ClubManager by BMABA Dashboard.
Here's how to activate it, and to set it up properly;
Setup A Stripe Account
If you haven't already got a Stripe account, you can sign up here. We recommend exploring the business and pricing from here first too.
Linking Up Your Test Account
We can't stress how important it is to setup a test mode in Stripe. It takes a few minutes longer than just the live payment option, and allows you the flexibility to fully transact as if you were a paying customer/student without worrying about any live payments.
Here's how it works;
1.) On your administrator dashboard (before you go into the ClubManager dashboard) in Wordpress, go to WooCommerce > Settings
Then go to the 'payments' tab in the settings;
On the payment screen, toggle Stripe Recurring at the bottom to 'ON' and then click 'MANAGE'.
To activate TEST MODE first of all tick the 'test mode' tickbox. Now, head to your Stripe dashboard at https://dashboard.stripe.com/dashboard.
On your Stripe dashboard, at the top right, toggle on TEST MODE. You'll see the browser turn orange and confirm test mode as being active.
At the top right of the screen, next click 'developers'.
Next, click API KEYS. This can be found at https://dashboard.stripe.com/test/apikeys.
Copy and paste the publishable key into that field in WooCommerce;
Next, click to reveal the Secret Key and repeat the same steps.
Now, just to go webhooks;
Next, we're going to take the pre-saved endpoint from your Stripe screen in WooCommerce. We're referring to this link here;
Head back to Stripe, and in the Developer console and then Webhooks, click '+ Add Endpoint'.
Then on the Webhook creation page, we want to copy over that 'Webhook URL' (mentioned above) which always follows the structure of 'https://yoursite.bmaba.club/wp-json/kf-stripe/v1/webhook', with the bold website URL of course being your actual website URL!
Next, select the following event categories;
> charge (13)
> checkout (4)
> customer (21)
> invoice (15)
> payment Intent (8)
This should show 61 events in total, per the below example.
Once you've completed this, you can SAVE CHANGES in WooCommerce. That's now the test keys and configuration complete.
Linking Up Your Live Account
To setup your live account, complete the exact same steps as above but just first toggle OFF the 'TEST MODE'.
Stripe will seamlessly move you from the TEST url to the NON-TEST url as you toggle the switch, meaning if you're looking at your API keys from https://dashboard.stripe.com/test/apikeys and you toggle off test mode, you'll go to https://dashboard.stripe.com/apikeys and so on.
Once you've setup your endpoint for the live mode and you've entered your list keys and secrets, you can save the settings and you're all set.
Troubleshooting, And Website Moves
If you change the URL of your site, for example by activating a premium domain (so yoursite.bmaba.club becomes yoursite.com) you'll need to update the webhook URL, by going to Developers > Webhooks > Edit and updating the URL, which will have updated automatically in your WooCommerce screen.
Previously (prior to September 2024) it was possible to have webhooks listen to all events, however this has now been curtailed so it's possible if an old webhook hasn't been updated, you need to refine the categories being listed to by the webhook per the above.
IMPORTANT: Updating Your WebHooks After 3.2.1
This is only relevant to clubs using ClubManagerbyBMABA prior to August 18th 2024 and having issues with automated renewals within Stripe Recurring Payments.
A very small number of our clubs experienced issues with automatic payments via ClubManager when using Stripe during the summer of 2024 (August). To remedy an update within WooCommerce API, we've released 3.2.1 as a patch.
There are two important things to consider if you're having issues with automatic payments;
YOU MUST UPDATE YOUR STRIPE WEBHOOKS
When you first setup your Stripe webhooks (per the above instructions) it will have been in the format of yoursite.bmaba.club/?wc-api=WC_Payment_Gateway or similar. We've now changed this to yoursite.bmaba.club/wp-json/kf-stripe/v1/webhook (with 'yoursite.bmaba.club' obviously being changed to reflect your actual website URL.You can copy and paste this from the Stripe Payment Setting screen under WooCommerce > Settings > Stripe Recurring – Card Payment. Head to Stripe, go to Developers > Webhooks and then edit the webhook URL. Save, and you're done. This will be the same as the steps mentioned above when setting up a webhook, so please have a look there for help.
You May Need To Manually Cancel & Restart Subscriptions
With the new webhook in place, you'll find the automated payments are properly picked up and duplicates are now eliminated. However, you may find what you need to do is manually cancel subscriptions that are running in Stripe and have your members sign up afresh to the subscription from ClubManager to re-instate the correct webhook URL if you continue to experience issues. This is super easy to do. Go to Stripe > Subscriptions, find your student and then click into their subscription. From there, you can cancel that so no further payments come out. Then, in ClubManager, the student just needs to sign up again for their membership and that will overwrite the old membership with a fresh (correct) membership which will fully resolve any issues.
If you're in any doubt about either of the above steps whatsoever, please reach out to us on webchat. Our team can do all of this for you without charge and rapidly. We can also help with questions or concerns, and support making cancellations in Stripe if needed.