NICEPAY API
...
API GPN
Status Inquiry - API GPN
10 min
tentang api gpn status inquiry integrasi {{api}} status inquiry pada {{gpn}} 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 gpn status inquiry integrasi status inquiry pada {{gpn}} bertujuan supaya {{merchant}} dapat terhubung dengan {{sistem}} {{api}} untuk melakukan pemeriksaan {{status}} pada {{metodebayar}} {{gpn}} secara berkala 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 ketika {{notifikasi}} diterima dbprocessurl {{anda}} , kami sangat menganjurkan {{merchant}} untuk melakukan verifikasi {{notifikasi}} tersebut dengan menggunakan docid\ zir5hzgz6qsfbwjhgmolz 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\ rensver sruq1ckfo ntj request parameter for gpn status inquiry berikut ini adalah daftar {{parameter}} untuk melakukan request {{status}} inquiry pada {{proses}} {{transaksi}} {{gpn}} parameter tipe ukuran deskripsi contoh/catatan timestamp required required n 14 request timestamp ( yyyymmddhh24miss ) 20221114114338 txid required required an 30 transaction id ionpaytest01202212071629087180 imid required required an 10 {{merchant}} id ionpaytest referenceno required required ans 40 {{merchant}} order number 815123412341 amt required required n 12 transaction amount 10000 merchanttoken required required an 255 {{merchant}} token 4b11d820b0d2ef509715e7b923430643416efc0df4ca2ba2d4b66eb549e074bd response parameter for gpn status inquiry berikut ini adalah daftar response dari request {{status}} inquiry pada {{proses}} {{transaksi}} {{gpn}} 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 ionpaytest01202212071629087180 imid an 10 {{merchant}} id ionpaytest referenceno ans 40 {{merchant}} reference number 815123412341 paymethod n 2 docid\ iifmsruuw7j9vmwefjz97 09 amt n 12 {{paymentproduct}} amount 10000 cancelamt n 12 cancel amount null reqdt n 8 transaction request date ( yyyymmdd ) 20221207 reqtm n 6 transaction request time ( hh24miss ) 162908 transdt n 8 transaction date ( yyyymmdd ) 20221207 transtm n 6 transction time ( hh24miss ) 162908 depositdt n 8 transaction deposit date ( yyyymmdd ) null deposittm n 6 transaction deposit time ( hh24miss ) 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 instmnttype n 2 docid\ rt2c32s9hfl aohyoebv5 1 instmntmon n 2 installment month 1 cardno n 20 card number 62210082 0590 preauthtoken an 64 pre auth token null issubankcd a 4 docid\ ky4ppujot06atnie easf othr acqubankcd a 4 docid\ ky4ppujot06atnie easf bnin 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 {{paymentproduct}} number null mitracd a 4 docid\ tm257gq3dxgzf98uz0l33 null receiptcode ans 20 authorization number null recurringtoken an 255 recurring token (needed for recurring {{paymentproduct}} ) null cctranstype n 2 docid 5kylpx5mpjsl96c8mhoik 1 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 status {{bank}} acquiring 20 cardexpyymm n 4 card expiry ( yymm ) 2612 acqubanknm a 255 acquiring {{bank}} name bni issubanknm a 255 issuing {{bank}} name other paymentexpdt n 6 qr {{paymentproduct}} expiry date ( yyyymmdd ) null paymentexptm n 6 qr {{paymentproduct}} expiry time ( hh24miss ) null paymenttrxsn an 32 {{paymentproduct}} transaction number null canceltrxsn an 128 cancel transaction number null userid an 128 {{qris}} user id hash null shopid an 32 shop id null additional response parameter for others status inquiry berikut ini adalah {{informasi}} daftar response tambahan dari request {{status}} inquiry pada {{proses}} {{transaksi}} lainnya parameter tipe ukuran deskripsi contoh / catatan mitracd a 4 docid\ tm257gq3dxgzf98uz0l33 (cvs, {{directdebit}} , {{ewallet}} , {{payloan}} ) null payno n 12 cvs number (cvs) null payvaliddt n 8 cvs expiry date ( yyyymmdd ) (cvs) null payvalidtm n 6 cvs expiry time ( hh24miss ) (cvs) null receiptcode ans 20 authorization code (cvs) null mrefno an 20 {{bank}} reference number ( {{directdebit}} ) null sample json for gpn status inquiry json request { 	"timestamp" "20221114114338", 	"txid" "ionpaytest01202212071629087180", 	"imid" "ionpaytest", 	"referenceno" "815123412341", 	"amt" "10000", 	"merchanttoken" "4b11d820b0d2ef509715e7b923430643416efc0df4ca2ba2d4b66eb549e074bd" } json response { "txid" "ionpaytest01202212071629087180", "imid" "ionpaytest", "currency" "idr", "amt" "10000", "instmntmon" "1", "instmnttype" "1", "referenceno" "815123412341", "goodsnm" "test transaction nicepay", "paymethod" "09", "billingnm" "john doe", "reqdt" "20221207", "reqtm" "162908", "status" "0", "resultcd" "0000", "resultmsg" "paid", "cardno" "62210082 0590", "preauthtoken" null, "acqubankcd" "bnin", "issubankcd" "othr", "vacctvaliddt" null, "vacctvalidtm" null, "vacctno" null, "bankcd" null, "payno" null, "mitracd" null, "receiptcode" null, "cancelamt" null, "transdt" "20221207", "transtm" "162908", "recurringtoken" null, "cctranstype" "1", "payvaliddt" null, "payvalidtm" null, "mrefno" null, "acqustatus" "10", "cardexpyymm" "2612", "acqubanknm" "bni", "issubanknm" "other", "depositdt" null, "deposittm" null, "paymentexpdt" null, "paymentexptm" null, "paymenttrxsn" null, "canceltrxsn" null, "userid" null, "shopid" null } java request //inquiry registration// nicepay settimestamp("20221114114338"); nicepay setimid("ionpaytest"); nicepay setamt("10000"); nicepay setreferenceno("ordno20221202141217"); nicepay setmerchanttoken(nicepay maketoken(nicepay getmerchanttoken()); nicepay settxid("ionpaytest01202212071629087180"); // 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");