Cara menerima pembayaran QRIS dengan PAYWISE

QRIS adalah standar kode QR nasional Indonesia. Satu kode bisa dibayar dari aplikasi bank atau e-wallet mana pun di Indonesia, jadi pelanggan tidak perlu aplikasi tertentu untuk membayar Anda. Dengan PAYWISE, Anda membuat kode QR lewat satu panggilan API dan langsung diberi tahu saat pembayaran berhasil.

Sebelum mulai

Anda membutuhkan akun PAYWISE dan API key. Buat sandbox key terlebih dahulu (diawali pw_test_): cara kerjanya sama persis dengan key live, tetapi tidak ada uang sungguhan yang berpindah. Key dibuat di dashboard pada menu Kunci API. Key lengkap hanya ditampilkan sekali, jadi simpan di tempat yang aman.

Langkah 1: Buat pembayaran

Saat pelanggan checkout, server Anda membuat transaksi:

curl -X POST https://paywise.asia/api/v1/transactions \
  -H "Authorization: Bearer pw_test_..." \
  -H "Content-Type: application/json" \
  -d '{"merchant_reference":"ORDER-1001","customer_id":"user-42","amount":150000,"payment_method":"QRIS"}'

• merchant_reference adalah nomor pesanan Anda sendiri. Jika permintaan timeout lalu dikirim ulang, PAYWISE mengembalikan transaksi yang sama, bukan membuat transaksi kedua.
• customer_id (wajib) adalah ID pelanggan dari sistem Anda, misalnya user ID atau email, agar Anda tahu siapa yang membayar.
• amount dalam rupiah bulat, 1.000 sampai 10.000.000 per pembayaran.
• expires_in (opsional) mengatur berapa lama kode QR bisa dibayar, 60 sampai 1.200 detik (bawaan).

Langkah 2: Tampilkan kode QR

Respons API berisi data QR. Anda bisa menampilkan kode QR di halaman Anda sendiri, atau cukup arahkan pelanggan ke checkout_url: halaman pembayaran PAYWISE berisi kode QR, hitung mundur, dan status pembayaran yang diperbarui otomatis. Halaman pembayaran diaktifkan per website di dashboard Anda.

Langkah 3: Konfirmasi pembayaran dengan webhook

Pelanggan memindai kode dengan aplikasi bank atau e-wallet lalu membayar. PAYWISE kemudian mengirim webhook payment.paid ke server Anda. Proses pesanan berdasarkan webhook tersebut, setelah tanda tangannya dicek, bukan saat pelanggan kembali ke website Anda: siapa pun bisa mengetik alamat kembali (return URL).

Baca Memverifikasi tanda tangan webhook untuk caranya.

Langkah 4: Mulai live

Setelah uji coba di sandbox berhasil, buat key live (pw_live_...) dan ganti sandbox key. Kode Anda tetap sama. Transaksi QRIS yang sudah dibayar kemudian di-settle dalam beberapa batch setiap hari dan bisa ditarik ke rekening bank Anda, lihat Penjelasan settlement dan penarikan dana.

Perlu diketahui

• Biaya hanya dikenakan pada transaksi yang berhasil dibayar. Transaksi pending, gagal, dan kedaluwarsa tidak dikenai biaya. Lihat halaman harga untuk tarif terbaru.
• Setiap panggilan API tercatat di dashboard beserta status dan request ID-nya, sehingga mudah ditelusuri saat ada masalah.
• Referensi lengkap ada di dokumentasi API.