Dokumentasi Integrasi API
Panduan lengkap integrasi pembayaran QRIS MPM Dinamis SNAP V2 dengan format response JSON murni untuk website, aplikasi mobile, bot Telegram, maupun sistem backend Anda.
Autentikasi Header
Kirimkan API Key Anda pada setiap permintaan API melalui header HTTP:
Base URL Produksi
Semua endpoint menggunakan protokol HTTPS resmi berlatensi rendah:
Otomatis Webhook
Server LowBytes Pay otomatis mengirimkan callback webhook seketika saat pelanggan menyelesaikan pembayaran.
Proteksi HMAC-SHA256/apiv2/generate
Membuat tagihan pembayaran QRIS Dinamis baru. Response mengembalikan string QRIS murni untuk di-render menjadi QR code atau dibuka langsung melalui link pembayaran.
curl -X POST https://pay.lowbytes.net/apiv2/generate \
-H "Content-Type: application/json" \
-H "X-API-KEY: LBV2-(20random)-(username)" \
-d '{
"amount": 15000,
"orderId": "INV-10023",
"customerName": "Budi Santoso",
"customerEmail": "budi@example.com",
"callbackUrl": "https://myshop.com/api/payment-webhook"
}'Parameter Body Request (JSON)
| Field | Tipe | Wajib | Keterangan |
|---|---|---|---|
| amount | number | Wajib | Nominal transaksi (Minimal Rp 1.000). |
| orderId | string | Opsional | Nomor referensi unik pesanan toko Anda. Jika kosong, sistem membuat otomatis. |
| customerName | string | Opsional | Nama pelanggan pemesan. Default: "Pelanggan". |
| callbackUrl | string (URL) | Opsional | URL webhook server Anda untuk menerima notifikasi lunas otomatis. |
{
"success": true,
"statusCode": 200,
"message": "QRIS payment created successfully",
"data": {
"transactionId": "bd0ea478-0d13-47a7-a3d3-d7d24c668fc1",
"orderId": "INV-10023",
"referenceNo": "QRA179375953692128200404631",
"amount": 15000,
"adminFee": 105,
"totalAmount": 15105,
"currency": "IDR",
"paymentMethod": "QRIS",
"qrString": "00020101021226640012ID.ZIPAY.WWW01189360082500820833050215ZPM1013522083420303UME51420012ID.ZIPAY.WWW0215ZPM1013522083420303UME5204737253033605404151055802ID5919LowBytes Technology6006MALANG61056514562360525ZP179375953692321445410270703A0163042CD2",
"qrUrl": "https://pay.lowbytes.net/pay/INV-10023",
"status": "PENDING",
"expiredAt": "2026-11-04T11:00:00+07:00",
"createdAt": "2026-11-04T10:00:00+07:00"
}
}/apiv2/check
Cek status transaksi secara berkala atau manual berdasarkan orderId atau referenceNo.
curl -X POST https://pay.lowbytes.net/apiv2/check \
-H "Content-Type: application/json" \
-H "X-API-KEY: LBV2-(20random)-(username)" \
-d '{
"orderId": "INV-10023"
}'{
"success": true,
"statusCode": 200,
"message": "Transaction status retrieved successfully",
"data": {
"transactionId": "bd0ea478-0d13-47a7-a3d3-d7d24c668fc1",
"orderId": "INV-10023",
"referenceNo": "QRA179375953692128200404631",
"amount": 15000,
"adminFee": 105,
"totalAmount": 15105,
"status": "PAID",
"paymentMethod": "QRIS",
"customerName": "Budi Santoso",
"paidAt": "2026-11-04T10:14:22+07:00",
"createdAt": "2026-11-04T10:00:00+07:00"
}
}/apiv2/trx/callback
Mekanisme notifikasi otomatis (Instant Webhook) ke URL server Anda ketika pelanggan berhasil membayar tagihan QRIS. Anda juga dapat menggunakan endpoint ini untuk melakukan uji coba tembak webhook ke server Anda.
curl -X POST https://pay.lowbytes.net/apiv2/trx/callback \
-H "Content-Type: application/json" \
-H "X-API-KEY: LBV2-(20random)-(username)" \
-d '{
"orderId": "INV-10023"
}'Live API Playground (Uji Coba Langsung)
Uji coba request langsung ke server dan lihat hasil JSON murni tanpa menulis kode apapun.