NICEPAY API
...
API Direct Debit
Status Inquiry - API Direct Debit
8 min
tentang api direct debit status inquiry integrasi {{api}} status inquiry pada {{directdebit}} 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 direct debit status inquiry integrasi {{status}} inquiry pada {{directdebit}} bertujuan supaya {{merchant}} dapat terhubung dengan {{sistem}} {{api}} untuk melakukan pemeriksaan {{status}} pada {{metodebayar}} {{directdebit}} 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\ rbnsw oylchgzx9nqiujg notification handling sangat berguna untuk meminimalisir terjadinya fraud kami sangat menganjurkan {{merchant}} untuk melakukan verifikasi notification handling temukan {{informasi}} lebih rinci mengenai notification handling pada docid\ qmftml6otjk0kiribsece request parameter for direct debit status inquiry berikut ini adalah daftar {{parameter}} untuk melakukan request {{status}} inquiry pada {{proses}} {{transaksi}} {{directdebit}} parameter tipe ukuran deskripsi contoh / catatan timestamp required required n 14 request timestamp ( yyyymmddhh24miss ) 20220521144206 txid required required an 30 transaction id tnicecp04104202205191442060467 imid required required an 10 {{merchant}} id tnicecp041 referenceno required required ans 40 {{merchant}} order number 20220519144204 amt required required n 12 transaction amount 2000 merchanttoken required required an 255 {{merchant}} token 415c63ed51b7fd1f8fb39b48138cd15d8edf301309b2330f7548970196a0073c response parameter for direct debit status inquiry berikut ini adalah daftar response dari request {{status}} inquiry pada {{proses}} {{transaksi}} {{directdebit}} parameter tipe ukuran deskripsi contoh / catatan resultcd n 4 docid 7o8nl7guqp asiwfdqi3v 0000 resultmsg an 255 result message docid\ wpcemazro xvnxz 1zaib unpaid txid an 30 transaction id tnicecp04104202205191442060467 imid an 10 {{merchant}} id tnicecp041 referenceno ans 40 {{merchant}} reference number 20220519144204 paymethod n 2 docid\ iifmsruuw7j9vmwefjz97 04 amt n 12 {{paymentproduct}} amount 2000 cancelamt n 12 cancel amount null reqdt n 8 transaction request date ( yyyymmdd ) 20220519 reqtm n 6 transaction request time ( hh24miss ) 144206 transdt n 8 transaction date ( yyyymmdd ) null transtm n 6 transction time ( hh24miss ) null depositdt n 8 transaction deposit date ( yyyymmdd ) null deposittm n 6 transaction deposit time ( hh24miss ) null mitracd a 4 docid\ tm257gq3dxgzf98uz0l33 null 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 ) null vacctvalidtm n 6 va expiry time ( hh24miss ) null vacctno n 20 virtual account no null bankcd a 4 docid\ ky4ppujot06atnie easf null payno n 12 cvs number (cvs) 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 ) null deposittm n 6 deposit time ( hh24miss ) null 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 billingnm a 100 buyer name john doe status n 1 docid c8dre3fj17cxu0kw8c7d 9 userid an 128 {{qris}} user id hash null shopid an 32 shop id null sample json for direct debit status inquiry json request { 	"timestamp" "20220521144206", 	"txid" "tnicecp04104202205191442060467", 	"imid" "tnicecp041", 	"referenceno" "20220519144204", 	"amt" "2000", 	"merchanttoken" "415c63ed51b7fd1f8fb39b48138cd15d8edf301309b2330f7548970196a0073c" } json response { "txid" "tnicecp04104202205191442060467", "imid" "tnicecp041", "currency" "idr", "amt" "2000", "instmntmon" null, "instmnttype" "1", "referenceno" "20220519144204", "goodsnm" "test transaction", "paymethod" "04", "billingnm" "john doe", "reqdt" "20220519", "reqtm" "144206", "status" "9", "resultcd" "0000", "resultmsg" "init", "cardno" null, "preauthtoken" null, "acqubankcd" null, "issubankcd" null, "vacctvaliddt" null, "vacctvalidtm" null, "vacctno" null, "bankcd" null, "payno" null, "mitracd" null, "receiptcode" null, "cancelamt" null, "transdt" null, "transtm" null, "recurringtoken" null, "cctranstype" null, "payvaliddt" null, "payvalidtm" null, "mrefno" null, "acqustatus" null, "cardexpyymm" null, "acqubanknm" null, "issubanknm" null, "depositdt" null, "deposittm" null, "paymentexpdt" null, "paymentexptm" null, "paymenttrxsn" null, "canceltrxsn" null, "userid" null, "shopid" null } java request //inquiry registration// nicepay settimestamp("20220521144206"); nicepay setimid("tnicecp041"); nicepay setamt("2000"); nicepay setreferenceno("20220519144204"); nicepay setmerchanttoken(nicepay maketoken(nicepay getmerchanttoken()); nicepay settxid("tnicecp04104202205191442060467"); // 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");