ZenotiHelp

Processor: Qnb

ZTZenoti Docs Team Updated September 5, 2026 3 min readGuide

QNB is a V1 payment processor configured at the center level. It supports online card transactions for Middle Eastern (Qatar and surrounding) markets via QNB's hosted payment page with SHA-based request signing.

Before you begin

Permission: Center-level payment configuration access is required.

QNB merchant-side prerequisites

  • Active QNB merchant account activated for your country and currency.
  • Per-scheme activation — Visa, Mastercard, and regional schemes enabled per MID (Merchant Identifier).
  • Return URL allow-list — share the Zenoti return domain with QNB.

Credentials

Field Source / owner What to enter
Merchant ID QNB merchant portal / account representative The MID.
Merchant password QNB merchant portal Used to sign the outbound request hash. Treat as sensitive.
Store name QNB merchant portal Store / outlet identifier shown on the hosted payment page.

Network requirements

Direction Port Protocol Why
Outbound from Zenoti to QNB API 443 HTTPS Charge, refund, status
Outbound from guest browser to QNB HPP (Hosted Payment Page) 443 HTTPS Hosted payment page
Outbound from QNB to Zenoti 443 HTTPS Post-payment callback

QNB capabilities in Zenoti

Capability Supported
Online card payments (HPP) Yes
Refund Yes
Void [SOURCE GAP — PM VERIFY: no VoidTransaction override in QNBProcessor.cs. Same-day cancellations likely use refund.]
Stored accounts No (CanProcessorSaveCards = false)
Recurring card-on-file No
Terminal (POS (Point of Sale)) No

Capability correction (April 2026): Stored accounts and Void are NOT supported in the QNB processor class today.

Configure QNB

  1. At the center level, navigate to Configuration > Payments > Settings (the center-scope caption of the Payments row).
  2. Select QNB as the payment processor.
  3. Enter the Merchant ID, Merchant password, and Store name.
  4. Enable the payment channels activated at QNB.
  5. Select Save.
  6. Select Test to verify.

Process a payment

  1. Guest selects QNB at Webstore checkout.
  2. Zenoti redirects to the QNB hosted page with a signed request.
  3. Guest completes payment.
  4. QNB redirects back and sends a server-to-server callback; Zenoti closes the invoice on success.

Process a refund

Refund — dual-system perspective

System What happens
Zenoti Negative payment line; Collections report shows the refund row.
QNB Refund record in the QNB merchant portal linked to the original transaction. Match key: QNB transaction ID or Zenoti invoice number.

Edit or reverse a posted payment

Invoice state What you can do
Open Remove the payment line and refund if a charge has gone through.
Closed Reopen if permissions allow, or post a compensating refund.

Failure modes

Failure mode User-visible symptom Resolution
QNB unreachable HPP fails to load. Check HTTPS and QNB status.
Signature / hash mismatch All transactions fail with an authentication error. Re-verify Merchant password; ensure no whitespace or encoding issues when copying from the QNB portal.
Card declined HPP shows issuer decline. Guest retries.
Amount out of range Rejected at gateway. Per-MID limits; contact QNB.
Currency mismatch Rejected. Confirm the center currency matches QNB's activated currency.
Settlement failure Approved but missing from settlement. Raise with QNB using the transaction ID.

Settlement and reconciliation

QNB settlement cadence and local holidays depend on the Qatar / regional banking calendar. Weekends in Qatar are Friday and Saturday. [SOURCE GAP — PM VERIFY: exact T+N per card scheme.]

Source Report / view Match key
Zenoti Collections report (filter: Payment Method = QNB) QNB transaction ID + Zenoti invoice number
QNB QNB merchant portal settlement report Same fields

Recommended cadence: daily.

Tips

  • QNB uses a secure hashing mechanism for transaction validation. Ensure the credentials are entered exactly as provided by QNB.
  • Contact your QNB account representative if you encounter authentication errors.
  • When the Qatar weekend falls on Friday/Saturday, settlement arrives on the next working day.
Was this article helpful?
Your feedback helps us improve our documentation.