Integrasi & Testing E-Wallet

13 min

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

Lakukan integrasi API Order Registration.

SNAP: Registration - API E-Wallet (Direct Debit) SNAP.

Redirect: E-Wallet - API Checkout.

Lakukan integrasi API Payment Charge.

Redirect: Payment - API Checkout.

Menerima callback dan push notification dari NICEPAY.

Lakukan integrasi API Check Status.

SNAP: Check Status Transaction - API E-Wallet (Direct Debit) SNAP.

Redirect: Status Inquiry - API Checkout.

Opsional: lakukan integrasi API Cancel untuk membatalkan transaksi.

Redirect: Cancel - API Checkout.

Kredensial Untuk Tes E-Wallet

Nama E-Wallet	Deskripsi
DANA	Phone: 081227619520 Pin: 159753
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.

Uji Coba E-Wallet

Nama e-Wallet	Langkah Tes	Aturan Pembatalan
OVO	Menggunakan akun dan nomor telepon asli. Konfirmasi pembayaran melalui aplikasi OVO. Mengumpulkan informasi dan melanjutkan transaksi dan transaksi berhasil. 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	Menggunakan akun asli atau dummy. Masuk akun. Masukkan OTP. Mengumpulkan informasi dan konfirmasi pembayaran. Transaksi berhasil. 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	Menggunakan akun asli. Masuk akun. Masukkan OTP. Mengumpulkan informasi. Konfirmasi pembayaran dan transaksi berhasil. 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	Menggunakan akun asli atau dummy. Konfirmasi pembayaran pada aplikasi Shopee. Masukkan PIN. Transaksi berhasil. 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	Mendaftarkan nomor ponsel dan menghubungkan ke NICEPAY. Menggunakan nomor ponsel yang sudah terhubung dengan NICEPAY. Masuk akun. Mengumpulkan informasi dan konfirmasi pembayaran. Transaksi berhasil. 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

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.