Stripe Direct Debit Module

• Installation Guide

  1. Extract the Files:

     • Unzip the stripe_becs_module.zip file.

  2. File Placement:

     • Move the stripe_becs.php file to the modules/gateways/ directory.
     • Place the stripe_becs/ folder inside the modules/gateways/ directory.

  3. Admin Panel Configuration:

     • Log in to your WHMCS admin panel.
     • Navigate to Setup > Payments > Payment Gateways.
     • Select Stripe BECS from the list and enter your API keys and other required settings.

  4. Additional Setup:

     • After installation, access the WHMCS admin dashboard.
     • Locate the Stripe BECS Configuration widget.
     • Click Step 1 to create the necessary custom fields for the module.
     • Click Step 2 to automatically generate the Stripe webhook.
     • Save your configuration, and the gateway is now ready to use.

  Features

  • Supports Stripe BECS payments.
  • Fully compatible with WHMCS version 7.4.8.2 and above.

Video Content Transcript:

00:00
In this video, I'll show you how to integrate the Stripe BCS payment gateway into your WHMCS installation. Let’s get started.

After purchasing the module, you'll receive a file like this. To begin, go to your WHMCS installation, then navigate to Modules > Gateways. Click Upload, then drag and drop the file into the upload area. Wait a moment, then refresh the page. Find the zip file and extract it. That's it.

01:22
Now, move to the WHMCS admin panel and enable the module. As you can see, there's no Stripe BCS option yet. Go to Setup > Integrations and search for "Stripe BCS". The module should appear—click Activate.

Once activated, you’ll need to configure a few settings. Start by entering your API key. After purchasing the module, contact support via email, and they will provide you with the API key for your domain. Let me copy that here.

If you want to enable Stripe's test mode, check the box for Test Mode and enter your test credentials.

You can also set a limit for the number of users you want to update in bulk to create Stripe customers. If you set this number higher than 200, it will default to 200 as the maximum.

Next is the Disclaimer Text, which will appear under the payment form. For example, you can add your company name here—mine is "B Coding".

If you want the cron job to run automatically, check the box for Stripe BCS Cron Job. Read the prompt for more details, then click Save Changes.

03:25
Now, go to the admin dashboard. You should see the Stripe BCS configurations section. Click the first button to create the required custom fields. Once that’s done, you’ll see a confirmation message.

The next step is to configure a webhook in your Stripe account. At the moment, there isn’t a webhook set up, so let’s create one. Click the button to add the webhook, then refresh your Stripe account. You should now see the webhook listed.

That’s it for the setup. Everything else is optional—such as manually creating Stripe BCS customers. However, most tasks are automated, so you won’t need to do this manually.

05:12
If you need to create a Stripe BCS customer manually, simply enter the customer ID and click Submit. This will create a Stripe BCS customer ID for that user.

Now, let’s test the payment system. Go to Clients and create an invoice. Then, go to the client profile, log in as the customer, and pay the invoice using the Stripe BCS payment method.

06:23
Once logged in as a customer, you’ll see the invoice you just created. Change the payment gateway to Stripe BCS. The payment form will appear, along with the disclaimer text you set earlier.

Enter the test account details and submit. The payment status will be Pending. We now need to wait for the webhook to trigger.

07:15
Once the webhook is triggered, the payment status will update to Paid. Refresh the invoice page to see the status change.

Regarding the cron job, it will run automatically as part of the WHMCS system cron jobs.

That’s all. If you need further assistance, feel free to contact me via email or WhatsApp.