Dashboard — QRIS Gateway

Total Transaksi

Menunggu Bayar

Lunas

Total Nominal Lunas

Volume Transaksi 7 hari terakhir

Distribusi Status

Konfigurasi QRIS

QRIS StatisMemuat...

Nama Merchant-

Kota-

Base URL-

Buat QRIS

Nominal (Rp)

Minimal Rp5.000. Kode unik 3 digit ditambahkan otomatis.

Status Pembayaran

Payment ID

Transaksi Terakhir

Otomatis refresh tiap 10 detik

ID	Nominal	Status	Dibuat
Memuat...

Dokumentasi API

Semua request memakai autentikasi API key via header X-API-Key atau query ?apiKey=.

POST/api/qris/createBuat QRIS pembayaran

Parameter	Tipe	Wajib	Keterangan
amount	integer	Ya	Nominal bayar. Min Rp5.000, maks Rp10.000.000
merchantRef	string	Tidak	Referensi bebas, maks 64 karakter

Contoh request

curl -X POST https://apiv01.mxthz.xyz/api/qris/create \
  -H "Content-Type: application/json" \
  -H "X-API-Key: KUNCI_API_ANDA" \
  -d '{"amount": 50000, "merchantRef": "order-123"}'

Contoh response

{
  "ok": true,
  "paymentId": "pay_9f2c41ab77e30d1c",
  "qrisData": "000201010212...",
  "amount": 50000,
  "uniqueCode": 317,
  "payableAmount": 50317,
  "expiresAt": "2026-10-18T03:00:00.000Z"
}

GET/api/qris/statusCek status pembayaran

Parameter	Tipe	Wajib	Keterangan
paymentId	string	Ya	ID dari response create

Contoh request

curl "https://apiv01.mxthz.xyz/api/qris/status?paymentId=pay_9f2c41ab77e30d1c" \
  -H "X-API-Key: KUNCI_API_ANDA"

Contoh response

{
  "ok": true,
  "status": "paid",
  "amount": 50000,
  "payableAmount": 50317,
  "createdAt": "2026-10-18T02:45:00.000Z",
  "expiresAt": "2026-10-18T03:00:00.000Z",
  "paidAt": "2026-10-18T02:47:12.000Z"
}

Nilai status: pending (menunggu), paid (lunas), expired (kadaluarsa). Polling tiap 8 detik disarankan.

POST/api/qris/webhookNotifikasi DANA (APK)

Dipanggil oleh aplikasi DANA Notify saat ada pembayaran masuk. Memakai WEBHOOK_SECRET yang terpisah dari API key.

Field	Tipe	Wajib	Keterangan
amount	number	Ya	Nominal yang diterima
rawText	string	Tidak	Teks notifikasi mentah
apiKey	string	Ya	WEBHOOK_SECRET

Contoh request

curl -X POST https://apiv01.mxthz.xyz/api/qris/webhook \
  -H "Content-Type: application/json" \
  -d '{"amount": 50317, "rawText": "...", "apiKey": "WEBHOOK_SECRET_ANDA"}'

Contoh response

{
  "ok": true,
  "paymentId": "pay_9f2c41ab77e30d1c",
  "status": "paid"
}

GET/api/admin/statsStatistik pembayaran

Contoh response

{
  "ok": true,
  "total": 24,
  "pending": 3,
  "paid": 20,
  "totalAmount": 1520000,
  "paidAmount": 1520000
}

GET/api/admin/paymentsDaftar pembayaran

Parameter	Tipe	Wajib	Keterangan
limit	integer	Tidak	Jumlah data, default 50, maks 200

Contoh response

{
  "ok": true,
  "payments": [
    {
      "id": "pay_9f2c41ab77e30d1c",
      "amount": 50000,
      "uniqueCode": 317,
      "payableAmount": 50317,
      "status": "paid",
      "createdAt": "2026-10-18T02:45:00.000Z",
      "expiresAt": "2026-10-18T03:00:00.000Z",
      "paidAt": "2026-10-18T02:47:12.000Z"
    }
  ]
}