> ## Documentation Index
> Fetch the complete documentation index at: https://docs.dentolize.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Integration with online payment gateways 

> Let patients pay online with a payment link: set up Geidea, Paymob, MyFatoorah, Stripe or Fawry.

<iframe src="https://drive.google.com/file/d/1Sw81fUJEVGEbpncjX4LFKWv-K-EtJNo_/preview" className="w-full aspect-video rounded-xl" allow="autoplay" allowFullScreen />

With online payments, you send the patient a link to pay an invoice or diagnostic fee by card. The payment is recorded in Dentolize automatically.

<Note>
  Online payments are enabled for your clinic by Dentolize. If the tab shows **Feature Disabled**, contact support. Only the owner or an admin can set it up.
</Note>

## ⚙️ Set up

Go to **Settings → Integrations → Online Payments**, turn on **Active**, and click **New Item** to add a payment option:

<img src="https://mintcdn.com/dentolize/0xkKh_6AcHEODGpn/images/en/settings/online-payments-new.webp?fit=max&auto=format&n=0xkKh_6AcHEODGpn&q=85&s=9c2354c123b26c4f0bc0be12db975e5b" alt="New payment option" className="mx-auto rounded-lg" style={{ width:"60%" }} width="2016" height="1800" data-path="images/en/settings/online-payments-new.webp" />

* **Name** and **Payment Provider.**
* The provider's credentials (see below).
* **Extra Fees:** a fixed amount or % added to what the patient pays.
* **Received Treasury:** where online payments are recorded.
* **Show On Online Bookings.**

Then choose the **Default Payment Provider** and click **Update**.

## 🔑 Credentials and callback URL for each provider

In the provider's dashboard, use your **live** account and set the **callback URL** so payments are updated automatically.

| Provider | In Dentolize | Callback URL |
| - | - | - |
| **Geidea** | **Username** = Merchant Public Key, **Password** = API Password | `https://api.dentolize.com/geidea/onlinePayment` |
| **Paymob** | **Payment Integration IDs** (comma separated) and **Password** = API key | `https://api.dentolize.com/paymob/onlinePayment` |
| **MyFatoorah** | **Password** = API token | `https://api.dentolize.com/myFatoorah/onlinePayment` |
| **Stripe** | **Password** = Secret key, and the currency | `https://api.dentolize.com/stripe/onlinePayment` |
| **Fawry** | **Username** = merchant code, **Password** = security key | `https://api.dentolize.com/fawry/onlinePayment` |

<Warning>
  For **Paymob in Saudi Arabia (SAR)**, enter the Password as `username__password` (two underscores). Geidea works only with EGP, SAR or AED. There's no test mode: use your live keys.
</Warning>

### Paymob

In Paymob, make sure you're in **Live** mode. Copy the password from the settings, and the integration ID from **Developers → Payment Integrations**. Edit the integration to add the callback URL, then save.

<Frame>
  <img src="https://mintcdn.com/dentolize/7sMuutcBdREilBVN/images/paymob111.png?fit=max&auto=format&n=7sMuutcBdREilBVN&q=85&s=bf7bfc861ba6feeec0f4d47379c7a3c2" alt="Paymob settings" width="1904" height="853" data-path="images/paymob111.png" />
</Frame>

<Frame>
  <img src="https://mintcdn.com/dentolize/7sMuutcBdREilBVN/images/paymob2.png?fit=max&auto=format&n=7sMuutcBdREilBVN&q=85&s=871c357bb19dadbaa3a09923cd1b37da" alt="Paymob integration ID" width="1911" height="813" data-path="images/paymob2.png" />
</Frame>

<Frame>
  <img src="https://mintcdn.com/dentolize/7sMuutcBdREilBVN/images/paymob-3.png?fit=max&auto=format&n=7sMuutcBdREilBVN&q=85&s=e223e903caf5d49463d485ac1a74a61d" alt="Paymob callback URL" width="1887" height="798" data-path="images/paymob-3.png" />
</Frame>

### Geidea

In Geidea, make sure you're in **Live** mode. Copy **Configuration → Merchant Public Key** (Username) and **Configuration → Gateway API Password** (Password), and add the callback URL:

<Frame>
  <img src="https://mintcdn.com/dentolize/7sMuutcBdREilBVN/images/gedia2.png?fit=max&auto=format&n=7sMuutcBdREilBVN&q=85&s=421060dcc0ee1eb54201ee01935dd328" alt="Geidea callback URL" width="1597" height="898" data-path="images/gedia2.png" />
</Frame>

## 💳 Send a payment link

On an invoice, click **Generate Payment Link**. Check the amount, provider, and the patient's phone or email, then click **Submit**. Share the link or QR code with the patient, for example by WhatsApp.

When the patient pays, the payment is added to the invoice automatically (as a card payment, without the extra fees), and an open appointment is marked confirmed. Online payments are listed in **Logs → Online Payments**.

<Note>
  Refunds must be made in the provider's dashboard. Refunding the payment in Dentolize only records it.
</Note>