NICEPAY API
...
API E-Wallet
Payment - API E-Wallet
13 min
about api e wallet payment through , offers you convenience of cross app s (jump app) for your s notifications will be sent to s in real time as soon as s complete s visit docid\ cmd9efdsw7mptws1elyfc to acknowledge flow difference between general with astrapay visit docid\ mkxgm04 smrzpcmmynuk0 to learn general about api e wallet payment aims to activate at s, so that can make s using with s this stage is to integrate with api url /nicepay/direct/v2/payment request method pop up, redirect, submit pop up, redirect, submit description performs request to 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 s for requesting registration of this is used through platform as one of stages so that 's can connect with s from additional notes for shopeepay, to produce a better user experience for s, please provide a warning message to 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 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 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 you can follow and guidance of shopeepay on docid\ obca35upc pltziltbrpa callback handling e wallet after request for , response obtained from s is in 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 '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 result forward url (on browser) https //merchant co id/nicepay callback when your callback already received callbackurl , recommended to do verification using docid\ tegpdwiwlqpwiik9vv3r4 callback handling is very important to help minimize fraud highly recommend to do 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 '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 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 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 }