L O A D I N G
ERPNext + Payments

ERPNext Payment Gateway Integration in the UAE: Get Paid From the Invoice

Send a secure payment link with every ERPNext invoice or order, record the payment the moment the card is charged, and match gateway settlements to your bank without spreadsheets.

Free consultation

Get a Free ERP Consultation

Tell us a little about your business. A consultant will reach out within one business day.

  • No obligation
  • Vendor-neutral advice
  • Your data stays private
Quick answer Updated October 2026 · Reviewed by UAE ERP Experts consultants

How do you connect a payment gateway to ERPNext to collect card payments in the UAE?

ERPNext payment gateway integration creates a Payment Request with a secure link for each invoice or sales order, sends it by email or WhatsApp, and posts a payment entry automatically when the gateway confirms the charge. Gateways in the Frappe Payments app configure directly; regional UAE gateways connect through a custom Frappe app using the provider's hosted payment page API and webhooks.

  • Hosted payment pages keep card numbers out of ERPNext, reducing PCI DSS scope.
  • A gateway clearing account reconciles gross receipts, fees and bank payouts.
  • ERPNext stores only the transaction reference and amount, not card data.
  • A single-gateway setup is often completed in a few weeks.

How ERPNext payment gateway integration works

ERPNext payment gateway integration in the UAE connects ERPNext invoices, sales orders and subscriptions with an online card payment provider, so customers can pay by card or wallet from a link and ERPNext records the payment automatically. For a Dubai consultancy chasing retainers, a training center collecting course fees or a B2B distributor offering card payment on overdue invoices, it removes the step where accounts waits for a screenshot of a transfer and posts the payment by hand.

ERPNext handles this with the Payment Request document and Payment Gateway Account settings. Since version 14, gateway code lives in the separate Frappe Payments app, which includes integrations for several international providers such as Stripe, PayPal and Braintree; the exact list depends on the version. Many UAE businesses use regional acquirers and gateways instead, and those normally need a custom Frappe integration against the provider's hosted payment page API. Either way, card data stays with the gateway; ERPNext only stores references and amounts.

This page is specific to ERPNext. For a comparison of approaches across platforms see ERP payment gateway integration in the UAE. Card payments taken inside an online store are covered on our ERPNext ecommerce integration page.

How ERPNext payment gateway integration works
  • Payment links generated from invoices, orders or payment requests
  • Payment entries posted automatically on a successful charge
  • Gateway fees and settlements reconciled against the bank
Official Apps

The ERPNext and Frappe apps behind this solution

The products we configure, integrate and support on projects like this one.

Product names and logos are trademarks of their respective owners and are shown only to identify the software we implement.

The Challenge

What breaks without a gateway link to ERPNext

Taking card payments is easy. Recording and reconciling them correctly in ERPNext is where UAE finance teams lose time.

Payment links created outside the ERP

Staff create links in the gateway portal and type the amount by hand. A link for the wrong amount or the wrong invoice is only discovered at month-end.

Payments posted late or twice

Accounts waits for the gateway email, then posts a payment entry. If two people see the same email, the payment is recorded twice and the customer statement is wrong.

Settlements that never match

The gateway pays out a net amount for many transactions, minus fees and sometimes refunds or chargebacks. Matching that single bank line to individual invoices is slow.

Fees hidden in receivables

When fees are not posted separately, small balances remain open on customer accounts, and bank charges are understated in the P&L.

Currency confusion

Customers pay in USD or EUR on an AED invoice, or the gateway settles in a different currency. Without rules, exchange differences land in the wrong account.

ERP Workflow

From invoice to reconciled payment

A standard flow for a UAE business sending card payment links from ERPNext.

  1. 1Sales invoice submitted
  2. 2Payment request with link created
  3. 3Link sent by email or WhatsApp
  4. 4Customer pays on gateway page
  5. 5Callback confirms payment to ERPNext
  6. 6Payment entry posted against invoice
  7. 7Settlement matched in bank reconciliation

One shared database: every step updates stock, finance and reports in real time.

What syncs between ERPNext and the gateway

Fields and triggers vary by provider; this is the map we start from.

What syncs between ERPNext and the gateway
DataDirectionTrigger / frequencyNotes
Payment request (amount, currency, reference)ERPNext to gatewayOn payment request creationReference ties the gateway transaction to the ERPNext invoice or order
Hosted payment page URLGateway to ERPNextImmediatelyStored on the payment request and sent to the customer
Payment statusGateway to ERPNextCallback or webhook on completionVerify the signature before marking anything as paid
Payment entryCreated in ERPNextOn confirmed successPosted to a gateway clearing account, not straight to the bank
RefundsERPNext to gateway, or recorded from gatewayOn approvalLinked to a credit note; refunds often need a manager approval step
Settlement reportGateway to ERPNextDaily or per payoutImported to split gross receipts, fees and VAT on fees
Bank payoutBank statement to ERPNextOn statement importClears the gateway clearing account in bank reconciliation
Chargebacks and disputesGateway to ERPNextWhen raisedReopens the receivable and alerts the account owner

