OpenMasjid Docs
Home
GitHub
Home
GitHub

Stripe, for card payments

What you need

Time: 30 minutes, plus a day or two for Stripe to approve the account

  • Your masjid's legal name, address and bank account details.
  • Your charity or nonprofit registration number, if you have one.
  • A phone that can receive text messages.

Stripe takes the card payments. Your donation page and your kiosk both use it.

The account is your masjid's, not ours. The money goes from the donor to your Stripe account and then to your bank. It never passes through anything of ours, and we cannot see it.

What Stripe charges

Stripe takes a percentage of each payment. Their standard rate is published on stripe.com/pricing.

Step 1 — Create the account

  1. Open dashboard.stripe.com/register.
  2. Sign up with an email address the masjid controls, not a personal one.
  3. Fill in your masjid's details as the business.
  4. Add the bank account that the money must reach.
  5. Complete the identity checks Stripe asks for.
Result:

Stripe shows your dashboard. New accounts often sit in review for a day or two before they can take live payments. Test mode works immediately.

Step 2 — Copy your two keys

  1. Open dashboard.stripe.com/apikeys.
  2. Copy the Publishable key. It starts with pk_.
  3. Next to the Secret key, click Reveal, then copy it. It starts with sk_.

Step 3 — Put the keys into OpenMasjidOS

You do this once, in Settings. Not in each app.

  1. Open Settings, then Payments (Stripe).
  2. Click Add Stripe account.
  3. Put a name in Account name, such as Main Masjid.
  4. Paste the Publishable key and the Secret key.
  5. Leave Webhook signing secret empty for now.
  6. Click Save account.
Result:

The account appears in the list, marked secret key set. The secret itself is never shown again, which is correct.

More than one account

You can add several, each with its own name — Main Masjid, Building Fund, Zakat. An app then chooses which one a given appeal pays into, so Zakat money lands in the Zakat account rather than the general one.

Card readers

For a kiosk you also need a Stripe Reader M2. Stripe's own guidance is at docs.stripe.com/terminal. Pairing one is covered in Build a donation kiosk.

Checkpoint

Settings, then Payments (Stripe), lists your account and says secret key set.

If something goes wrong

What you seeWhyWhat to do
Paste the secret key.The secret-key field was left empty.Go back to the API keys page, click Reveal, and copy the whole key.
Donations succeed but no money arrives.The keys are test keys.Check whether the keys contain the word test. Turn off test mode in Stripe, then copy the live keys and save them again.
Stripe will not let the account take payments yet.The account is still in review, or a document is missing.Open your Stripe dashboard and complete whatever it asks for. Use test keys meanwhile.
On this page