Skip to main content
QPay is a domestic online payment method in Qatar. Customers pay through their bank on the Qatari national debit network. Payrails processes QPay through Checkout.com.

​
How a QPay payment works

QPay is a bank redirect payment method:
  1. The customer selects QPay at checkout, and you send their Qatari national ID in the authorize request.
  2. Payrails creates the payment at Checkout.com and returns a redirect URL, and the customer goes to the QPay page.
  3. The customer confirms the payment on the QPay page.
  4. QPay sends the customer back to your returnInfo URL.
  5. Payrails receives the final result from Checkout.com and updates the payment.
Each payment is single-use: the customer confirms every payment on its own. Payrails captures QPay payments immediately, so a successful payment is final. To return funds, refund the payment. A QPay refund stays pending until Checkout.com confirms it with a webhook notification.

​
Supported currencies and countries

QPay supports QAR (Qatari riyal) as its only presentment currency.

​
Integrate QPay

Choose the PSP that processes QPay for you. The guide covers the PSP-side setup, the Payrails configuration and the request fields that PSP requires.

Checkout.com

QPay via Checkout.com

​
Check PSPs

​
Ways to integrate QPay

  • Payrails SDK: the Web SDK shows QPay when your workflow returns it as a payment option.
  • Payrails API: call lookup payment options, then authorize with qpay as the paymentMethodCode. The PSP guide lists the meta fields that PSP requires.
In both cases, confirm the final result through webhook notifications or the execution status.
Last modified on October 5, 2026