Status Inquiry - API QRIS

about api qris status inquiry integration of {{the}} status inquiry {{api}} into {{qris}} is required so that {{merchant}} s can check {{the}} ongoing {{status}} of {{the}} {{transaction}} {{process}} carried out by {{the}} {{customer}} , whether {{the}} {{status}} is a success, failed, and others so {{the}} {{system}} can have a report on that {{information}} api qris status inquiry the {{integration}} of inquiry status into {{qris}} aims to enable {{merchant}} s to connect with {{the}} {{api}} {{system}} to check {{the}} {{status}} of {{the}} {{qris}} {{paymethod}} 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}} , we strongly encourage {{merchant}} s to verify {{the}} {{notification}} using {{the}} status inquiry api qris docid\ i34g2mhsezzv2y4d1bj7y 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 notification api qris docid\ fkrw0apx8bvolhgtwagl8 request parameter for qris status inquiry the following is a list of {{parameter}} s for requesting a {{status}} inquiry in {{the}} {{qris}} {{transaction}} {{process}} parameter type size description example / notes timestamp required required n 14 request timestamp ( yyyymmddhh24miss ) 20221208091279 txid required required an 30 transaction id ionpaytest08202212080918308275 imid required required an 10 {{merchant}} id ionpaytest referenceno required required ans 40 {{merchant}} order number ord54321 amt required required n 12 transaction amount 5 merchanttoken required required an 255 {{merchant}} token 52d30865f174e445cf731403b010ae099314edea9c399f7940fb2020d4045465 response parameter for qris status inquiry the following is a list of responses to requests for {{status}} inquiry in {{the}} {{qris}} {{transaction}} {{process}} parameter type size description example / notes resultcd n 4 result code docid 2r5sr3xvppu1eju1nitg 0000 resultmsg an 255 result message error code docid 4 fpewlvczfhcvygxwck9 paid txid an 30 transaction id ionpaytest08202212080918308275 imid an 10 {{merchant}} id ionpaytest referenceno ans 40 {{merchant}} reference number ord54321 paymethod n 2 payment method code docid\ ek 0djw7nuhytcda4sa3p 08 amt n 12 {{paymentproduct}} amount 5 cancelamt n 12 cancel amount null reqdt n 8 transaction request date ( yyyymmdd ) 20221208 reqtm n 6 transaction request time ( hh24miss ) 091830 transdt n 8 transaction date ( yyyymmdd ) 20221208 transtm n 6 transaction time ( hh24miss ) 091949 depositdt n 8 transaction deposit date ( yyyymmdd ) null deposittm n 6 transaction deposit time ( hh24miss ) mitracd a 4 mitra code docid 0upx1lyg1o2f4biu3ssp qshp instmntmon n 2 installment month null instmnttype n 2 installment type code docid\ wfsinjxqc2s9yubbybpep 1 cardno n 20 {{cc}} number null preauthtoken an 64 pre auth token null acqubankcd a 4 bank code docid\ qbeq29lj53z vbvxtvb7l null issubankcd a 4 bank code docid\ qbeq29lj53z vbvxtvb7l null vacctvaliddt n 8 va expiry date ( yyyymmdd ) null vacctvalidtm n 6 va expiry time ( hh24miss ) null vacctno n 20 {{va}} number null bankcd a 4 bank code docid\ qbeq29lj53z vbvxtvb7l null payno n 12 cvs number (cvs) null (for cvs) receiptcodef ans 20 authorization number null (for {{directdebit}} ) recurringtoken an 64 recurring {{paymentproduct}} token null (for cc) cctranstype n 2 payment status code docid 7pas vd5ylg4vdurmygwo null (for cc) 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 (for cc) cardexpyymm n 4 card expiration ( yymm ) null (for cc) acqubanknm a 4 acquiring {{bank}} name null (for cc) issubanknm a 255 issuing {{bank}} name depositdt n 8 deposit date ( yyyymmdd ) null (for va) deposittm n 6 deposit time ( hh24miss ) null (for va) paymentexpdt n 6 qr {{paymentproduct}} expiry date ( yyyymmdd ) 20221208 paymentexptm n 6 qr {{paymentproduct}} expiry time ( hh24miss ) 092330 paymenttrxsn n 32 {{paymentproduct}} transaction number 115045570008290314 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 andi pamungkas status n 1 payment status code docid\ allhyf9mj hw8 mpz4tmu 0 userid an 128 {{qris}} user id hash 115045570008290314 shopid an 32 shop id {{nicepay}} additional response parameter for qris status inquiry the following is {{information}} on a list of additional responses to requests for {{status}} inquiry in {{the}} {{qris}} {{transaction}} {{process}} parameter type size description mitracd a 4 mitra code docid 0upx1lyg1o2f4biu3ssp cancelamt n 12 cancel amount paymenttrxsn n 32 {{paymentproduct}} transaction number paymentexpdt n 6 qr {{paymentproduct}} expiry date ( yyyymmdd ) shopid an 32 shop id paymentexptm n 6 qr {{paymentproduct}} expiry time ( hh24miss ) canceltrxsn an 32 cancel transaction number userid an 128 {{qris}} user id hash sample json for qris status inquiry json request { 	"timestamp" "20221208091279", 	"txid" "ionpaytest08202212080918308275", 	"imid" "ionpaytest", 	"referenceno" "ord54321", 	"amt" "5", 	"merchanttoken" "52d30865f174e445cf731403b010ae099314edea9c399f7940fb2020d4045465" } json response { "txid" "ionpaytest08202212080918308275", "imid" "ionpaytest", "currency" "idr", "amt" "5", "instmntmon" null, "instmnttype" "1", "referenceno" "ord54321", "goodsnm" "test transaction nicepay", "paymethod" "08", "billingnm" "andi pamungkas", "reqdt" "20221208", "reqtm" "091830", "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" "qshp", "receiptcode" null, "cancelamt" null, "transdt" "20221208", "transtm" "091949", "recurringtoken" null, "cctranstype" null, "payvaliddt" null, "payvalidtm" null, "mrefno" null, "acqustatus" null, "cardexpyymm" null, "acqubanknm" null, "issubanknm" null, "depositdt" null, "deposittm" null, "paymentexpdt" "20221208", "paymentexptm" "092330", "paymenttrxsn" "115045570008290314", "canceltrxsn" null, "userid" "115045570008290314", "shopid" "nicepay" } java request //inquiry registration// nicepay settimestamp("20221208091279"); nicepay setimid("ionpaytest"); nicepay setamt("10000"); nicepay setreferenceno("ordno20221202141217"); nicepay setmerchanttoken(nicepay maketoken(nicepay getmerchanttoken()); nicepay settxid("ionpaytest08202212080918308275"); // 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"); string shopid = nicepay get("shopid");