Fix payment links, deposits and Stripe payments
Loading progress…
Payment link not delivered or deposit stuck on Pending? Open the booking, go to the Payment tab, press Send Payment Link and read the Email and WhatsApp lines under the button.
Outcome
You know why a payment link was not delivered or a deposit shows Pending, and what to do next without sending a refund through Mawidi.
Last reviewed
2026-10-24 · Support
Before you begin
- Owner or admin access. Only owners and admins can send payment links, mark a booking paid, change Payment Settings or decide on a deposit.
- A booking that has a deposit amount and is not yet paid.
Open the right workspace
- 1Sign in and open Dashboard.
- 2Choose Appointments from the dashboard navigation.
- 3If the item is not shown, ask an owner to check your access and the account package.
Fix a payment link that was not delivered
- 1Open the booking and select the Payment tab. The status shows Paid or Pending; if it shows Pending and a deposit amount, use the Send Payment Link button (owners and admins only).
- 2Press Send Payment Link. Mawidi tries the customer's email and your connected WhatsApp together, then shows one line for Email and one for WhatsApp under the button.
- 3Read each line. "Submitted for sending; delivery is not yet confirmed" means the provider accepted it, not that the customer received it. "Could not submit" or "skipped" means nothing went on that channel.
- 4When any channel did not go through, a link appears with Copy link and the note "You can share the payment link manually". Copy it and send it to the customer yourself.
- 5If the customer pays in cash instead, use Mark Paid (تم الدفع) on the booking so it stops showing Pending.
Connect the Stripe account that receives your customers' payments
- 1Customer payments go to your own Stripe account, not to Mawidi. Open Settings, then the Payment Settings tab (إعدادات الدفع), owners and admins only.
- 2Under Configure Keys, enter the Secret Key and the Publishable Key from your Stripe Dashboard (Developers, API keys), then press Save Keys. The page shows Live Mode or Test Mode.
- 3Webhook Secret is optional: Mawidi creates the webhook when you first send a payment link if your Stripe key allows it. If not, paste the signing secret from your Stripe Webhooks page into that field.
- 4Test keys only open test checkouts and charge no real money. Switch to live keys before asking real customers to pay. Payouts to your bank are handled by Stripe inside your own Stripe account.
- 5Never send your Stripe keys to Support or in a chat; enter them only in this form.
Decide on the deposit of a cancelled booking
- 1When a booking with a paid deposit is cancelled, the booking shows "Deposit awaiting your decision" and nothing is refunded automatically. Mawidi does not issue refunds to your customers.
- 2If you decide to return the money, do it from your own Stripe account (or the way you received it, for a deposit recorded as paid outside Stripe).
- 3Then press Keep deposit or Refunded or handled outside Mawidi, and press Confirm. The booking keeps a label with your decision.
Fix the Payment Required screen
- 1The full-screen "Payment Required" message is about your own Mawidi subscription, not about a customer payment. Press Pay Now and complete the secure Stripe checkout for your plan.
- 2Admins and staff do not see this screen; the account owner has to pay. See Billing for invoices and plan details.
Set up the WhatsApp payment link template
- 1Open WhatsApp, press Twilio & webhook settings, and scroll to "WhatsApp payment link template". The section is visible only to people allowed to manage the sending number.
- 2A payment link goes as an approved template when the customer has not written to you recently. Create a body-only Utility template in your WhatsApp account in the same language, with no header or buttons and all six variables shown in the sample.
- 3Choose the language, enter the template locale and the template ID (Twilio Content SID, or the Meta template name and WhatsApp Business Account ID), then press Verify and save. You should see "Approved template saved".
Check before contacting Support
- 1Write down the booking reference or customer name, the time you pressed Send Payment Link, and the exact Email and WhatsApp lines shown.
- 2Say whether Settings, Payment Settings shows Live Mode or Test Mode. Do not include keys, card numbers or passwords.
How to know it worked
- • The customer received the link, or you shared the copied link, and the booking moves from Pending to Paid after payment.
If something goes wrong
- Send Payment Link button is missing or refused: it is for an unpaid booking with a deposit amount, and only owners and admins can send. Check the Payment tab shows Pending and a deposit, and ask an owner if you are staff.
- Email: No customer email address, or Customer email address is invalid: add or fix the email on the booking and press Send Payment Link again, or copy the link and share it yourself.
- WhatsApp: An approved WhatsApp payment template is required: save an approved Utility template under WhatsApp, Twilio & webhook settings, WhatsApp payment link template, or copy the link and share it manually.
- WhatsApp: Customer phone is missing or invalid: correct the phone number with its country code on the customer's booking, then send again.
- Channel is not connected. Check settings: for WhatsApp, finish the connection in the WhatsApp tab; for Email, or if WhatsApp already looks connected, tell Support. Meanwhile use Copy link.
- Submitted for sending; delivery is not yet confirmed, or Sending outcome unknown: do not resend at once. Ask the customer to check spam, wait, then use Copy link if nothing arrived.
- Stripe is not connected or Stripe rejected your account's API key: open Settings, Payment Settings and save valid keys again (Update Keys); the message mentions Settings, Payments. Only owners and admins can do this.
- The previous payment is still pending, or Checkout has finished but payment is not yet confirmed: wait, then check the payment in your Stripe dashboard before sending another link or marking it paid.
- Customer says they paid but the booking still shows Pending: do not mark it paid or send another link. Refresh the booking, check Stripe, and if Stripe shows the payment but Mawidi does not, tell Support the booking reference and time.
- A customer asks for their deposit back: Mawidi never refunds customers. Refund from your own Stripe account if you choose, then record your decision on the booking with Keep deposit or Refunded or handled outside Mawidi.
- Deposit decision: "Your decision could not be saved" or "This deposit can no longer take that decision": refresh the page, check the label now on the booking, and retry only if it still shows awaiting your decision.
- Payment Required screen keeps appearing: it concerns your Mawidi subscription; the owner presses Pay Now and completes checkout. Admins and staff cannot clear it. Tell Support the time and the plan shown if the owner already paid.