CMS Plugins

QPay V2 payment integrations for e-commerce platforms and content management systems. All plugins communicate directly with the QPay V2 API — no separate SDK dependency is required.

Available Plugins

Common Features

Every QPay CMS plugin shares a core set of capabilities:

• QR Code Display — Generates and displays a QPay QR code image for customers to scan
• Bank App Deep Links — Provides direct links to Mongolian banking apps (Khan Bank, Golomt, TDB, etc.)
• Automatic Polling — Client-side JavaScript polls the payment status every 3 seconds and redirects on success
• Webhook Callbacks — Server-side webhook endpoint verifies payment via POST /v2/payment/check
• Auto Token Management — Handles QPay V2 token acquisition and caching internally

How Payment Works

All plugins follow the same payment flow:

1. Customer initiates checkout and selects QPay as the payment method
2. Plugin authenticates with the QPay V2 API using Basic Auth (POST /v2/auth/token)
3. Invoice is created via POST /v2/invoice with the order amount and callback URL
4. QR code and bank links are displayed to the customer from the invoice response
5. Customer pays by scanning the QR code or tapping a bank app deep link
6. Payment is confirmed through two parallel mechanisms:
   • QPay sends a webhook callback to the configured callback URL
   • Client-side JavaScript polls the payment status via AJAX
7. Order status is updated to paid/completed

Prerequisites

Before installing any plugin, you need:

• A QPay merchant account with API credentials (username and password)
• An invoice code assigned to your merchant account
• A publicly accessible server for webhook callbacks (production only)

For testing, use the sandbox environment:

https://merchant-sandbox.qpay.mn

For production:

https://merchant.qpay.mn

Marketplace Status

All plugins are open source on GitHub. Several are also submitted to their respective platform marketplaces:

Plugins that are pending marketplace approval can be installed directly from their GitHub repositories.

Choosing a Plugin