Dokumentasi API & Webhook
Qris Pay

Pengantar integrasi Qris Pay Payment API

Qris Pay menyediakan REST API untuk membuat transaksi QRIS dinamis, memantau status pembayaran, dan menerima notifikasi real-time ke server Anda melalui webhook.

Ikuti tahapan berikut secara berurutan untuk menyiapkan akun, QRIS, kredensial API, dan aplikasi listener hingga siap menerima pembayaran.

1. 1
   Buat akun di QrisPayapp.web.id — registrasi akun terlebih dahulu sebagai dasar seluruh layanan Qris Pay.
2. 2
   Upload QRIS di halaman QRIS Saya — unggah QRIS statis Anda agar bisa diubah menjadi QRIS dinamis otomatis.
3. 3
   Generate API Key (License Key & Webhook Secret) — generate KEDUANYA di halaman API Keys; listener app dan callback pembayaran membutuhkan keduanya.
4. 4
   Download aplikasi Qris Pay di Play Store — cari "Qris Pay : Gateway Qris" di Google Play Store, lalu instal di HP Android Anda.
5. 5
   Login akun di aplikasi Qris Pay — gunakan akun yang sama dengan yang Anda daftarkan di QrisPayapp.web.id.
6. 6
   Masuk ke tab Setting di aplikasi Qris Pay — buka menu pengaturan di dalam aplikasi untuk konfigurasi listener.
7. 7
   Nyalakan Listener App & lengkapi checklist hijau — pastikan semua item checklist berwarna HIJAU: izinkan akses notifikasi, dan isi sumber QRIS sesuai merchant yang Anda pakai. Jika merchant tidak ada di Aksi Cepat, silakan hubungi admin WhatsApp.
8. 8
   Buat code untuk integrasi API — gunakan endpoint Generate QRIS v1/v2 di bawah ini pada backend Anda, lengkap dengan contoh request dan response.

Membuat transaksi QRIS dinamis

Endpoint utama untuk membuat transaksi QRIS dinamis. Sistem otomatis menyisipkan kode unik acak ke nominal untuk membedakan setiap transaksi.

POST /api/generate/qris HTTP/1.1
Host: api.QrisPayapp.web.id
x-license-key: YOUR_LICENSE_KEY
Content-Type: application/json

{
  "id": "986b2a0a-5c95-4177-9800-02d84a35338e",
  "amount": 10000,
  "useUniqueCode": true,
  "packageIds": ["id.dana"],
  "expiredInMinutes": 15,
  "prefix": "CSK"
}

Versi API terbaru dengan parameter fleksibel

Mendukung parameter tambahan seperti qrType, paymentMethod, dan useQris untuk lebih banyak skenario pembayaran.

POST /api/generate/v2/qris HTTP/1.1
Host: api.QrisPayapp.web.id
x-license-key: YOUR_LICENSE_KEY
Content-Type: application/json

{
  "qr_id": "986b2a0a-5c95-4177-9800-02d84a35338e",
  "amount": 15000,
  "useUniqueCode": true,
  "packageIds": ["id.dana", "com.shopee.id"],
  "expiredInMinutes": 15,
  "qrType": "dynamic",
  "paymentMethod": "qris",
  "useQris": true,
  "prefix": "CSK"
}

Polling status pembayaran secara real-time

POST /api/generate/check-status HTTP/1.1
Host: api.QrisPayapp.web.id
x-license-key: YOUR_LICENSE_KEY
Content-Type: application/json

{
  "transactionId": "CSK-c39e25d2-0cb2-4a00-9941-863863486df8"
}

Status perangkat aplikasi listener Android Anda

Gunakan endpoint ini untuk memeriksa apakah perangkat listener (aplikasi Qris Pay di HP Android) sedang online sebelum membuat transaksi.

GET /api/device/check HTTP/1.1
Host: api.QrisPayapp.web.id
x-license-key: YOUR_LICENSE_KEY

Tandai transaksi pending/expired sebagai lunas secara manual

Gunakan endpoint ini untuk menyelesaikan transaksi secara manual ketika pembayaran sudah diterima namun belum terdeteksi otomatis. Hanya transaksi berstatus pending atau expired yang dapat ditandai lunas.

POST /api/generate/mark-paid HTTP/1.1
Host: api.QrisPayapp.web.id
x-license-key: YOUR_LICENSE_KEY
Content-Type: application/json

{
  "transactionId": "CSK-c39e25d2-0cb2-4a00-9941-863863486df8",
  "packageName": "manual.approval",
  "appName": "Manual Dashboard",
  "title": "Persetujuan Manual",
  "text": "Disetujui secara manual melalui Dashboard",
  "packageIds": ["manual"]
}

Cancel, list, hapus riwayat, dan profile.

Library integrasi dari komunitas

Library NPM qrispay ini dibuat dan dipelihara secara independen oleh salah satu pelanggan/developer aktif Qris Pay.

npm install qrispay

import { QrisPay } from "qrispay";

const qrispay = new QrisPay({ licenseKey: "YOUR_LICENSE_KEY" });

const trx = await qrispay.generateQRISv2({
  qr_id: "986b2a0a-5c95-4177-9800-02d84a35338e",
  amount: 10000,
  packageIds: ["id.dana"],
  qrType: "dynamic",
  paymentMethod: "qris",
  useQris: true,
  useUniqueCode: true,
});

Notifikasi otomatis saat transaksi lunas

Qris Pay mengirim HTTP POST ke URL webhook Anda secara otomatis saat transaksi berubah menjadi paid.

{
  "transactionId": "TX987654321",
  "amount": 55000,
  "packageName": "com.company.paymentapp",
  "appName": "Payment App Name",
  "status": "paid",
  "paidAt": "2026-06-04T03:38:35Z"
}

Render string data menjadi QR Code visual

Tool untuk mengonversi data string menjadi gambar QR Code. Berguna untuk debugging QRIS string yang di-generate API.

https://larabert-qrgen.hf.space/v1/create-qr-code?size=300x300&style=2&color=111111&data=https%3A%2F%2Fqrispayapp.web.id