Payment
QRIS

Integrasi & Testing QRIS

14 min

  digunakan dalam   dan  berasal dari ShopeePay. Akan tetapi,  ShopeePay juga dapat menerima  dari  lain, seperti OVO, DANA, LinkAja, dan Mobile Banking  dapat melakukan  dengan QR.



Urutan Integrasi API yang digunakan


  1. Lakukan   Order Registration.
  2. Menerima callback dan push notification dari .
  3. Lakukan   Status Inquiry.
  4. Opsional: lakukan   Cancel untuk membatalkan .



Kredensial Untuk Tes QRIS



Nama QRIS

Deskripsi

ShopeePay

Aplikasi ShopeePay untuk uji coba pada Development Environment -> link

Kredensial pada Development Environment Jump App:

  • Username: nicepaytest Password: Nicepay123 OTP: 123456 ShopeePay PIN: 159159



Cara Uji Coba QRIS



Nama QRIS

Langkah Tes

Aturan dan Kondisi

ShopeePay

  1. Menggunakan iMid asli atau Sandbox dengan iMid = IONPAYTEST.
  2. Mengunduh aplikasi ShopeePay khusus untuk uji coba pada Development Environment atau aplikasi asli Shopee untuk uji coba pada Staging/Production Environment.
  3. Memindai kode QR dan melakukan autentikasi untuk .
  4. Mengumpulkan  dan melanjutkan  hingga  berhasil.

Untuk kode QR:

  • Aturan default batas waktu untuk paymentExpTm = 5 menit.
  • Jangka waktu pengaturan untuk paymentExpTm mulai dari 5 menit hingga 20 menit.



Untuk kondisi pembatala , antara lain:

  • Pembatalan sebelum  akan menunjukkan kedaluwarsa atau tidak berlaku dengan  5.
  • Transaksi Off-Us dapat melakukan pengembalian dana secara daring hingga 365 hari sejak  dibuat.
  • Transaksi On-Us hanya melakukan pengembalian dana secara daring sebelum   dibuat mencapai waktu 1 hari. Setelah 1 hari,  akan dialihkan menjadi Manual Refund. Setelah 1 minggu,  akan dibuat menjadi Blocked.



Alasan Peluang Transaksi Gagal


  1. Salah memindai kode QR pada aplikasi ShopeePay.
  2. Pesanan tidak sesuai.
  3. Transaksi sudah kedaluwarsa.



Integration Checklist dan Test Case



Implementasi  inquiry setelah mendapatkan callback.

Implementasi  inquiry setelah mendapatkan  di dalam dbProcessUrl.

Meninjau log .

Meninjau pengaturan firewall (eg. Cloudflare untuk pengaturan dbprocessUrl).

Memeriksa implementasi merchantToken.

Menjalankan tes skenario pada Development Environment.

Menjalankan tes skenario pada Production Environment. Get Sample Scenario

Meninjau Error Handling (Timeout, Failed, Negative Case).



Best Practice


  • Untuk uji coba , dapat menggunakan iMid = IONPAYTEST dan pasang parameter shopId = NICEPAY.
  • Dukungan untuk pembatalan  secara penuh dapat melalui kode tautan cancelType.
  • Ketika  diterima pada dbProcessUrl ,  sangat merekomendasikan  untuk melakukan verifikasi  menggunakan Inquiry .
  • Notification Handling berguna untuk meminimalisir aksi Fraud,  sangat merekomendasikan  untuk melakukan verifikasi Notification Handling.



See also

  Alur Pembayaran QRIS untuk mengetahui  pada  saat melakukan  dengan .

  Tipe QRIS untuk mengetahui jenis   digunakan pada .

  Daftar Istilah QRIS untuk mengetahui istilah khusus  digunakan oleh .

  FAQ QRIS jika ingin mengetahui pertanyaan yang sering diajukan terkait QRIS.



Updated 23 Jun 2025
Did this page help you?
PREVIOUS
Tipe QRIS
NEXT
Penyelesaian Transaksi Pada QRIS
Docs powered by Archbee