API QRIS untuk developer: satu endpoint, webhook bertanda tangan, mode tes gratis

Kasera Pay API adalah cara menerima pembayaran QRIS dan Virtual Account dari aplikasi sendiri tanpa membangun sistem verifikasi manual. Satu panggilan membuat permintaan pembayaran, pembeli membayar dari aplikasi banknya, dan server menerima webhook bertanda tangan saat uangnya masuk. Halaman ini menjelaskan apa yang didapat, apa biayanya, dan apa yang perlu disiapkan. Urutan pemasangannya langkah demi langkah ada di panduan integrasi QRIS di website, dan urutan yang berbeda untuk software kasir ada di panduan integrasi QRIS di POS.

Satu endpoint, dua cara menampilkan pembayaran

Semua metode berjalan lewat POST /v1/transactions. Responsnya membawa keduanya sekaligus: checkout_url ke halaman pembayaran yang dihosting Kasera Pay, dan objek payment untuk yang ingin menggambar sendiri. Untuk QRIS, payment.qr_string adalah payload EMV mentah yang bisa diubah menjadi gambar oleh pustaka QR mana pun. Untuk Virtual Account, bentuknya nomor pembayaran.

curl https://pay.kasera.id/v1/transactions \
  -H "Authorization: Bearer kp_test_..." \
  -H "Idempotency-Key: order-1234" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": 150000,
    "description": "Kaos komunitas",
    "external_id": "ORD-1234",
    "payment_methods": ["qris"],
    "return_url": "https://toko.example/selesai"
  }'

Respons 201:

{
  "id": "payreq_9b2f...",
  "status": "pending",
  "amount": 150000,
  "checkout_url": "https://pay.kasera.id/p/xK3f...",
  "payment_method": "qris",
  "payment": {
    "type": "qr",
    "qr_string": "00020101021226670016COM.KASERA.WWW...6304A1B2"
  },
  "expires_at": "2026-09-07T13:00:00+07:00"
}

Header Idempotency-Key adalah satu-satunya hal yang mencegah permintaan yang terkirim dua kali menjadi dua tagihan. Nilainya dibuat sebelum percobaan pertama dan dipakai ulang pada setiap retry. Nominal ditulis dalam rupiah utuh, dan identitas amount = fee + net selalu berlaku pada responsnya.

Webhook yang bisa dipercaya tanpa panggilan balik

Saat pembayaran terkonfirmasi, Kasera Pay mengirim event payment.paid ke setiap endpoint webhook yang aktif, sampai lima per mode. Setiap pengiriman membawa tanda tangan bertimestamp di header Kasera-Signature-V1, HMAC-SHA256 atas t + "." + rawBody, dan id event di Kasera-Event-Id untuk dedupe. Pengiriman diulang dengan exponential backoff sampai tujuh percobaan dalam rentang sekitar 33 jam bila endpoint tidak menjawab 2xx.

POST https://toko.example/webhook
Kasera-Signature-V1: t=1757222700,v1=5f4d...
Kasera-Event-Id: evt_...

{
  "id": "evt_...",
  "type": "payment.paid",
  "livemode": false,
  "data": {
    "payment_request_id": "payreq_9b2f...",
    "external_id": "ORD-1234",
    "amount": 150000,
    "paid_at": "2026-09-07T12:04:58+07:00"
  }
}

Contoh verifikasi dalam Node.js, aturan timestamp lima menit, dan masa tenggang rotasi secret ada di dokumentasi webhook.

Metode yang aktif hari ini

E-wallet belum aktif, dan paylater baru dibuka untuk akun tertentu; bentuk integrasi keduanya sudah diterbitkan di dokumentasi supaya bisa disiapkan lebih dulu. Tarif di atas adalah tarif default yang diterbitkan, tanpa biaya bulanan dan tanpa biaya pendaftaran. Daftar metode yang aktif untuk sebuah akun, lengkap dengan tarif dan rentang nominalnya, dibaca dari GET /v1/payment_methods, jadi kode metode dan tarifnya tidak perlu ditulis permanen di kode. Rinciannya ada di dokumentasi metode pembayaran.

Kalau Virtual Account yang lebih dulu dibutuhkan, termasuk nomor yang terbit saat permintaan dibuat dan apa bedanya dengan mendaftar ke setiap bank sendiri, ada halaman API Virtual Account tujuh bank.

Mode tes sebelum mode live

Kunci dibuat di dashboard pada menu Developer. Kunci tes berawalan kp_test_, kunci live berawalan kp_live_, dan keduanya dikirim sebagai Authorization: Bearer. Create dengan kunci tes menghasilkan permintaan pembayaran mode tes yang dituntaskan lewat endpoint simulasi dengan hasil succeeded atau expired. Mode live dan mode tes adalah dua endpoint webhook terpisah dengan signing secret masing-masing, jadi secret tes tidak pernah memverifikasi payload live. Panduannya ada di dokumentasi mode tes.

Batas default yang berlaku saat pembuatan

• Nominal minimum Rp 1.000 untuk QRIS dan Rp 10.000 untuk Virtual Account, maksimum Rp 10.000.000 per permintaan.
• Untuk pembayaran di atas Rp 1.000.000, create wajib membawa description minimal 10 karakter, customer.name, customer.phone atau customer.email, delivery_date, dan delivery_terms_shown: true. Tanpa itu create ditolak 422. Rinciannya ada di panduan menerima pembayaran di atas Rp 1 juta.
• Tidak ada batas harian untuk akun yang onboarding-nya sudah aktif.
• Sebelum onboarding aktif: 10 permintaan dan Rp 1.000.000 nominal yang bisa diterima, dihitung untuk seumur akun dan hanya terbuka dengan menyelesaikan verifikasi.
• Masa berlaku 60 menit, dapat diatur sampai 24 jam.
• 300 permintaan per menit per API key untuk seluruh endpoint /v1/*.

Nilainya dapat berbeda per akun dan kode error penolakannya ada di dokumentasi batas dan laju. Pencairan saldo ke rekening bank dikenakan Rp 3.000 per pencairan, bukan per transaksi, dan berjalan setelah pembayaran selesai diproses bank pada hari kerja berikutnya, dengan pengiriman ke bank Senin sampai Sabtu pukul 13.00–14.00 WIB; jadwal dan penahannya dibahas di panduan pencairan dana.

Yang perlu disiapkan

• Akun Kasera Pay. Mode tes bisa langsung dipakai, dan sebelum verifikasi akun live sudah bisa menerima pembayaran dalam jatah sebelum verifikasi. Verifikasi identitas dan rekening tujuan dibutuhkan untuk pencairan dan untuk melewati jatah itu. Perorangan bisa mendaftar; syaratnya ada di panduan payment gateway tanpa PT.
• Server yang memegang kunci API. Semua panggilan berasal dari server, tidak pernah dari browser.
• Satu URL webhook https yang bisa diakses publik, diatur per mode di dashboard.

Kalau yang dibutuhkan hanya menagih beberapa pembeli sehari tanpa menulis kode, tautan pembayaran dari dashboard sudah cukup dan tarifnya sama; lihat halaman payment link. Titik saat tautan manual berhenti sepadan dan integrasi mulai masuk akal dibahas di panduan dari tautan manual ke integrasi API.

Buat akun dan API key

Pertanyaan yang sering muncul

Untuk implementasi lengkap di satu framework, termasuk verifikasi tanda tangan dan feature test-nya, ada panduan integrasi payment gateway di Laravel 13.