Integrasi & Testing QRIS

13 min

QRIS yang digunakan dalam proses integrasi dan testing berasal dari ShopeePay. Akan tetapi, QRIS ShopeePay juga dapat menerima pembayaran dari Mitra lain, seperti OVO, DANA, LinkAja, dan Mobile Banking yang dapat melakukan pembayaran dengan QR.

Urutan Integrasi API yang digunakan

Lakukan integrasi API Order Registration.

SNAP: Registration - API QRIS SNAP.

Redirect: QRIS - API Checkout.

Menerima callback dan push notification dari NICEPAY.

Lakukan integrasi API Status Inquiry.

SNAP: Check Status Transaction - API QRIS SNAP.

Redirect: Status Inquiry - API Checkout.

Opsional: lakukan integrasi API Cancel untuk membatalkan transaksi.

SNAP: Refund Transaction - API QRIS SNAP.

Redirect: Cancel - API Checkout.

Kredensial Untuk Tes QRIS

Nama QRIS	Deskripsi
ShopeePay	APK Shopee \| APK ShopeePay Username: nicepaytest01 Password: NicepayTest01 ShopeePay PIN: 142536

Merchant wajib melakukan Whitelist IP pada perangkat yang digunakan untuk uji coba melalui aplikasi ShopeePay atau Shopee.

Silakan hubungi Tim Integrasi NICEPAY untuk informasi lebih lanjut.

Cara Uji Coba QRIS

Nama QRIS	Langkah Tes	Aturan dan Kondisi
ShopeePay	Menggunakan iMid asli atau Sandbox dengan iMid = IONPAYTEST. Mengunduh aplikasi ShopeePay khusus untuk uji coba pada Development Environment atau aplikasi asli Shopee untuk uji coba pada Staging/Production Environment. Memindai kode QR dan melakukan autentikasi untuk pembayaran. Mengumpulkan informasi dan melanjutkan transaksi hingga transaksi 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 pembatalan transaksi, antara lain: Pembatalan sebelum transaksi akan menunjukkan kedaluwarsa atau tidak berlaku dengan status 5. Pengembalian dana secara daring hanya dapat dilakukan sebelum transaksi yang dibuat mencapai 365 hari. Proses pembatalan transaksi tidak dapat dilakukan pada pukul 00:00 - 05:00 WIB. Transaksi Off-Us dapat melakukan pengembalian dana secara daring sebelum transaksi yang dibuat mencapai waktu 7 hari. Jika transaksi sudah lebih dari 7 hari, tetapi belum mencapai 365 hari, maka akan dialihkan menjadi Manual Refund.

Alasan Peluang Transaksi Gagal

Salah memindai kode QR pada aplikasi ShopeePay.

Pesanan tidak sesuai.

Transaksi sudah kedaluwarsa.

Integration Checklist dan Test Case

Implementasi status inquiry setelah mendapatkan callback.

Implementasi status inquiry setelah mendapatkan notifikasi di dalam dbProcessUrl.

Meninjau log pembayaran.

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 Merchant, dapat menggunakan iMid = IONPAYTEST dan pasang parameter shopId = NICEPAY.

Dukungan untuk pembatalan QRIS secara penuh dapat melalui kode tautan cancelType.

Ketika notifikasi diterima pada dbProcessUrl Anda, NICEPAY sangat merekomendasikan Merchant untuk melakukan verifikasi notifikasi menggunakan Inquiry API.

Notification Handling berguna untuk meminimalisir aksi Fraud, NICEPAY sangat merekomendasikan Merchant untuk melakukan verifikasi Notification Handling.