Apa yang dimaksud API QRIS SennPayy?
API SennPayy adalah antarmuka server-to-server untuk membuat invoice dan URL checkout, membaca status, serta menerima notifikasi pembayaran. Ini bukan akses langsung ke sistem Bank Indonesia atau API penerbitan QRIS milik SennPayy sendiri. Kanal yang tersedia mengikuti konfigurasi akun dan provider yang digunakan.
Integrasi ini cocok untuk checkout toko online, penagihan aplikasi, dan bot yang perlu menghubungkan pesanan dengan status pembayaran. Jika tidak memerlukan coding, gunakan payment link QRIS dari dashboard.
Alur integrasi API QRIS
- Siapkan akun dan akses API. Selesaikan persyaratan akun, lalu buat API key di dashboard. Simpan key hanya di backend atau secret manager.
- Buat invoice dari backend. Kirim ID pesanan unik sebagai
external_id, nominal, dan judul melalui endpoint pembuatan invoice. - Arahkan pembeli ke checkout. Gunakan URL checkout dari respons API. Pembeli mengikuti instruksi QRIS atau kanal lain yang tersedia.
- Verifikasi status di server. Validasi signature webhook dan cocokkan ID invoice serta nominal. Cek status melalui API bila perlu; jangan mengandalkan redirect browser sebagai bukti pembayaran.
Contoh request pembuatan invoice
Contoh berikut memakai data pesanan sintetis dan placeholder environment, bukan kredensial aktif. Jalankan dari backend dalam mode sandbox untuk pengujian tanpa uang riil. Pemilihan jalur pembayaran mengikuti pengaturan akun; baca dokumentasi untuk parameter provider.
curl -X POST https://www.sennpayy.biz.id/api/v1/invoices \
-H "Authorization: Bearer $SENNPAYY_TEST_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"external_id": "DEMO-ORDER-001",
"amount": 100000,
"title": "Contoh pesanan sandbox",
"fee_bearer": "merchant"
}'Baca kontrak request, respons, dan pilihan provider. Gunakan external_id yang stabil untuk pesanan yang sama; jangan membuat ID baru setiap kali mengulang request.
Webhook dan keamanan integrasi
Notifikasi webhook SennPayy menggunakan HMAC SHA-256. Ikuti dokumentasi untuk memverifikasi signature, menangani pengiriman ulang secara idempoten, dan memperbarui pesanan hanya setelah status pembayaran tervalidasi. Jangan membagikan API key atau secret webhook ke frontend.
Panduan verifikasi webhook dan informasi keamanan layanan membantu Anda menyiapkan integrasi sebelum produksi.
Biaya, aktivasi, dan pencairan
Akses layanan mengikuti persyaratan akun, peninjauan usaha, dan ketentuan kanal provider. Biaya layanan, biaya kanal, masa tunggu saldo, serta pencairan merupakan komponen yang perlu diperiksa sebelum memakai layanan.
Lihat rincian biaya yang dibaca dari konfigurasi layanan, ketentuan refund dan settlement, serta kebijakan merchant. Notifikasi pembayaran berhasil tidak berarti dana langsung tersedia untuk dicairkan.