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.

Last updated

Was this helpful?