NICEPAY API
...
API E-Wallet
Status Inquiry - API E-Wallet
11 min
about api e wallet status inquiry integration of {{the}} status inquiry {{api}} in {{ewallet}} is required so that {{merchant}} s can check {{the}} ongoing {{status}} of {{the}} {{transaction}} {{process}} carried out by {{the}} {{customer}} whether {{the}} {{status}} is success, fail, and others so that {{the}} {{system}} can have a report on that {{information}} api e wallet status inquiry integration of inquiry {{status}} on {{ewallet}} s aims to enable {{merchant}} s to connect with {{the}} {{api}} {{system}} to check {{the}} {{status}} of {{ewallet}} {{paymethod}} s on a regular basis api endpoint /nicepay/direct/v2/inquiry request method post post description performs inquiry request to {{nicepay}} for status checking merchant token sha256( timestamp + imid + referenceno + amt + merchantkey ) request format application/json when your dbprocessurl received a {{notification}} , {{nicepay}} strongly encourage {{merchant}} s to verify {{the}} {{notification}} using {{the}} docid\ tegpdwiwlqpwiik9vv3r4 notification handling is very useful to minimize {{the}} risk of fraud we strongly encourage {{merchant}} s to verify notification handling you can read more detailed {{information}} about notification handling on docid\ k 6owepag06la6jpg vvt request parameter for e wallet status inquiry the following is a list of {{parameter}} s for request a {{status}} inquiries on {{ewallet}} {{transaction}} {{process}} parameter type size description example / notes timestamp required required n 14 request timestamp ( yyyymmddhh24miss ) 20221208065959 txid required required an 30 transaction id ionpaytest05202212081111197444 imid required required an 10 {{merchant}} id ionpaytest referenceno required required ans 40 {{merchant}} order number ord20221208 amt required required n 12 transaction amount 2000 merchanttoken required required an 255 {{merchant}} token 324a7d07d9f3fe30a3960b28af29a91fc30a33fb3332cf33d40394f30d1f399f response parameter for e wallet status inquiry the following is a list of responses to request {{status}} inquiries on {{ewallet}} {{transaction}} {{process}} es parameter type size description example / notes resultcd n 4 docid 2r5sr3xvppu1eju1nitg 0000 resultmsg an 255 result message docid 4 fpewlvczfhcvygxwck9 paid txid an 30 transaction id ionpaytest05202212081111197444 imid an 10 {{merchant}} id ionpaytest currency a 3 currency idr referenceno ans 40 {{merchant}} reference number ord20221208 paymethod n 2 docid\ ek 0djw7nuhytcda4sa3p 05 amt n 12 {{paymentproduct}} amount 2000 cancelamt n 12 cancel amount reqdt n 8 transaction request date ( yyyymmdd ) 20221208 reqtm n 6 transaction request time ( hh24miss ) 111119 transdt n 8 transaction date ( yyyymmdd ) 20221208 transtm n 6 transaction time ( hh24miss ) 111234 instmntmon n 2 installment month null instmnttype n 2 docid\ wfsinjxqc2s9yubbybpep 1 cardno ans 20 masker card number null preauthtoken an 64 pre auth {{paymentproduct}} token null acqubankcd a 4 docid\ qbeq29lj53z vbvxtvb7l null issubankcd a 4 docid\ qbeq29lj53z vbvxtvb7l null vacctvaliddt n 8 va expiry date ( yyyymmdd ) null vacctvalidtm n 6 va expiry time ( hh24miss ) null vacctno n 16 {{bank}} {{va}} number null bankcd a 4 docid\ qbeq29lj53z vbvxtvb7l null payno n 12 {{paymentproduct}} number null mitracd a 4 docid 0upx1lyg1o2f4biu3ssp dana receiptcode ans 20 authorization number null recurringtoken an 64 recurring token null cctranstype n 2 docid 7pas vd5ylg4vdurmygwo null payvaliddt n 8 cvs expiry date ( yyyymmdd ) (cvs) null payvalidtm n 6 cvs expiry time ( hh24miss ) (cvs) null mrefno an 20 {{bank}} reference number ( {{directdebit}} ) null acqustatus n 2 purchase status 1 normal 2 recurring 3 pre auth 4 capture null cardexpyymm n 4 card expiry ( yymm ) null acqubanknm a 255 acquiring {{bank}} name null issubanknm a 255 issuing {{bank}} name null depositdt n 8 transaction deposit date ( yyyymmdd ) null deposittm n 6 transaction deposit time ( hh24miss ) null userid an 128 {{qris}} user id hash null shopid an 32 shop id null currency a 3 currency null goodsnm an 100 goods name test transaction {{nicepay}} riko adi setiawan billingnm a 100 buyer name riko adi setiawan status n 1 docid\ allhyf9mj hw8 mpz4tmu 0 additional response parameter for others status inquiry the following is additional response list {{information}} from request {{status}} inquiry in other {{transaction}} {{process}} es parameter type size description mitracd a 4 docid 0upx1lyg1o2f4biu3ssp (cvs, {{directdebit}} , {{ewallet}} , {{payloan}} ) payno n 12 cvs number (cvs) payvaliddt n 8 cvs expiry date ( yyyymmdd ) (cvs) payvalidtm n 6 cvs expiry time ( hh24miss ) (cvs) receiptcode ans 20 authorization code (cvs) mrefno an 20 {{bank}} reference number ( {{directdebit}} ) sample json for e wallet status inquiry json request { 	"timestamp" "20221208065959", 	"txid" "ionpaytest05202212081111197444", 	"imid" "ionpaytest", 	"referenceno" "ord20221208", 	"amt" "2000", 	"merchanttoken" "324a7d07d9f3fe30a3960b28af29a91fc30a33fb3332cf33d40394f30d1f399f" } json response { 	"txid" "ionpaytest05202212081111197444", 	"imid" "ionpaytest", 	"currency" "idr", 	"amt" "2000", 	"instmntmon" null, 	"instmnttype" "1", 	"referenceno" "ord20221208", 	"goodsnm" "test transaction nicepay riko adi setiawan", 	"paymethod" "05", 	"billingnm" "riko adi setiawan", 	"reqdt" "20221208", 	"reqtm" "111119", 	"status" "0", 	"resultcd" "0000", 	"resultmsg" "paid", 	"cardno" null, 	"preauthtoken" null, 	"acqubankcd" null, 	"issubankcd" null, 	"vacctvaliddt" null, 	"vacctvalidtm" null, 	"vacctno" null, 	"bankcd" null, 	"payno" null, 	"mitracd" "dana", 	"receiptcode" null, 	"cancelamt" null, 	"transdt" "20221208", 	"transtm" "111234", 	"recurringtoken" null, 	"cctranstype" null, 	"payvaliddt" null, 	"payvalidtm" null, 	"mrefno" null, 	"acqustatus" null, 	"cardexpyymm" null, 	"acqubanknm" null, 	"issubanknm" null, 	"depositdt" null, 	"deposittm" null, 	"paymentexpdt" null, 	"paymentexptm" null, 	"paymenttrxsn" null, 	"canceltrxsn" null, 	"userid" null, 	"shopid" null } java request //inquir registration// nicepay settimestamp("20221114114338"); nicepay setimid("ionpaytest"); nicepay setamt("2000"); nicepay setreferenceno("ord20221208"); nicepay setmerchanttoken(nicepay maketoken(nicepay getmerchanttoken()); nicepay settxid("ionpaytest05202212081111197444"); // request inquiry nicepay inquiry(); // response string // system out println("final response string " + nicepay getresponsestring()); string resultcd = nicepay get("resultcd"); string resultmsg = nicepay get("resultmsg"); string txid = nicepay get("txid"); string referenceno = nicepay get("referenceno"); string paymethod = nicepay get("paymethod"); string status = nicepay get("status") string amt = nicepay get("amt"); string transdt = nicepay get("transdt"); string transtm = nicepay get("transtm");