Daftarkan QRIS static sekali
Tempel payload QRIS static merchant di tab Pengaturan, atau unggah foto QR-nya. Gateway memvalidasi CRC16 sebelum menyimpannya.
QRIS static merchant Anda, jadi tagihan per transaksi
ValettaPay menyisipkan nominal tagihan dan kode unik ke QRIS static Anda, lalu mengembalikan URL QR dan webhook HMAC. Satu pemanggilan, tagihan siap dibayar.
Integrasi memanggil satu endpoint. Sisanya dikerjakan gateway.
Tempel payload QRIS static merchant di tab Pengaturan, atau unggah foto QR-nya. Gateway memvalidasi CRC16 sebelum menyimpannya.
POST ke /api/v1/invoices dengan kunci API. Balasan memuat id tagihan, nominal akhir, dan URL QR PNG.
Gateway menghitung ulang CRC16 atas payload QRIS, lalu menghasilkan QRIS dynamic dengan tag 54 berisi total tagihan.
Halaman bayar menampilkan QR dan status real-time. Pelanggan memindai dari aplikasi apa pun.
Saat tagihan lunas, gateway mengirim JSON ke callback_url Anda dengan tanda tangan HMAC-SHA256.
Tab Mutasi mencocokkan nominal mutasi bank dengan total tagihan, termasuk kode unik, lalu menandai lunas.
Kenapa QRIS dinamis
Satu QRIS static untuk semua transaksi membuat pembayaran ambigu. Dengan QRIS dinamis, setiap tagihan punya nominal sendiri, jadi mutasi bank langsung cocok dengan order tanpa tebak-tebakan kode unik.
Kirim order_id dan amount. order_id yang sama mengembalikan tagihan yang sama.
curl -X POST 'https://qris.valettashop.com/api/v1/invoices' \
-H 'X-API-Key: <kunci-api>' \
-H 'Content-Type: application/json' \
-d '{"order_id":"VTS261119424EDD","amount":125000}'
Ambil status tagihan lewat endpoint privat, atau halaman publik untuk halaman bayar pelanggan.
GET /api/v1/invoices/{id}
GET /api/public/invoices/{id}/qr.png
GET /api/public/invoices/{id}/status
Header X-Signature berisi HMAC-SHA256 atas timestamp.body. Timestamp lama ditolak.
Setiap callback yang masuk dicatat, lengkap dengan hasil verifikasi tanda tangan.
Pilih yang paling sesuai dengan alur verifikasi Anda.
Gateway mengirim callback bertanda tangan setiap tagihan lunas. Toko memverifikasi tanda tangan sebelum mengubah status order.
POST /api/v1/invoices/{id}/paid untuk sistem Anda sendiri yang sudah memeriksa mutasi bank.
Di panel admin, satu klik menandai tagihan dan langsung menyinkronkan order di toko Valettashop.
Tab Mutasi mencocokkan nominal mutasi dengan total tagihan, lalu menandai lunas. CLI qris-admin match <nominal> --pay melakukan hal yang sama tanpa browser.
Tidak. Gateway menyisipkan nominal ke payload static yang sama, jadi nama merchant, kota, dan channel Anda tetap utuh di setiap QR yang terbit.
QRIS dynamic hasil konversi dari QRIS static tidak memicu notifikasi dari acquirer. Karena itu pelunasan masuk lewat webhook HMAC, endpoint paid, tombol panel, atau rekonsiliasi mutasi.
Tagihan punya masa berlaku yang diatur di tab Pengaturan. Worker berjalan tiap lima menit dan menutup tagihan yang lewat masa berlaku.
Ya. QiosPay tetap jadi metode pembayaran di checkout, dan QRIS Gateway adalah metode tambahan dengan kode qrisgw.
Tempel payload QRIS static di tab Pengaturan, buat kunci API, lalu panggil POST /api/v1/invoices saat checkout dibuat. Detail lengkap ada di halaman dokumentasi.