Payment - API E-Wallet
Melalui , menawarkan kemudahan lintas aplikasi (Jump App) untuk . Notifikasi akan dikirimkan ke secara real-time sesaat setelah menyelesaikan .
bertujuan supaya mengaktifkan pada , sehingga dapat melakukan menggunakan dengan . Tahapan ini bertujuan untuk melakukan dari dengan dari .
API URL | /nicepay/direct/v2/payment |
---|---|
Request Method | POP UP, Redirect, Submit |
Description | Performs Request to |
Merchant Token | SHA256(timeStamp+iMid+referenceNo+amt+merchantKey) |
Request Format | application/x-www-form-urlencoded |
Proses hanya dapat dijalankan setelah melalui registrasi, silakan pelajari lebih lengkap tentang registrasi pada Registration - API E-Wallet.
Berikut ini adalah daftar untuk melakukan pengajuan registrasi . Parameter ini digunakan melalui platform pengujian sebagai salah satu tahapan supaya milik dapat terhubung dengan dari .
Catatan tambahan untuk ShopeePay, dalam rangka menghasilkan pengalaman Pengguna lebih baik pada , silakan berikan pesan peringatan (warning message) ke 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 | Token | 324a7d07d9f3fe30a3960b28af29a91fc30a33fb3332cf33d40394f30d1f399f |
callBackUrl Required | AN | 255 | Result Page | https://www.nicepay.co.id/IONPAY_CLIENT/paymentResult.jsp |
returnJsonFormat Required for ShopeePay | AN | 100 | If value is 1, then it will return ShopeePay link. If value is empty/0, then it will redirect to other HTML Page. | 1: return redirectUrlApp and/or redirectUrlHttp empty/0 : return HTML to redirect |
dapat mengikuti panduan dan ShopeePay pada Integrasi & Testing E-Wallet.
Setelah melakukan request , response didapatkan dari 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 | 's Reference Number | 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 | result forward URL (on browser) | https://merchant.co.id/nicepay-callback |
Ketika Callback diterima callbackurl , merekomendasikan untuk melakukan verifikasi dengan menggunakan Status Inquiry - API E-Wallet.
CallBack Handling sangat penting untuk membantu meminimalisir tindakan Fraud. sangat merekomendasikan 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 | 's Reference Number | 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 | Expiry Date (YYYYMMDD) | 20240626 |
paymentExpTm | N | 6 | Expiry Time (HH24MISS) | 093530 |
redirectUrlHttp | AN | 100 | Returns a universal link redirecting users to . | https://pay.uat.airpay.co.id/h5pay/example |
redirectUrlApp | AN | 100 | Returns a URL redirecting users to mobile apps. | For ShopeePay, this value will be deprecated |
redirectToken | AN | 2000 | | Used only for LinkAja |