NICEPAY API
...
API E-Wallet
Payment - API E-Wallet
13 min
about api e wallet payment through {{the}} {{ewallet}} {{paymethod}} , {{nicepay}} offers you {{the}} convenience of cross app {{payment}} s (jump app) for your {{customer}} s notifications will be sent to {{customer}} s in real time as soon as {{customer}} s complete {{payment}} s {{please}} visit {{the}} docid\ cmd9efdsw7mptws1elyfc {{page}} to acknowledge {{the}} flow difference between {{the}} general {{ewallet}} with astrapay {{please}} visit {{the}} docid\ mkxgm04 smrzpcmmynuk0 {{page}} to learn general {{information}} about {{ewallet}} {{paymethod}} api e wallet payment {{api}} {{paymentproduct}} {{ewallet}} aims to activate {{the}} {{ewallet}} {{paymethod}} at {{merchant}} s, so that {{customer}} can make {{payment}} {{transaction}} s using {{ewallet}} with {{merchant}} s this stage is to integrate {{the}} {{merchant}} {{system}} with {{the}} {{nicepay}} {{system}} api url /nicepay/direct/v2/payment request method pop up, redirect, submit pop up, redirect, submit description performs {{paymentproduct}} request to {{nicepay}} merchant token sha256( timestamp + imid + referenceno + amt + merchantkey ) request format application/x www form urlencoded the payment process can only be carried out after going through the registration process, please learn further about registration on docid\ rui2t2t 97vn3ke51qpvp page request parameter for e wallet payment the following is a list of {{parameter}} s for requesting registration of {{the}} {{ewallet}} {{paymethod}} this {{parameter}} is used through {{the}} {{api}} {{testing}} platform as one of {{the}} stages so that {{the}} {{merchant}} 's {{system}} can connect with {{service}} s from {{nicepay}} additional notes for shopeepay, to produce a better user experience for {{customer}} s, please provide a warning message {{information}} to {{customer}} s to access via mobile devices parameter type size description example / notes timestamp required required n 14 request timestamp ( yyyymmddhh24miss ) 20221208065959 txid required required an 30 transaction id ionpaytest05202212081111197444 merchanttoken required required an 255 {{merchant}} token 324a7d07d9f3fe30a3960b28af29a91fc30a33fb3332cf33d40394f30d1f399f callbackurl require require mentresult j d d an 255 result page https //www nicepay co id/ionpay client/paysp returnjsonformat required for shopeepay 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 you can follow {{the}} {{integration}} and {{testing}} guidance of shopeepay {{ewallet}} on docid\ obca35upc pltziltbrpa {{page}} callback handling e wallet after request for {{ewallet}} {{payment}} , {{the}} response obtained from {{ewallet}} {{payment}} s is in {{the}} form of a callback parameter type size description example / notes resultcd n 14 docid 2r5sr3xvppu1eju1nitg 0000 resultmsg an 225 result message docid 4 fpewlvczfhcvygxwck9 success txid an 30 transaction id ionpaytest05202406260930529202 referenceno ans 40 {{merchant}} 's reference number 20240626093051 paymethod n 2 docid\ ek 0djw7nuhytcda4sa3p 05 amt n 12 amount 10000 transdt n 8 transaction date ( yyyymmdd ) 20240626 transtm n 6 transaction date ( hh24miss ) 093052 mitracd an 4 docid 0upx1lyg1o2f4biu3ssp eshp callbackurl ans 500 {{paymentproduct}} result forward url (on browser) https //merchant co id/nicepay callback when your callback already received callbackurl , {{nicepay}} recommended {{the}} {{merchant}} to do {{the}} {{status}} verification using {{the}} docid\ tegpdwiwlqpwiik9vv3r4 callback handling is very important to help minimize fraud {{nicepay}} highly recommend {{the}} {{merchant}} to do {{the}} verification using callback handling url callback https //merchant co id/nicepay callback?resultcd=0000\&resultmsg=success\&txid=ionpaytest05202406260930529202\&referenceno=20240626093051\&paymethod=05\&amt=2000\&transdt=20240626\&transtm=093652\&mitracd=eshp\&callbackurl=https%3a%2f%2fwebhook site%2fe1e151bc 23f5 4db9 8272 6addeea95701 response parameter for e wallet payment parameter type size description example / notes resultcd n 4 docid 2r5sr3xvppu1eju1nitg 0000 resultmsg an 255 result m essage docid 4 fpewlvczfhcvygxwck9 success txid an 30 transaction id ionpaytest05202406260930529202 referenceno ans 40 {{merchant}} 's reference number 20240626093051 paymethod n 2 docid\ ek 0djw7nuhytcda4sa3p 05 amt n 12 amount 10000 transdt n 8 transaction date ( yyyymmdd ) 20240626 transtm n 6 transaction date ( hh24miss ) 093052 mitracd an 4 docid 0upx1lyg1o2f4biu3ssp eshp paymentexpdt n 8 {{paymentproduct}} expiry date ( yyyymmdd ) 20240626 paymentexptm n 6 {{paymentproduct}} expiry time ( hh24miss ) 093530 redirecturlhttp an 100 returns a universal link redirecting users to {{ewallet}} {{payment}} {{page}} https //pay uat airpay co id/h5pay/example redirecturlapp an 100 returns a url redirecting users to {{the}} {{ewallet}} mobile apps for shopeepay, this value will be deprecated for shopeepay, this value will be deprecated redirecttoken an 2000 used only for linkaja used only for linkaja sample json for e wallet payment form urlencode request txid=ionpaytest05202406260930529202\×tamp=20240626090665\&merchanttoken=9252d7d37ea2564d8d0dcf448509662d386a0de365c703cfe8a486f1009d34ff\&callbackurl=https //merchant co id/nicepay callback\&returnjsonformat=1 sample response { "resultcd" "0000", "resultmsg" "success", "txid" "ionpaytest05202406260930529202", "referenceno" "20240626093051", "paymethod" "05", "amt" "2000", "transdt" "20240626", "transtm" "093052", "mitracd" "eshp", "paymentexpdt" "20240626", "paymentexptm" "093807", "redirecturlhttp" "https //pay uat airpay co id/h5pay/example", "redirecturlapp" "", "redirecttoken" null }