Payment - API E-Wallet
Melalui metode pembayaran E-Wallet, NICEPAY menawarkan Anda kemudahan pembayaran lintas aplikasi (Jump App) untuk Pelanggan Anda. Notifikasi akan dikirimkan ke Pelanggan secara real-time sesaat setelah Pelanggan menyelesaikan pembayaran.
- Silakan kunjungi halaman Alur Pembayaran E-Wallet untuk mengetahui perbedaan alur E-Wallet secara umum dengan AstraPay.
- Silakan kunjungi halaman E-Wallet untuk mempelajari informasi umum mengenai metode pembayaran E-Wallet.
API Payment E-Wallet bertujuan supaya mengaktifkan metode pembayaran E-Wallet pada Merchant, sehingga Pelanggan dapat melakukan transaksi pembayaran menggunakan E-Wallet dengan Merchant. Tahapan ini bertujuan untuk melakukan integrasi sistem dari Merchant dengan sistem dari NICEPAY.
API URL | /nicepay/direct/v2/payment |
Request Method | POP UP, Redirect, Submit |
Description | Performs Payment Request to NICEPAY |
Merchant Token | SHA256(timeStamp+iMid+referenceNo+amt+merchantKey) |
Request Format | application/x-www-form-urlencoded |
Proses pembayaran hanya dapat dijalankan setelah melalui proses registrasi, silakan pelajari lebih lengkap tentang registrasi pada halaman Registration - API E-Wallet.
Berikut ini adalah daftar parameter untuk melakukan pengajuan registrasi metode pembayaran E-Wallet. Parameter ini digunakan melalui platform pengujian API sebagai salah satu tahapan supaya sistem milik Merchant dapat terhubung dengan layanan dari NICEPAY.
Catatan tambahan untuk ShopeePay, dalam rangka menghasilkan pengalaman Pengguna lebih baik pada Pelanggan, silakan berikan informasi pesan peringatan (warning message) ke Pelanggan untuk mengakses melalui perangkat ponsel.
Parameter | Tipe | Ukuran | Deskripsi | Contoh / Catatan |
timeStamp Required | N | 14 | Request Timestamp (YYYYMMDDHH24MISS) | 20221208065959 |
tXid Required | AN | 30 | Transaction ID | IONPAYTEST05202212081111197444 |
merchantToken Required | AN | 255 | Merchant Token | 324a7d07d9f3fe30a3960b28af29a91fc30a33fb3332cf33d40394f30d1f399f |
callBackUrl Required | AN | 255 | Result Page | https://www.nicepay.co.id/IONPAY_CLIENT/paymentResult.jsp |
returnJsonFormat Required for ShopeePay | AN | 100 | If the value is 1, then it will return Shopeepay link. If the value is empty/0, then it will redirect to other HTML Page | 1: return redirectUrlApp and/or redirectUrlHttp empty/0 : return HTML to redirect |
Anda dapat mengikuti panduan integrasi dan testing ShopeePay E-Wallet pada halaman Integrasi & Testing E-Wallet.
Setelah melakukan request pembayaran E-Wallet, response yang didapatkan dari metode pembayaran E-Wallet adalah berupa Callback.
Parameter | Tipe | Ukuran | Deskripsi | Contoh / Catatan |
resultCd | N | 14 | Result Code | 0000 |
resultMsg | AN | 225 | Result Message: Error Code | Success |
tXid | AN | 30 | Transaction ID | IONPAYTEST05202406260930529202 |
referenceNo | ANS | 40 | Merchant's Ref. No | 20240626093051 |
payMethod | N | 2 | 05 | |
amt | N | 12 | Amount | 10000 |
transDt | N | 8 | Transaction Date (YYYYMMDD) | 20240626 |
transTm | N | 6 | Transaction Date (HH24MISS) | 093052 |
mitraCd | AN | 4 | Mitra Code | ESHP |
callBackUrl | ANS | 500 | Payment result forward URL (on browser) | https://merchant.co.id/nicepay-callback |
Ketika Callback diterima callbackurl Anda, NICEPAY merekomendasikan Merchant untuk melakukan verifikasi status dengan menggunakan Status Inquiry - API E-Wallet.
CallBack Handling sangat penting untuk membantu meminimalisir tindakan Fraud. NICEPAY sangat merekomendasikan Merchant untuk melakukan verifikasi menggunakan CallBack Handling.
Parameter | Tipe | Ukuran | Deskripsi | Contoh / Catatan |
resultCd | N | 4 | Result Code | 0000 |
resultMsg | AN | 255 | Result M essage: Error Code | Success |
tXid | AN | 30 | Transaction ID | IONPAYTEST05202406260930529202 |
referenceNo | ANS | 40 | Merchant's Ref. No | 20240626093051 |
payMethod | N | 2 | 05 | |
amt | N | 12 | Amount | 10000 |
transDt | N | 8 | Transaction Date (YYYYMMDD) | 20240626 |
transTm | N | 6 | Transaction Date (HH24MISS) | 093052 |
mitraCd | AN | 4 | Mitra Code | ESHP |
paymentExpDt | N | 8 | Payment Expiry Date (YYYYMMDD) | 20240626 |
paymentExpTm | N | 6 | Payment Expiry Time (HH24MISS) | 093530 |
redirectUrlHttp | AN | 100 | Returns a universal link redirecting users to E-Wallet payment page. | https://pay.uat.airpay.co.id/h5pay/example |
redirectUrlApp | AN | 100 | Returns a URL redirecting users to the E-Wallet mobile apps. | For ShopeePay, this value will be deprecated |
redirectToken | AN | 2000 | | Used only for LinkAja |