NICEPAY API
...
API QRIS
Status Inquiry - API QRIS
10 min
tentang api qris status inquiry integrasi {{api}} status inquiry pada {{qris}} diperlukan supaya {{merchant}} dapat memeriksa {{status}} {{yang}} berlangsung pada {{proses}} {{transaksi}} dengan {{status}} success , fail , dan lainnya sehingga, {{sistem}} dapat memiliki laporan mengenai {{informasi}} tersebut api qris status inquiry integrasi status inquiry pada {{qris}} bertujuan bagi {{merchant}} agar dapat terhubung dengan {{sistem}} {{api}} untuk melakukan pemeriksaan {{status}} pada {{metodebayar}} {{qris}} api end point /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 ketika {{notifikasi}} diterima dbprocessurl {{anda}} , kami sangat memberi saran kepada {{merchant}} untuk melakukan verifikasi {{notifikasi}} tersebut dengan menggunakan docid\ jcwrygsjvj1sguu6dxmfj notification handling sangat berguna untuk meminimalisir terjadinya fraud kami sangat menganjurkan {{merchant}} untuk melakukan verifikasi notification handling {{anda}} dapat membaca {{informasi}} lebih rinci mengenai notification handling pada docid\ zzxkululcjp h2pulm2ai request parameter for qris status inquiry berikut ini adalah daftar {{parameter}} untuk melakukan request {{status}} inquiry pada {{proses}} {{transaksi}} {{qris}} parameter tipe ukuran deskripsi contoh / catatan 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 berikut ini adalah daftar response dari request status inquiry pada proses transaksi qris parameter tipe ukuran deskripsi contoh / catatan resultcd n 4 docid 7o8nl7guqp asiwfdqi3v 0000 resultmsg an 255 result message docid\ wpcemazro xvnxz 1zaib paid txid an 30 transaction id ionpaytest08202212080918308275 imid an 10 {{merchant}} id ionpaytest referenceno ans 40 {{merchant}} reference number ord54321 paymethod n 2 docid\ iifmsruuw7j9vmwefjz97 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 transction time ( hh24miss ) 091830 depositdt n 8 transaction deposit date ( yyyymmdd ) null deposittm n 6 transaction deposit time ( hh24miss ) mitracd a 4 docid\ tm257gq3dxgzf98uz0l33 qshp instmntmon n 2 installment month null instmnttype n 2 docid\ rt2c32s9hfl aohyoebv5 1 cardno n 20 {{cc}} number null preauthtoken an 64 pre auth token null acqubankcd a 4 docid\ ky4ppujot06atnie easf null issubankcd a 4 docid\ ky4ppujot06atnie easf 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 docid\ ky4ppujot06atnie easf 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 docid 5kylpx5mpjsl96c8mhoik 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 null (for cc) 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 docid c8dre3fj17cxu0kw8c7d 0 userid an 128 {{qris}} user id hash 115045570008290314 shopid an 32 shop id {{nicepay}} additional response parameter for qris status inquiry berikut ini adalah {{informasi}} daftar response tambahan dari request {{status}} inquiry pada {{proses}} {{transaksi}} {{qris}} parameter tipe ukuran deskripsi mitracd a 4 docid\ tm257gq3dxgzf98uz0l33 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");