--- title: Integrasi & Testing E-Wallet slug: integrasi-and-testing-e-wallet description: Informasi tentang cara integrasi dan testing pada metode pembayaran E-Wallet dengan sistem NICEPAY image: https://archbee-image-uploads.s3.amazonaws.com/ZHvSjR5ZrsoxwKbJa3xmo/_B7hriNhkzoFKP2lUIsS3_rdrx9d8diazpgm07xfz2test-1.png icon: {"faIcon":"fa-solid fa-book"} docTags: createdAt: 2022-09-16T09:04:36.000Z --- Sistem E-Wallet NICEPAY didukung oleh sistem E-Wallet dari beberapa Partner, antara lain OVO, DANA, LinkAja, ShopeePay, dan AstraPay. # Langkah Integrasi Dengan Menggunakan API *** 1. Lakukan integrasi API Order Registration. - SNAP: [Registration - API E-Wallet (Direct Debit) SNAP](docId:66iE5aVXXL4uqw6hqFPVV). - Redirect: [E-Wallet - API Checkout](docId\:LsZ2xGeXUSGjm_tVrlbGI). 2. Lakukan integrasi API Payment Charge. - Redirect: [Payment - API Checkout](docId\:YnNFZr9aonpJ7ZIKAFYSx). 3. Menerima *callback *dan *push notification *dari NICEPAY. 4. Lakukan integrasi API Check Status. - SNAP: [Check Status Transaction - API E-Wallet (Direct Debit) SNAP](docId\:vB63D8suaKPYP-4bIOWx9). - Redirect: [Status Inquiry - API Checkout](docId\:K9vBS87ev9_w5oJAU0et3). 5. Opsional: lakukan integrasi API Cancel untuk membatalkan transaksi. - Redirect: [Cancel - API Checkout](docId\:MMmlusWDkyUsJxF421yKn). # Kredensial Untuk Tes E-Wallet *** | **Nama E-Wallet** | **Deskripsi** | | ----------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | DANA | Phone: 081227619520
Pin: 159753 | | 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. ::: # Uji Coba E-Wallet *** | **Nama e-Wallet** | **Langkah Tes** | **Aturan Pembatalan** | | ----------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | OVO | 1. Menggunakan akun dan nomor telepon asli. 2. Konfirmasi pembayaran melalui aplikasi OVO. 3. Mengumpulkan informasi dan melanjutkan transaksi dan transaksi berhasil. 4. Waktu kedaluwarsa (*Default*) = 55 detik. | - Nominal sesuai tagihan pada hari yang sama => *Void.* - Nominal sesuai tagihan pada hari yang berbeda => Tidak dapat dilakukan. - Sebagian dari nominal pembayaran => Tidak dapat dilakukan*.* | | DANA | 1. Menggunakan akun asli atau *dummy.* 2. Masuk akun. 3. Masukkan OTP. 4. Mengumpulkan informasi dan konfirmasi pembayaran. 5. Transaksi berhasil. 6. Waktu kedaluwarsa (*Default*) = 24 jam. | - Nominal sesuai tagihan \< 24 jam => *Void.* - Nominal sesuai tagihan > 24 jam => *Refund Online.* - Pengajuan > 30 hari => *Block.* - Sebagian dari nominal pembayaran => *Refund Online.* - Sebagian dari nominal pembayaran jika *timeout *=> *Manual Refund.* - Tidak bisa mengajukan pada pukul 00.00 - 01.00 (tengah malam). | | LinkAja | 1. Menggunakan akun asli. 2. Masuk akun. 3. Masukkan OTP. 4. Mengumpulkan informasi. 5. Konfirmasi pembayaran dan transaksi berhasil. 6. Waktu kedaluwarsa (*Default*) = 5 menit. | - Nominal sesuai tagihan \< 30 hari => *Void.* - Nominal sesuai tagihan > 30 hari => *Manual Refund.* - Sebagian dari nominal pembayaran => *Manual Refund.* - *Checkout *transaksi LinkAja pada web => 5 menit. | | ShopeePay | 1. Menggunakan akun asli atau *dummy.* 2. Konfirmasi pembayaran pada aplikasi Shopee. 3. Masukkan PIN. 4. Transaksi berhasil. 5. Waktu kedaluwarsa (*Default*) = 5 menit. | - Nominal sesuai tagihan pada hari yang sama / sebelum pukul 24.00 => *Void.* - Nominal sesuai tagihan tidak pada hari yang sama namun transaksi di bawah 365 hari => *Refund.* - Nominal sesuai tagihan > 365 hari => *Manual Refund.* - Sebagian dari nominal pembayaran => *Block Request.* - Tidak bisa mengajukan pada pukul 23.55 - 06.00. | | AstraPay | 1. Mendaftarkan nomor ponsel dan menghubungkan ke NICEPAY. 2. Menggunakan nomor ponsel yang sudah terhubung dengan NICEPAY. 3. Masuk akun. 4. Mengumpulkan informasi dan konfirmasi pembayaran. 5. Transaksi berhasil. 6. Waktu kedaluwarsa (*Default*) = 15 menit. | Tidak bisa *refund* | # Alasan Peluang Transaksi Gagal *** - Transaksi terkena waktu kedaluwarsa (*Expired Time).* - Jaringan pada sisi *Issuer *sedang tidak mendukung. - Ditolak oleh pihak E-Wallet / *Issuer */ Mitra terkait. - Nomor ponsel Pengguna belum terdaftar pada aplikasi E-Wallet. # 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 *** - Ketika notifikasi pada `dbProcessUrl` Anda diterima, NICEPAY sangat merekomendasikan Merchant untuk melakukan verifikasi notifikasi menggunakan Inquiry API. - Informasi `cartData` wajib diisi. - Pada OVO, notifikasi masuk melalui sistem *push notification *dalam aplikasi ponsel. - Pada ShopeePay, pembayaran dilakukan dengan metode *jump in* ke aplikasi *mobile *Shopee. - Pada LinkAja dan DANA, notifikasi masuk ke halaman Mitra. # See also ::::VerticalSplit{layout="middle"} :::VerticalSplitItem Kunjungi halaman [Alur Pembayaran E-Wallet](docId\:saeozIsJLLCkE5s4QVnHw) untuk mengetahui proses pada sistem saat melakukan pembayaran dengan E-Wallet. ::: :::VerticalSplitItem Kunjungi halaman [Fitur E-Wallet](docId\:FltKp9kGyS4hkmOPZojoV) untuk mengetahui fitur transaksi pada E-Wallet. ::: :::: ::::VerticalSplit{layout="middle"} :::VerticalSplitItem Kunjungi halaman [Daftar Istilah E-Wallet](docId\:RtyOOpERogK7_PImzLfth) untuk mengetahui istilah khusus yang digunakan oleh E-Wallet. ::: :::VerticalSplitItem Kunjungi halaman [FAQ E-Wallet](docId\:QyuY2tdI299dVSNUt9G-1) jika ingin mengetahui pertanyaan yang sering diajukan terkait E-Wallet. ::: ::::