Skip to main content

MyFatoorah

MyFatoorah is a payment gateway for the Middle East. Connecting it lets your clients pay invoices, bookings, plans and store orders with KNET, cards, Apple Pay and the other methods enabled on your MyFatoorah account. You need an API key and a webhook secret key from MyFatoorah, and you choose the country your MyFatoorah account is registered in.

Available withBookings or SalesIncluded in the Complete plan.Plans and modules

Before you start​

  • You need the Administrator or Owner role.
  • Have a live MyFatoorah vendor account. Supported countries: Kuwait, Saudi Arabia, Bahrain, UAE, Qatar, Oman, Jordan and Egypt.

Connect MyFatoorah​

  1. Go to Settings > Finance > Payment Gateways and click Configure MyFatoorah. The MyFatoorah Configuration page opens.

    You can also click Connect on the MyFatoorah card in Settings > Integrations.

    The Integrations page with the MyFatoorah card highlighted
MyFatoorah Configuration form with API key, vendor's country and webhook key, and the Webhook Settings card with the webhook callback URL
  1. In your MyFatoorah account, go to Integration Settings > API Key and click Create to get an API key.
MyFatoorah portal API Key page under Integration Settings with the Create button
  1. Paste it into MyFatoorah API Key in Whautomate.
  2. Choose your Vendor's Country. It must match the country of your MyFatoorah account.
  3. In the Webhook Settings card, click Copy next to Webhook callback URL.
  4. In MyFatoorah, go to Integration Settings > Webhook Settings and:
    1. Enable Webhook.
    2. Paste the Webhook URL.
    3. Enable Secret Key and generate a Webhook Secret Key.
    4. Select the Transaction Status Changed webhook event.
    5. Click Save.
MyFatoorah portal webhook settings with webhook enabled, URL pasted, secret key enabled and Transaction Status Changed event selected
  1. Copy the webhook secret key from MyFatoorah and paste it into MyFatoorah Webhook Key in Whautomate.
  2. Click Save. You see "MyFatoorah Gateway settings saved. Please make sure to configure your webhook."

Test it​

  1. Create a small invoice for yourself, tick Request payment via WhatsApp and click Save and Send.
  2. Open WhatsApp and tap Make Payment.
  3. Select a payment method, click Pay and complete the payment.
MyFatoorah payment page where the client selects a payment method and clicks Pay

The invoice changes to Paid once MyFatoorah sends the webhook.

Update or disconnect​

  • Click Edit Configuration, change the values and click Update.
  • Click Disconnect MyFatoorah and confirm to stop taking payments with MyFatoorah.

Troubleshooting​

  • Invoice stays Sent after payment: check the webhook is enabled with the Transaction Status Changed event and that the webhook key in Whautomate matches.
  • Payment page error: check the Vendor's Country matches your MyFatoorah account. MyFatoorah issues separate keys per country.
Last updated on