NICEPAY API
...
API Virtual Account
Status Inquiry - API Virtual Account
10 min
tentang api virtual account status inquiry integrasi {{api}} status inquiry pada {{va}} diperlukan supaya {{merchant}} dapat memeriksa {{status}} {{yang}} berlangsung pada {{proses}} {{transaksi}} {{yang}} dilakukan oleh {{pelanggan}} baik ber {{status}} success , fail , dan lainnya sehingga {{sistem}} dapat memiliki laporan mengenai {{informasi}} tersebut api virtual account status inquiry integrasi {{status}} inquiry pada {{va}} bertujuan supaya {{merchant}} dapat terhubung dengan {{sistem}} {{api}} untuk melakukan pengecekan {{status}} pada {{metodebayar}} {{va}} secara berkala 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 menyarankan {{merchant}} untuk melakukan verifikasi {{notifikasi}} tersebut dengan menggunakan docid\ gqrexfrfyfx9ofueguap4 ketika {{notifikasi}} diterima pada dbprocessurl {{anda}} , kami sangat menyarankan kepada {{merchant}} untuk melakukan verifikasi {{notifikasi}} kembali dengan menggunakan docid 7qwexamlznmh5n9xbp72f request parameter for virtual account status inquiry berikut ini adalah daftar {{parameter}} untuk melakukan request {{status}} inquiry pada {{proses}} {{transaksi}} {{va}} parameter tipe ukuran deskripsi contoh 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 berikut ini adalah daftar response dari request {{status}} inquiry pada {{proses}} {{transaksi}} {{va}} 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 normaltest02202212150929011967 imid an 10 {{merchant}} id normaltest referenceno ans 40 {{merchant}} reference number ordno20221215091214 paymethod n 2 docid\ iifmsruuw7j9vmwefjz97 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\ tm257gq3dxgzf98uz0l33 alma instmntmon n 2 installment month null instmnttype n 2 docid\ rt2c32s9hfl aohyoebv5 1 cardno n 20 credit card 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 ) 20221231 vacctvalidtm n 6 va expiry time ( hh24miss ) 235959 vacctno n 20 {{va}} number 9912304000001487 bankcd a 4 docid\ ky4ppujot06atnie easf cena payno n 12 cvs number (cvs) null mitracd a 4 docid\ tm257gq3dxgzf98uz0l33 null receiptcode ans 20 authorization number null recurringtoken an 64 recurring {{paymentproduct}} token null cctranstype n 2 docid 5kylpx5mpjsl96c8mhoik 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 c8dre3fj17cxu0kw8c7d 0 userid an 128 {{qris}} user id hash null shopid an 32 shop id null additional response parameter for virtual account status inquiry berikut ini adalah {{informasi}} daftar response tambahan dari request {{status}} inquiry pada {{proses}} {{transaksi}} {{va}} parameter tipe ukuran deskripsi bankcd a 4 docid\ ky4ppujot06atnie easf 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");