Status Inquiry - API Virtual Account

about api virtual account status inquiry integration of {{the}} status inquiry {{api}} on {{va}} s 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 virtual account status inquiry integration inquiry status on {{the}} {{va}} aims so {{the}} {{merchant}} can connect to {{the}} {{api}} {{system}} to perform {{status}} checking on {{the}} {{va}} {{paymethod}} regularly 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 recommend {{merchant}} to verify {{the}} {{notification}} using {{the}} docid\ itcm3ihd d5tjo3i0zjen notification handling is very useful to minimize {{the}} risk of fraud we strongly encourage {{merchant}} s to verify notification handling using docid\ oljzaxwvjeidvpptpfwes request parameter for virtual account status inquiry the following is a list of {{parameter}} s for requesting a {{status}} inquiry in {{the}} {{va}} {{transaction}} {{process}} parameter type size description example / notes timestamp required required n 14 request timestamp ( yyyymmddhh24miss ) 20221215091222 txid required required an 30 transaction id normaltest02202212150929011967 imid required required an 10 {{merchant}} id normaltest referenceno required required ans 40 {{merchant}} order number ordno20221215091214 amt required required n 12 transaction amount 1000 merchanttoken required required an 255 {{merchant}} token ea6e691a895f1ccc0602f534205ee60bc552552dde7610062cd048ea6c87965e response parameter for virtual account status inquiry the following is a list of responses to requests for {{status}} inquiry on {{va}} {{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 normaltest02202212150929011967 imid an 10 {{merchant}} id normaltest referenceno ans 40 {{merchant}} reference number ordno20221215091214 paymethod n 2 docid\ ek 0djw7nuhytcda4sa3p 02 amt n 12 {{paymentproduct}} amount 10000 cancelamt n 12 cancel amount null reqdt n 8 transaction request date ( yyyymmdd ) 20221215 reqtm n 6 transaction request time ( hh24miss ) 092901 transdt n 8 transaction date ( yyyymmdd ) 20221215 transtm n 6 transction time ( hh24miss ) 092901 depositdt n 8 transaction deposit date ( yyyymmdd ) null deposittm n 6 transaction deposit time ( hh24miss ) null mitracd a 4 docid 0upx1lyg1o2f4biu3ssp alma instmntmon n 2 installment month null instmnttype n 2 docid\ wfsinjxqc2s9yubbybpep 1 cardno n 20 {{cc}} number null preauthtoken an 64 pre auth token null acqubankcd a 4 docid\ qbeq29lj53z vbvxtvb7l null issubankcd a 4 docid\ qbeq29lj53z vbvxtvb7l null vacctvaliddt n 8 va expiry date ( yyyymmdd ) 20221231 vacctvalidtm n 6 va expiry time ( hh24miss ) 235959 vacctno n 20 {{va}} number 9912304000001487 bankcd a 4 docid\ qbeq29lj53z vbvxtvb7l cena payno n 12 cvs number (cvs) null mitracd a 4 docid 0upx1lyg1o2f4biu3ssp null receiptcode ans 20 authorization number null recurringtoken an 64 recurring {{paymentproduct}} token null cctranstype n 2 docid 7pas vd5ylg4vdurmygwo null payvaliddt n 8 expiry date ( yyyymmdd ) null payvalidtm n 6 expiry time ( hh24miss ) null mrefno an 18 {{bank}} reference number null acqustatus n 2 purchase status 1 normal 2 recurring 3 pre auth 4 capture null cardexpyymm n 4 card expiration ( yymm ) null acqubanknm a 255 acquiring {{bank}} name null issubanknm a 255 issuing {{bank}} name null depositdt n 8 deposit date ( yyyymmdd ) 20221215 deposittm n 6 deposit time ( hh24miss ) 092936 paymentexpdt n 6 qr {{paymentproduct}} expiry date ( yyyymmdd ) null paymentexptm n 6 qr {{paymentproduct}} expiry time ( hh24miss ) null paymenttrxsn n 32 {{paymentproduct}} transaction number null cancelamt n 12 cancel amount null canceltrxsn an 32 cancel transaction number null currency a 3 currency idr goodsnm an 100 goods name test transaction nicepay billingnm a 100 buyer name john doe status n 1 docid\ allhyf9mj hw8 mpz4tmu 0 userid an 128 {{qris}} user id hash null shopid an 32 shop id null additional response parameter for virtual account status inquiry the following is a list of additional responses from {{the}} inquiry {{status}} request in {{the}} {{va}} {{transaction}} {{process}} parameter type size descriprion bankcd a 4 docid\ qbeq29lj53z vbvxtvb7l vacctno n 16 {{bank}} {{va}} number vacctvaliddt n 8 va expiry date ( yyyymmdd ) vacctvalidtm n 9 va expiry time ( hh24miss ) sample json for virtual account status inquiry json request { "timestamp" "20221215091222", "imid" "normaltest", "txid" "normaltest02202212150929011967", "referenceno" "ordno20221215091214", "amt" "10000", "merchanttoken" "ea6e691a895f1ccc0602f534205ee60bc552552dde7610062cd048ea6c87965e" } json response { "txid" "normaltest02202212150929011967", "imid" "normaltest", "currency" "idr", "amt" "10000", "instmntmon" null, "instmnttype" "1", "referenceno" "ordno20221215091214", "goodsnm" "goods", "paymethod" "02", "billingnm" "john doe", "reqdt" "20221215", "reqtm" "092901", "status" "0", "resultcd" "0000", "resultmsg" "paid", "cardno" null, "preauthtoken" null, "acqubankcd" null, "issubankcd" null, "vacctvaliddt" "20221231", "vacctvalidtm" "235959", "vacctno" "9912304000001487", "bankcd" "cena", "payno" null, "mitracd" null, "receiptcode" null, "cancelamt" null, "transdt" "20221215", "transtm" "092901", "recurringtoken" null, "cctranstype" null, "payvaliddt" null, "payvalidtm" null, "mrefno" null, "acqustatus" null, "cardexpyymm" null, "acqubanknm" null, "issubanknm" null, "depositdt" "20221215", "deposittm" "092936", "paymentexpdt" null, "paymentexptm" null, "paymenttrxsn" null, "canceltrxsn" null, "userid" null, "shopid" null } java request //virtual account inquiry// nicepay settimestamp("20221215091222"); nicepay settxid("normaltest02202212150929011967"); nicepay setimid("normaltest"); nicepay setreferenceno("ordno20221215091214"); nicepay setmerchanttoken(nicepay maketoken(nicepay getmerchanttoken()); nicepay setamt("10000"); //request virtual account inquiry nicepay vainquiry(); // response string // system out println("final response string " + nicepay getresponsestring()); string status = nicepay get("status"); string resultcd = nicepay get("resultcd"); string resultmsg = nicepay get("resultmsg"); string txid = nicepay get("txid"); string imid = nicepay get("imid"); string referenceno = nicepay get("referenceno"); string paymethod = nicepay get("paymethod"); string currency = nicepay get("currency"); string vacctvaliddt = nicepay get("vacctvaliddt"); string vacctvalidtm = nicepay get("vacctvalidtm"); string vacctno = nicepay get("vacctno"); string bankcd = nicepay get("bankcd"); string depositdt = nicepay get("depositdt"); string deposittm = nicepay get("deposittm"); string instmntmon = nicepay get("instmntmon"); string instmnttype = nicepay get("instmnttype"); string goodsnm = nicepay get("goodsnm"); string billingnm = nicepay get("billingnm"); string reqdt = nicepay get("reqdt"); string reqtm = nicepay get("reqtm"); string acqubankcd = nicepay get("acqubankcd"); string issubankcd = nicepay get("issubankcd"); string acqubanknm = nicepay get("acqubanknm") string issubanknm = nicepay get("issubanknm"); string transdt = nicepay get("transdt"); string transtm = nicepay get("transtm"); string cctranstype = nicepay get("cctranstype"); string acqustatus = nicepay get("acqustatus"); string cardno = nicepay get("cardno"); string cardexpyymm = nicepay get("cardexpyymm"); string authno = nicepay get("authno");