Payment
QRIS

Integrasi & Testing QRIS

14min

 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.