qpay-sdk/laravel

QPay V2 payment integration for Laravel

1.0.0 2026-02-26 11:59 UTC

Requires

• php: ^8.1
• illuminate/support: ^10.0|^11.0
• qpay-sdk/qpay-php: ^1.0

Requires (Dev)

• orchestra/testbench: ^8.0|^9.0
• phpunit/phpunit: ^10.0|^11.0

MIT

README

QPay V2 payment integration for Laravel.

Install

composer require qpay-sdk/laravel
php artisan qpay:install

Configuration

Add to .env:

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

Usage

use QPay\Laravel\Facades\QPay;
use QPay\Models\CreateSimpleInvoiceRequest;

$invoice = QPay::createSimpleInvoice(new CreateSimpleInvoiceRequest(
    invoiceCode: config('qpay.invoice_code'),
    senderInvoiceNo: 'ORDER-001',
    amount: 10000,
    callbackUrl: config('qpay.callback_url'),
));

// $invoice->invoiceId, $invoice->qrImage, $invoice->urls

Blade Components

<x-qpay-qr-code :qr-image="$invoice->qrImage" />
<x-qpay-payment-button :urls="$invoice->urls" :short-url="$invoice->qPayShortUrl" />

Webhook

Listen for payment events:

use QPay\Laravel\Events\PaymentReceived;

Event::listen(PaymentReceived::class, function ($event) {
    // $event->invoiceId
    // $event->result->rows
});

License

MIT