QNBPay Integration

Prerequisites

Preliminary Works

The following information is requested from the provider for the brand-specific and production (live) environment.

• App ID

• App Secret

• Merchant Key

Omnitron Settings

This payment method’s configuration can be done on the Payment Options & Add/Edit POS/Card Setting pages on Omnitron. After the settings are completed, it will be accessible under a new tab on the checkout payment screen as it is a credit card type payment integration. Bin number must also be configured. For additional information, refer to the POS Integrations tutorial.

POS Integration

One POS integration must be defined in Omnitron to be specific for the extension installed. Explanations on how the settings should be made at this stage are in the table below.

Field	Description
Name	QNB Pay
Slug	qnb_pay
Gateway	qnb_pay
Resource URL	Requested URL from the provider
Three D resource url	Requested URL from the provider
app_id	Requested App Id from the provider
app_secret	Requested App Secret from the provider
merchant_key	Requested Merchant Key from the provider
allowed_md_statuses	["4", "3", "2", "1"]
three_d_enabled	Yes

Payment Options

Credit card payment option must be defined on Omnitron. Explanations on how the settings should be made at this stage are in the table below.

Do not set more than one active payment option with the type “masterpass” or “credit card”.

Field	Description
Payment Option	Credit Card
Payment Option Name	Any text you prefer
Payment Option Slug	credit_card
Config*	{}

Card Integration

At least one CARD integration must be defined in Omnitron to use credit card payment. Explanations on how the settings should be made at this stage are in the table below.

Field	Description
Name	A related name
Slug	A related slug
Single payment POS infrastructure	Created POS in above
Installment POS Infrastructure	Created POS in above
3D POS Infrastructure	Created POS in above
Card Payment Type	Debit or Credit Card
Card Type	The related created card type
Bank	The related created bank
Commercial Card	Yes or No

After creating a card, go to its detail and add bin numbers to it.

Additional Notes

• If there is any error during the capture process, a void request will be sent, but it will not succeed. Nevertheless, the provider will cancel the payment after 15 minutes.

• For non-3D payment transactions with QNBPay, the status_code and error_code fields return 34, accompanied by the error message: 'The payment integration method is not allowed. Please contact support.' Non-3D payment transactions are not supported with QNBPay. QNBPay status codes can be found here: QNBPay Status Codes.