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
- At the center level, navigate to Configuration > Payments > Settings (the center-scope caption of the Payments row).
- Select QNB as the payment processor.
- Enter the Merchant ID, Merchant password, and Store name.
- Enable the payment channels activated at QNB.
- Select Save.
- Select Test to verify.
Process a payment
- Guest selects QNB at Webstore checkout.
- Zenoti redirects to the QNB hosted page with a signed request.
- Guest completes payment.
- 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.