LowBytes Pay
LowBytes PaySNAP V2
LowBytes Pay API v2 Specification

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:

X-API-KEY: LBV2-(20random)-(username)

Base URL Produksi

Semua endpoint menggunakan protokol HTTPS resmi berlatensi rendah:

https://pay.lowbytes.net

Otomatis Webhook

Server LowBytes Pay otomatis mengirimkan callback webhook seketika saat pelanggan menyelesaikan pembayaran.

Proteksi HMAC-SHA256
Bahasa Pemrograman:
POST

/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.

Contoh Kode Request (CURL)
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)

FieldTipeWajibKeterangan
amountnumberWajibNominal transaksi (Minimal Rp 1.000).
orderIdstringOpsionalNomor referensi unik pesanan toko Anda. Jika kosong, sistem membuat otomatis.
customerNamestringOpsionalNama pelanggan pemesan. Default: "Pelanggan".
callbackUrlstring (URL)OpsionalURL webhook server Anda untuk menerima notifikasi lunas otomatis.
Contoh JSON Output Sukses (200 OK)
{
  "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"
  }
}
POST / GET

/apiv2/check

Cek status transaksi secara berkala atau manual berdasarkan orderId atau referenceNo.

Contoh Kode Request (CURL)
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"
  }'
Contoh JSON Output Lunas (200 OK)
{
  "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"
  }
}
WEBHOOK

/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.

Contoh Handler & Verifikasi Webhook (CURL)
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.