Donation appeals on the website

Ask the public for help with building work, relief or families in need. After the Wisdom Masjid team approves it, your appeal shows on the website under Give to a cause, and anyone can give online by Razorpay.

What it does

Appeals (More → Appeals) is for masjid admins. It needs the Events, Donations & Expenses module.
Gifts are paid into your masjid’s own Razorpay account and Razorpay settles them to your bank. Add the account first in Settings → Online payments.
Each gift is recorded as an online donation, in the account Online payments (Razorpay), with your normal donation receipt. The receipt names the appeal and shows Paid by Online (Razorpay) with the Razorpay payment id. It shows in Donations, Accounts and reports. If you link the appeal to an event, gifts also count in that event.
Statuses: Draft, Waiting for approval, Live, Not approved (with the reason) and Closed. A closed appeal stays on the website as finished but takes no more gifts.
A live appeal can be improved (text, picture, target, end date) without a new review. While it is waiting for approval it cannot be changed.
The website shows the amount raised, the number of donors and recent gifts. Donors who tick Hide my name show as Anonymous; you still see their name in Gifts.

Connect the masjid’s Razorpay account

In the Razorpay dashboard, open Account & Settings → API Keys and create a key. Copy the Key Id and the Key Secret.
In the app open Settings → Online payments.
Paste the Key Id (it starts with rzp_live_ or rzp_test_) and the Key Secret.
Recommended: in Razorpay, open Webhooks, add the webhook URL shown in the app, choose the events payment.captured and order.paid, and type a secret. Paste the same secret into Webhook secret in the app.
Tap Save and check. The app asks Razorpay if the keys work and shows Connected.

The secrets are stored encrypted and never shown again. Leave them empty when you save again to keep them.

Start an appeal and send it for approval

Open Appeals and tap +.
Enter the Title (and Malayalam), the Kind, the Target and, if it should stop on a date, Ends on.
Optionally choose an event under Count gifts in project.
Write a Short summary (one or two lines) and The full story: what it is for, how much is needed and how the money will be used. Add a Cover picture.
Tap Save. It is saved as a draft.
Tap Send for approval. The Wisdom Masjid team checks it; when approved it goes live on the website.

If it comes back Not approved, read the reason, tap Edit, fix it and send it again.

See gifts, share and close an appeal

On a live appeal, tap Gifts to see who gave, how much, when, their message and the receipt number.
Tap Open to see the public page, and share its link on WhatsApp from there.
When the work is done or the target is reached, tap Close.

Questions

Who gets the money?

Your masjid, directly, through your own Razorpay account. Wisdom does not hold it.

How is a refund made?

In your Razorpay dashboard. Then cancel the matching donation in Donations so your books match.

A donor paid but I do not see the gift.

With the webhook set up, it is recorded within a few minutes even if the donor closed the page. Check that the webhook URL and secret in Razorpay match Settings → Online payments.