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 bottom left hand side

STEP 3:

Now click on the API Keys menu

STEP 4:

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

STEP 5:

Now create a secret key by clicking on the + create secret key button to create a new key.

STEP 6:

It will ask you how you will be using the key, select "powering an integration you built"

STEP 7:
Stripe will need to do a verification, perform the verification and proceed to the next step 

STEP 8:

Once the verification is done, it will ask you to name the key, call it e-maktab or anything else so you remember what the key is for and click on crate. Copy the key as it will not be shown again and keep it somewhere safe (do not share this key with anyone else)

STEP 9:

Now click on the developers menu at the bottom left and click on webhooks menu  and click on + Add destination button on the top

STEP 10:

Click on "Your account option", leave the API version to what is selected by default.

Select events to listen: select the following events below under All events - 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 Continue button.

STEP 11:

Select the Webhook endpoint option and click Continue button.

STEP 12:

Fill in the form with the following information:

Destination name: leave what is auto-generated

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

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

Click on Create destination to complete the setup for webhooks

STEP 10:

On the next page you will see the newly created destination - click on the eye icon on the right hand side to revel the signing secret and copy this for our e-maktab integration.

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 authorising your parent to set up a Direct Debit so that you can start to collect payment. 

Parents can now start to enable the Direct Debit via the Parent Portal or the Admins can set up the Direct Debit for the parent when they visit the office.