qpay-cli

CLI tool for the QPay V2 Payment API. Create invoices, check payments, and test webhooks from the terminal.

Installation

npm install -g qpay-cli

Or use directly with npx:

npx qpay-cli help

Setup

Configure your QPay merchant credentials:

qpay setup

This saves credentials to ~/.qpay/config.json. Alternatively, set environment variables:

export QPAY_BASE_URL=https://merchant.qpay.mn
export QPAY_USERNAME=your_username
export QPAY_PASSWORD=your_password
export QPAY_INVOICE_CODE=your_invoice_code
export QPAY_CALLBACK_URL=https://yoursite.com/webhook

Usage

Create Invoice

qpay invoice create --amount 5000 --order ORD-001
qpay invoice create -a 10000 -o ORD-002 --description "Product payment"
qpay invoice create --amount 5000 --json

Check Payment

qpay payment check INVOICE_ID
qpay payment check INVOICE_ID --json

Cancel Invoice

qpay invoice cancel INVOICE_ID

Webhook Listener

Start a local webhook listener for testing:

qpay webhook listen
qpay webhook listen 8080

This starts a local HTTP server that:

• Receives QPay webhook callbacks
• Automatically verifies payments via the QPay API
• Logs events to the console with color-coded status
• Provides a web dashboard at http://localhost:4040
• Returns event history at GET /events

Configuration

qpay config          # Show current configuration
qpay setup           # Interactive setup wizard

Sandbox

Use --sandbox flag to target the sandbox environment:

qpay invoice create --amount 100 --sandbox

Commands

| Command | Description | |---------|-------------| | qpay setup | Interactive credential setup | | qpay invoice create | Create a new invoice | | qpay invoice get <id> | Get invoice details | | qpay invoice cancel <id> | Cancel an invoice | | qpay payment check <id> | Check payment status | | qpay webhook listen [port] | Start webhook listener (default: 4040) | | qpay config | Show current configuration | | qpay help | Show help | | qpay version | Show version |

Links

• QPay SDK Documentation
• QPay SDK GitHub
• qpay-js (base SDK)

License

MIT