Integration methods for ERPNext payments

We choose the method based on the gateway your bank or acquirer supports in the UAE.

  • Frappe Payments app (version-dependent gateway list)
  • ERPNext Payment Request and Payment Gateway Account
  • Stripe integration where Stripe is your provider
  • Custom Frappe app for regional UAE gateways via their APIs
  • Gateway webhooks with signature verification
  • ERPNext REST API
  • Settlement report import (CSV or API)
  • Bank statement import for reconciliation
  • Email and WhatsApp delivery of payment links
How It Works

How we implement it

A single-gateway setup is often completed in a few weeks; a custom regional gateway connector may take longer.

01

Confirm the gateway contract

We review which gateway and settlement terms you have, which currencies are supported and whether the provider offers a hosted payment page API and webhooks.

02

Design the accounting

We set up a gateway clearing account, a fees account and the VAT treatment of gateway fees, so every payout clears to zero.

03

Build or configure the connector

We configure the Frappe Payments app where the gateway is supported, or build a small custom app that creates payment links and processes callbacks.

04

Test every outcome

We test successful, failed, abandoned, partially refunded and charged-back payments in the gateway sandbox before going live.

05

Hand over reconciliation

We show the finance team the daily routine: import settlements, match payouts and review exceptions. Bank feeds can speed this up, as described in ERP bank integration.

UAE Compliance

UAE considerations for online payments in ERPNext

Confirm VAT and accounting treatment with your tax advisor; these are the points we configure for.

Card data stays with the gateway

Using hosted payment pages keeps card numbers out of ERPNext, which reduces your PCI DSS scope. ERPNext should only hold the transaction reference and amount.

VAT on sales and on fees

The customer's payment does not change the VAT on the original tax invoice. Gateway fees are a separate supply to you and may carry VAT on the provider's invoice, which can be recoverable input tax subject to the usual conditions.

Data protection

Payer names, emails and phone numbers are personal data under the UAE PDPL. Restrict access to payment logs and avoid copying gateway data into free-text fields.

Records and e-invoicing

Keep payment references and settlement reports with the invoice for at least the statutory retention period. E-invoicing from 2027 concerns the invoice, not the payment, so the gateway flow is unaffected; check the latest MoF/FTA guidance.

General information, not tax or legal advice. Rules change; confirm current FTA, MOHRE and Ministry of Finance guidance with your advisor.

Business Benefits

Benefits for finance teams

Typical improvements once payments flow straight into ERPNext.

Quicker collection

Customers can pay the moment they receive the invoice, instead of arranging a bank transfer.

No manual payment posting

Confirmed payments are recorded against the right invoice automatically.

Clean clearing accounts

Gross receipts, fees and payouts reconcile to zero each period.

Accurate customer balances

Statements reflect payments the same day, so collections calls are based on correct data.

UAE Compliance Built In

UAE regulations covered in every erpnext payment gateway integration uae project

We configure the system for the rules UAE businesses report against, and test it before go-live.

General information, not tax or legal advice. Confirm current requirements with the FTA, MOHRE or your advisor. See all UAE compliance guides.

Serving the UAE

erpnext payment gateway integration uae across all seven emirates

On-site workshops in Dubai, Abu Dhabi and Sharjah, and remote or on-site delivery across the Northern Emirates and free zones.

Official sources and references

Facts on this page were checked against these sources in October 2026. Rules change, so confirm current requirements before acting.

FAQs

ERPNext payment gateway FAQs

Still have a question? Our consultants are happy to help.

Ask an Expert
Which UAE gateways can ERPNext connect to?

Gateways supported in the Frappe Payments app can be configured directly. Regional UAE gateways can be connected through a custom Frappe app if the provider offers a hosted payment page API and webhooks, which most do. We check your provider's documentation first.

Can the payment link go out on WhatsApp?

Yes. The payment request URL can be added as a variable in an approved template, as described on our ERPNext WhatsApp integration page.

Do we need this if our store already takes card payments?

Store checkouts take payment inside Shopify or WooCommerce. ERPNext then needs to record and reconcile those payments, which is covered with the Shopify and WooCommerce connectors. A gateway link in ERPNext is for invoices raised outside the store.

Can customers pay part of an invoice?

Payment requests can be created for a partial amount, such as a deposit on a sales order. The remaining balance stays open on the invoice.

How are gateway fees recorded?

We post receipts gross to a clearing account and record fees from the settlement report to a bank charges account, so customer balances close fully.

Is recurring billing possible?

ERPNext subscriptions can generate recurring invoices with payment requests. Automatic card charging depends on the gateway supporting tokenized payments and on the connector, so we confirm it case by case.

Free Consultation

Let customers pay ERPNext invoices online

Tell us your gateway and billing process and we will design the payment and reconciliation flow.

Location

Dubai, United Arab Emirates

Free consultation

Send us your requirements

  • No obligation
  • Vendor-neutral advice
  • Your data stays private
Chat with an ERP expert