--- title: Integrasi & Testing QRIS slug: integrasi-and-testing-qris description: Informasi tentang cara integrasi dan testing pada metode pembayaran QRIS dengan sistem NICEPAY image: https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/FMUR_Fyuiy7GwrLSe2Nyf_rdrx9d8diazpgm07xfz2test-1.png icon: {"faIcon":"fa-solid fa-book"} docTags: createdAt: 2022-11-11T02:43:37.000Z --- 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 *** 1. Lakukan integrasi API Order Registration. - SNAP: [Registration - API QRIS SNAP](docId\:n42BapM1t1eOiXNS-RA_d). - Redirect: [QRIS - API Checkout](docId\:YkjkZcCCOAmIwfmgMuVvI). 2. Menerima *callback *dan *push notification *dari NICEPAY. 3. Lakukan integrasi API Status Inquiry. - SNAP: [Check Status Transaction - API QRIS SNAP](docId:3aXWe6p6cyHX_ZuN-bvgQ). - Redirect: [Status Inquiry - API Checkout](docId\:K9vBS87ev9_w5oJAU0et3). 4. Opsional: lakukan integrasi API Cancel untuk membatalkan transaksi. - SNAP: [Refund Transaction - API QRIS SNAP](docId\:U1UpkNC78XEyuHGD4CxPD). - Redirect: [Cancel - API Checkout](docId\:MMmlusWDkyUsJxF421yKn). # Kredensial Untuk Tes QRIS *** | **Nama QRIS** | **Deskripsi** | | ------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | ShopeePay | [APK Shopee ](https://drive.google.com/file/d/1gGE2-7OpBWXoz_KF7Kl0IThWtnAaQjCe/view)\| [APK ShopeePay](https://drive.google.com/file/d/13cYsNzcmoJwe4fiLjnrmhAT0Uc94w81K/view)**
Username: nicepaytest01
Password: NicepayTest01
ShopeePay PIN: 142536 | :::hint{type="info"} 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 | 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 pembayaran. 4. 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 *** 1. Salah memindai kode QR pada aplikasi ShopeePay. 2. Pesanan tidak sesuai. 3. 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](https://docs.google.com/spreadsheets/d/e/2PACX-1vQIaIMCM0vZ3L1cA-JkW3YxyIpjsB966fg1wTeT8qpFDowEvulIEWOoY6I4uJPL3A/pub?output=xlsx) - [ ] 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`. # See also ::::VerticalSplit{layout="middle"} :::VerticalSplitItem Kunjungi halaman [Alur Pembayaran QRIS](docId\:m-HeeKLNLzY1G1thlaKy-) untuk mengetahui proses pada sistem saat melakukan pembayaran dengan QRIS. ::: :::VerticalSplitItem Kunjungi halaman [Tipe QRIS](docId\:yxX3p9Itvvu6qTepCfjbU) untuk mengetahui jenis QRIS yang digunakan pada NICEPAY. ::: :::: ::::VerticalSplit{layout="middle"} :::VerticalSplitItem Kunjungi halaman [Daftar Istilah QRIS](docId:6BFA6ymPlc8HEHi6jXRO2) untuk mengetahui istilah khusus yang digunakan oleh QRIS. ::: :::VerticalSplitItem Kunjungi halaman [FAQ QRIS](docId\:AHrsQb4knslavXU-aBiF4) jika ingin mengetahui pertanyaan yang sering diajukan terkait QRIS. ::: ::::