--- title: Integrasi & Testing CVS slug: integrasi-and-testing-cvs description: Informasi tentang cara integrasi dan testing pada metode pembayaran Convenience Store (CVS) dengan sistem NICEPAY image: https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/YABT8wh_f2DswDr-XXtcw_rdrx9d8diazpgm07xfz2test-1.png icon: {"faIcon":"fa-solid fa-book"} docTags: createdAt: 2022-09-16T09:04:10.000Z --- # Langkah Integrasi & API yang digunakan *** 1. Lakukan integrasi API Call Transaction Registration. - Direct: [Registration - API Convenience Store](docId\:p4bRL6dsnS-wppv5hFuLU). - Redirect: [Convenience Store - API Checkout](docId:18WjzOk7UMtB1vuL_hFsi). 2. Menerima *callback *dan *push notification *dari NICEPAY. 3. Lakukan integrasi API Status Inquiry. - Direct: [Status Inquiry - API Convenience Store](docId\:WMITrWcw3j9ChajRg-o1D). - Redirect: [Status Inquiry - API Checkout](docId\:K9vBS87ev9_w5oJAU0et3). 4. Opsional: lakukan integrasi API Cancel untuk membatalkan transaksi. - Direct: [Cancel - API Convenience Store](docId\:L-DtvJzQTenDps30WbyMC). - Redirect: [Cancel - API Checkout](docId\:MMmlusWDkyUsJxF421yKn). # Cara Uji Coba CVS *** | **Langkah Tes** | **Aturan dan Kondisi** | | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | 1. Menggunakan MID Merchant atau MID sandbox (`IONPAYTEST`) AutoPaid. 2. Membuat pendaftaran Convenience Store (CVS). 3. Catat atau cetak `payment code`. 4. Membawa `payment code` menuju Indomaret atau Alfamart / Alfamidi / Dan+Dan / Lawson. 5. Memeriksa inquiry* payment *Anda. 6. Membayar sesuai dengan nominal yang tercantum. 7. Ambil *payment* *receipt* Anda. 8. Transaksi berhasil. 9. Periksa notifikasi (`dbProcessUrl`) Anda. | 1) Memberitahu kasir ada pembayaran dibuat menggunakan NICEPAY + nama Merchant. 2) CVS bisa dibatalkan dan dikembalikan setelah pembayaran, tetapi hanya bisa dilakukan secara manual atau masa berlaku nomor `payNo` sudah berakhir. Tidak bisa dilakukan melalui API. 3) Nomor Convenience Store (`payNo`) dapat kedaluwarsa secara *default* dalam hari ke-7 tetapi juga bergantung pada preferensi Merchant, pengaturan dapat disesuaikan ( yang paling umum adalah 24 jam, 3 hari, dsb). 4) Ketentuan berdasarkan CVS: - Alfamart & Alfamidi: transaksi tidak bisa dilakukan setelah pukul 10 malam dan dapat digunakan kembali setelah pukul 1 pagi pada hari berikutnya. - Indomaret: transaksi tidak bisa dilakukan setelah jam 11 malam dan dapat digunakan kembali setelah pukul 1 pagi pada hari berikutnya. | # Alasan Peluang Transaksi Gagal *** 1. Salah memasukkan `payNo`. 2. `payNo` sudah kedaluwarsa atau tidak berlaku. 3. Ditolak dari Mitra. # 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 *** - `payValidDt` dan `payValidTm` digunakan untuk *set *batas waktu bayar pada Merchant yang menggunakan parameter tersebut. - 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 CVS](docId\:Qb3J_IzkOf9DEI_8Zk32W) untuk mengetahui proses pada sistem saat melakukan pembayaran dengan Convenience Store. ::: :::VerticalSplitItem Kunjungi halaman [Fitur CVS](docId\:iWIQWotO0vYXaBnkseJEA) untuk mengetahui fitur transaksi pada Convenience Store. ::: :::: ::::VerticalSplit{layout="middle"} :::VerticalSplitItem Kunjungi halaman [Daftar Istilah CVS](docId:-M-nZrtY-prU0aJjTYj9g) untuk mengetahui istilah khusus yang digunakan oleh Convenience Store. ::: :::VerticalSplitItem Kunjungi halaman [FAQ CVS](docId\:Bf4kvuVF_blHBxysENnWn) jika ingin mengetahui pertanyaan yang sering diajukan terkait Convenience Store. ::: ::::