Connecting Paymob for card payments

What you need

• An active Paymob merchant account (sign up at paymob.com)
• Your Paymob API Key, Integration ID, and HMAC Secret

Finding your credentials in Paymob

1. Log in to accept.paymob.com.
2. API Key: Settings → Account Info.
3. Integration ID: Developers → Payment Integrations → select your channel (Card, Wallet, etc.).
4. HMAC Secret: Developers → Webhooks.

Connecting in Clinit

1. Go to Settings → Payments → Paymob.
2. Paste your API Key, Integration ID, and HMAC Secret.
3. Click Test Connection — you should see a green ✓.
4. Toggle Live Mode on.
5. Click Save.

Accepting a payment

1. Open a completed appointment or invoice.
2. Click Collect Payment → Card / Paymob.
3. Enter the amount and click Send Payment Link.
4. The patient receives the link on WhatsApp — they tap and pay on Paymob''s hosted page.
5. The invoice updates to Paid automatically via webhook.

Supported payment channels

• Visa / Mastercard / Meeza (national debit)
• Mobile wallets: Vodafone Cash, Orange Money, Etisalat Cash
• Fawry (over-the-counter)
• ValU and Sympl (instalment financing)
• InstaPay

Troubleshooting

"Test connection failed" — Check for spaces before or after your API key.

Webhook not updating the invoice — In Paymob''s developer settings, add the Clinit webhook URL: https://doctor.clinit.app/api/clinic/billing/paymob/callback.