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 e wallet payment flow docid\ cmd9efdsw7mptws1elyfc to acknowledge flow difference between general with astrapay visit e wallet 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 \<font color="#3b9f0f">pop up, redirect, submit\</font> 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 registration api e wallet 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 \<font color="#2166ae">required\</font> n 14 request timestamp ( yyyymmddhh24miss ) 20221208065959 txid \<font color="#2166ae">required\</font> an 30 transaction id ionpaytest05202212081111197444 merchanttoken \<font color="#2166ae">required\</font> an 255 token 324a7d07d9f3fe30a3960b28af29a91fc30a33fb3332cf33d40394f30d1f399f callbackurl \<font color="#2166ae">require\</font> mentresult j \<font color="#2166ae">d\</font> an 255 result page https //www nicepay co id/ionpay client/paysp returnjsonformat \<font color="#2166ae"> required for shopeepay \</font> 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 e wallet integration & testing 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 result code docid 2r5sr3xvppu1eju1nitg 0000 resultmsg an 225 result message error code docid 4 fpewlvczfhcvygxwck9 success txid an 30 transaction id ionpaytest05202406260930529202 referenceno ans 40 's reference number 20240626093051 paymethod \<font color="#2166ae"> \</font> n 2 payment method code 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 mitra code 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 status inquiry api e wallet 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 result code docid 2r5sr3xvppu1eju1nitg 0000 resultmsg an 255 result m essage error code docid 4 fpewlvczfhcvygxwck9 success txid an 30 transaction id ionpaytest05202406260930529202 referenceno ans 40 's reference number 20240626093051 paymethod \<font color="#2166ae"> \</font> n 2 payment method code 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 mitra code 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 \<font color="#eb144c">for shopeepay, this value will be deprecated\</font> redirecttoken an 2000 \<font color="#2166ae">used only for linkaja\</font> 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 }