QRIS static merchant Anda, jadi tagihan per transaksi

Gateway QRIS dinamis untuk toko online

ValettaPay menyisipkan nominal tagihan dan kode unik ke QRIS static Anda, lalu mengembalikan URL QR dan webhook HMAC. Satu pemanggilan, tagihan siap dibayar.

Endpoint invoice
POST /api/v1/invoices
Callback
HMAC-SHA256
Tagihan terlunas
1 dari 1
ValettaPay / Tagihan
  • VTS261119424EDDRp 125.000Lunas42
  • VTS261119B2B0A9Rp 175.000Lunas94
  • VTS261119943387Rp 125.000Menunggu42

Lima langkah dari order ke QR.

Integrasi memanggil satu endpoint. Sisanya dikerjakan gateway.

Daftarkan QRIS static sekali

Tempel payload QRIS static merchant di tab Pengaturan, atau unggah foto QR-nya. Gateway memvalidasi CRC16 sebelum menyimpannya.

Kirim order_id dan amount

POST ke /api/v1/invoices dengan kunci API. Balasan memuat id tagihan, nominal akhir, dan URL QR PNG.

Nominal dan kode unik disisipkan

Gateway menghitung ulang CRC16 atas payload QRIS, lalu menghasilkan QRIS dynamic dengan tag 54 berisi total tagihan.

Pelanggan membayar lewat halaman bayar

Halaman bayar menampilkan QR dan status real-time. Pelanggan memindai dari aplikasi apa pun.

Statusnya masuk lewat webhook

Saat tagihan lunas, gateway mengirim JSON ke callback_url Anda dengan tanda tangan HMAC-SHA256.

Rekonsiliasi manual tetap tersedia

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.

Endpoint yang dipakai integrasi. Format JSON, tanpa SDK.

Buat tagihan

Kirim order_id dan amount. order_id yang sama mengembalikan tagihan yang sama.

SHcurl PHPcheckout.php
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}'

Status dan QR

Ambil status tagihan lewat endpoint privat, atau halaman publik untuk halaman bayar pelanggan.

GETstatus GETqr.png
GET /api/v1/invoices/{id}
GET /api/public/invoices/{id}/qr.png
GET /api/public/invoices/{id}/status

Webhook masuk

Header X-Signature berisi HMAC-SHA256 atas timestamp.body. Timestamp lama ditolak.

Yang dikirim gateway
4 field
  • invoice_id
  • order_id
  • status
  • paid_amount

Notifikasi di panel

Setiap callback yang masuk dicatat, lengkap dengan hasil verifikasi tanda tangan.

  • Tagihan lunasorder_id diteruskan ke callback_url
  • Webhook diterimaTanda tangan HMAC valid
  • Tagihan dibuatKode unik ditambahkan ke nominal

Empat jalan menandai tagihan lunas.

Pilih yang paling sesuai dengan alur verifikasi Anda.

Webhook HMAC

Gateway mengirim callback bertanda tangan setiap tagihan lunas. Toko memverifikasi tanda tangan sebelum mengubah status order.

Endpoint paid

POST /api/v1/invoices/{id}/paid untuk sistem Anda sendiri yang sudah memeriksa mutasi bank.

Tombol tandai lunas

Di panel admin, satu klik menandai tagihan dan langsung menyinkronkan order di toko Valettashop.

Rekonsiliasi mutasi

Tab Mutasi mencocokkan nominal mutasi dengan total tagihan, lalu menandai lunas. CLI qris-admin match <nominal> --pay melakukan hal yang sama tanpa browser.

Pertanyaan yang sering muncul.

Apakah QRIS static merchant saya berubah?

Tidak. Gateway menyisipkan nominal ke payload static yang sama, jadi nama merchant, kota, dan channel Anda tetap utuh di setiap QR yang terbit.

Kenapa status tidak otomatis lunas setelah dibayar?

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.

Berapa lama tagihan berlaku?

Tagihan punya masa berlaku yang diatur di tab Pengaturan. Worker berjalan tiap lima menit dan menutup tagihan yang lewat masa berlaku.

Apakah QiosPay di toko saya tetap berjalan?

Ya. QiosPay tetap jadi metode pembayaran di checkout, dan QRIS Gateway adalah metode tambahan dengan kode qrisgw.

Bagaimana cara memasang gateway ini?

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.