Stripe

The Stripe integration will enable your maktab/madrassah to collect student fees automatically, which means you do not need to worry about chasing parents for missed/overdue fees.

How Does it work

Once you have enabled stripe on your account you will need to send all or selected parent(s) an email with the link to authorise direct debit. Don't worry this email is also automated so there is no manual work.

The parent will click on the Authorise Direct Debit link in the email and this will redirect them to stripe. The parent will fill out the Bacs form (inputting their bank details).

Once the Direct Debit is set up the parent will automatically be created in stripe as a customer (saving you time) and the parent will be redirected back to e-maktab for confirmation. 

NOTE: *** Please do not use your Stripe account for donations, create a new account to collect fees. ***

A Stripe account is only required if you want to accept payments online through e-maktab. If you don't want to use this feature you don't need to create an account or enable this integration. 

Remember that Stripe will collect payment and usually there is a fee that Stripe will charge. e-maktab will not store any bank details nor we have any additional fees being added per transaction. 

To enable the Stripe integration please follow the steps below

Prerequisites: You MUST enable bacs_debit as payment method in your stripe account. Click on the link to view your payment methods  in stripe

STEP 1:

Login to your stripe account 

STEP 2:

Click on the Developers button on the top right hand side

STEP 3:

Now click on the API Keys menu on the left hand side

STEP 4:

Under the Standard Keys section copy the publishable key and keep it safe as this is needed later

STEP 5:

Now click on the Reveal live key button to revel your secret key - the key is only shown once so please copy this and keep it safe as we need this later. If there is no secret key click on the + create secret key button to create a new one.

STEP 6:

Now click on the webhooks menu on the left hand side and click on Add an Endpoint button

STEP 7: 

Fill in the form with the following information:

Endpoint URL: https://{subdomain}.e-maktab.co.uk/webhooks/stripe

Description: optional can be left blank or type "e-maktab integration"

Listen to: Events on your account

Version: leave this as the default

Select events to listen to: select the following events by clicking on the "+ Select Events" button you should have in total 12 events selected.

• charge.dispute.created
• charge.failed
• charge.refunded
• charge.succeeded
• checkout.session.completed
• customer.deleted
• mandate.updated
• payment_method.automatically_updated
• payment_method.attached
• payment_method.detached
• payment_intent.created
• setup_intent.succeeded

Once you have selected all the above, click on the Add Events button to add these.

STEP 8:

Click on the Add Endpoint button again to save the webhook settings.

STEP 9:

Click on the webhooks menu again and now click on the webhook which you just created in STEP 8

STEP 10:

Click on the Revel link under the signing secret and copy the long key and keep it safe as you will need this later.

STEP 11:

Login to e-maktab with an admin user

STEP 12:

Click on the Settings icon > Stripe

STEP 13:

Now paste the following keys that you copied earlier in the section.

- Public key is the publishable key

- Private Key (also known as Secret key)

- Webhook key is the key you coped in STEP 10

Once done click on the submit button to save the changes.

Congratulations! Stripe is now enabled for you. The next step is to start authorizing your parent to set up a Direct Debit so that you can start to collect payment. Please see below how to enable direct debit.

**NOTE: Parents MUST have a valid email for this to work.**

STEP 1:

Login into e-maktab

STEP 2:

Click on Parent menu under People

STEP 3:

Now select the parents who you want to sign up to the Direct Debit by clicking on the check box next to the name.

STEP 4:

Click on batch actions and select grant permission option, a modal will open up and then click on the give button. This will send an email to all the selected parents and in the email, there will be a button the parents will need to click on to set up the direct debit.

The next  step is, the parent(s) will receive an email. In the email there will be a  button the parent will click on to open up the form. The form will have details about the parent and their child(s) and there will be a button at the bottom of the form to authorised Direct Debit.

The parent(s) will need to click on the button and it will redirect them to the maktab's stripe page where they will  fill out their bank details to authorise the Direct Debit. Once done and successful, the parent will be created as a customer in stripe automatically and this will be linked to the parent record in e-maktab.