Status Inquiry - API Credit Card

tentang status inquiry api credit card integrasi dengan {{api}} status inquiry pada {{kartukredit}} diperlukan supaya {{merchant}} dapat memeriksa {{status}} pada {{proses}} {{transaksi}} {{yang}} sedang berlangsung baik berstatus success , fail , dan lainnya status inquiry api credit card integrasi {{status}} inquiry pada {{kartukredit}} bertujuan supaya {{merchant}} dapat terhubung dengan {{sistem}} {{api}} untuk melakukan pemeriksaan {{status}} pada {{metodebayar}} {{kartukredit}} 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 9ivqi i4yka9s1oz6s ha notification handling sangat berguna untuk meminimalisir terjadinya fraud kami sangat menganjurkan {{merchant}} untuk memverifikasi notification handling {{anda}} dapat membaca {{informasi}} lebih rinci mengenai notification handling pada {{halaman}} docid\ do348g2rqnzztjpbhei43 request parameter for status inquiry api credit card berikut ini adalah daftar {{parameter}} untuk melakukan request {{status}} inquiry pada {{proses}} {{transaksi}} {{kartukredit}} parameter tipe ukuran deskripsi contoh / catatan timestamp required required n 14 request timestamp ( yyyymmddhh24miss ) 20221214091282 txid required required an 30 transaction id ionpaytest01202212140949101366 imid required required an 10 {{merchant}} id ionpaytest referenceno required required ans 40 {{merchant}} order number ordno20221214091293 amt required required n 12 transaction amount 5000 merchanttoken required required an 255 {{merchant}} token 7eceb5801db4e039223698c4eb9 response parameter for status inquiry api credit card berikut ini adalah daftar response dari pengajuan {{status}} inquiry pada {{proses}} {{transaksi}} {{kartukredit}} parameter tipe ukuran deskripsi contoh / catatan resultcd n 4 docid 7o8nl7guqp asiwfdqi3v 0000 resultmsg an 255 result message docid\ wpcemazro xvnxz 1zaib p aid txid an 30 transaction id ionpaytest01202212140949101366 imid an 10 {{merchant}} id ionpaytest currency a 3 currency idr instmntmon n 2 installment month 1 instmnttype n 2 docid\ rt2c32s9hfl aohyoebv5 1 referenceno ans 40 {{merchant}} reference number ordno20221214091293 paymethod n 2 docid\ iifmsruuw7j9vmwefjz97 01 amt n 12 {{paymentproduct}} amount 5000 cancelamt n 12 cancel amount null reqdt n 8 transaction request date ( yyyymmdd ) 20221214 reqtm n 6 transaction request time ( hh24miss ) 094910 status n 1 docid 5kylpx5mpjsl96c8mhoik 0 transdt n 8 transaction date ( yyyymmdd ) 20221214 transtm n 6 transaction time ( hh24miss ) 094910 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 goods billingnm a 100 buyer name john doe status n 1 docid c8dre3fj17cxu0kw8c7d 0 additional response parameter for status inquiry api credit card berikut ini adalah {{informasi}} daftar response tambahan dari request {{status}} inquiry pada {{proses}} {{transaksi}} {{kartukredit}} parameter tipe ukuran deskripsi catatan / contoh authno n 10 auth number 101366 issubankcd a 4 docid\ ky4ppujot06atnie easf othr acqubankcd a 4 docid\ ky4ppujot06atnie easf bmri acqubanknm a 255 acquiring {{bank}} name mandiri 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 {{paymentproduct}} number null mitracd a 4 docid\ tm257gq3dxgzf98uz0l33 null receiptcode ans 20 authorization number null cancelamt n 12 cancel amount null payvaliddt n 8 cvs expiry date ( yyyymmdd ) null payvalidtm n 6 cvs expiry time ( hh24miss ) null mrefno an 20 {{bank}} reference number issubanknm a 100 issuing {{bank}} name other paymentexpdt n 6 {{paymentproduct}} expiry date ( yyyymmdd ) null paymentexptm n 6 {{paymentproduct}} expiry time ( hh24miss ) null paymenttrxsn an 32 {{paymentproduct}} transaction number null userid an 128 {{qris}} user id hash null shopid an 32 shop id null cardno ans 20 masked card number 453211 1111 cardexpyymm n 4 card expiration ( yymm ) 2712 instmntmon n 2 installment month 1 instmnttype n 2 docid\ rt2c32s9hfl aohyoebv5 1 preauthtoken an 255 pre auth token (needed for capture {{paymentproduct}} ) null recurringtoken an 255 recurring token (needed for recurring {{paymentproduct}} ) null cctranstype n 2 docid 5kylpx5mpjsl96c8mhoik 1 acqustatus n 2 purchase status 1 normal 2 recurring 3 pre auth 4 capture 10 acquirerdata array 20 a dynamic array consisting of a unique reference number rrn that is provided by {{the}} {{bank}} ing {{partner}} when a refund is {{process}} ed this reference number can be used by {{the}} {{customer}} to track {{the}} {{status}} of {{the}} refund with {{the}} {{bank}} "acquirerdata" { "rrn" "332608321717" } latestfailhistory array object failed records are only displayed if the transaction fails and 1 transaction may have more than 1 failed record if the merchant has a retry mechanism "latestfailhistory" \[ { "resultcd" "1231", "resultmsg" "fail 3ds", "transdt" "20240707", "transtm" "121213" } ] sample parameter for status inquiry api credit card request parameter curl curl location 'https //dev nicepay co id/nicepay/direct/v2/inquiry' \\ \ header 'content type application/json' \\ \ data '{ &#x9;"timestamp" "20221214091282", &#x9;"txid" "ionpaytest01202212140949101366", &#x9;"imid" "ionpaytest", "merchanttoken" "7eceb5801db4e039223698c4eb9871432217132d8b0483122001a2569e8c7537", &#x9;"referenceno" "ordno20221214091293", &#x9;"amt" "5000" }' node js const config = { isproduction true, iscloudserver false, merchantkey "your merchant key", clientid "ionpaytest", privatekey cons privatekey, clientsecret cons clientsecret, }; const parameter = { timestamp "20221214091282", txid "ionpaytest01202212140949101366", imid "ionpaytest", referenceno "ordno20221214091293", amt "5000", }; const secondversion = new secondapiversion(config); const response = await secondversion requestapi(parameter, "/direct/v2/inquiry"); console log("inquiry response ", response); config = nicepay builder() isproduction(false) iscloudserver(false) timestamp("20221214091282") build(); string timestamp = "20221214091282"; string imid = "ionpaytest"; string merchantkey = testingconstants merchant key; string reffno = "ordno20221214091293"; string amount = "5000"; inquirystatus requestdata = inquirystatus builder() timestamp(timestamp) txid("ionpaytest01202212140949101366") imid(imid) referenceno(reffno) merchanttoken(timestamp, imid, reffno, amount, merchantkey) amt(amount) build(); nicepayresponsev2 result = v2cardservice callv2inquirystatus(requestdata, config); system out println("inquiry response " + result); bodyinquiry = ( builderinquiry buildinquiry() settxid("ionpaytest01202212140949101366") setreferenceno("ordno20221214091293") setamt("5000") build() ) environment = ( builderenvironment buildenvironment() iscloud(false) isproduction(false) build() ) response = servicenicepay serviceinquiry( datagenerator getinquirybody(bodyinquiry jsoninquiry()), environment ) c# string merchantkey = config merkey; string clientid = config clientid; string timestamp = "20221214091282"; string txid = "ionpaytest01202212140949101366"; string refno = "ordno20221214091293"; string amount = "5000"; bool isproduction = true; bool iscloudserver = false; // generate merchant token using provided json values var builder = new merchanttokenbuilder() settimestamp(timestamp) setimid(clientid) settxid(txid) setamount(amount) setmerchantkey(merchantkey); string merchanttoken = builder buildmerchanttoken(); console writeline("create merchant token " + merchanttoken); // build check status request using json values var bodybuilder = new nicepayrequestbuilder() setcheckstatus( imid clientid, timestamp timestamp, txid txid, amt amount, referenceno refno, merchanttoken merchanttoken ); apiendpoints apiendpoints = new apiendpoints(); dictionary\<string, object> payload = bodybuilder build(); string jsonpayload = newtonsoft json jsonconvert serializeobject(payload); var checkstatusservice = new nicepayregistrationservice(apiendpoints, isproduction, iscloudserver); var result = await checkstatusservice sendpostasync(apiendpoints inquiryv2, payload); laravel protected $useprod = false; protected $usecloud = false; protected $inquiry endpoint = "/nicepay/direct/v2/inquiry"; $url = httputil getnicepaydomain($this >useprod, $this >usecloud) $this >inquiry endpoint; // request body parameter from json $timestamp = "20221214091282"; $txid = "ionpaytest01202212140949101366"; $reference no = "ordno20221214091293"; $amt = "5000"; $merchant token = "7eceb5801db4e039223698c4eb9871432217132d8b0483122001a2569e8c7537"; $body = \[ "timestamp" => $timestamp, "txid" => $txid, "imid" => "ionpaytest", "merchanttoken" => $merchant token, "referenceno" => $reference no, "amt" => $amt, ]; try { $response = httputil postjsonrequest($url, $body); } catch (\exception $e) { echo "inquiry failed " $e >getmessage(); } php native $timestamp = "20221214091282"; $txid = "ionpaytest01202212140949101366"; $imid = "ionpaytest"; $referenceno = "ordno20221214091293"; $amount = "5000"; $config = $this >v2config; $parameter = inquirystatus builder() >settimestamp($timestamp) >settxid($txid) >setimid($imid) >setmerchanttoken($timestamp, $imid, $referenceno, $amount, $this >merchantkey) >setreferenceno($referenceno) >setamt($amount) >build(); $cardservice = new v2cardservice($config); $response = $cardservice >inquirystatus($parameter); val request directv2checkstatus = directv2checkstatus builder() timestamp("20221214091282") txid("ionpaytest01202212140949101366") imid("ionpaytest") merchantkey(default merchant key) referenceno("ordno20221214091293") amt("5000") build() val response nicepayresponsev2 = v2cardservice checkstatus(request, config)!! codeigniter $timestamp = "20221214091282"; $reffno = "ordno20221214091293"; $amount = "5000"; $config = $this >v2config; $parameter = inquirystatus builder() >settimestamp($timestamp) >settxid("ionpaytest01202212140949101366") >setimid("ionpaytest") >setmerchanttoken($timestamp, "ionpaytest", $reffno, $amount, $this >merchantkey) >setreferenceno($reffno) >setamt($amount) >build(); $v2cardservice = new v2cardservice($config); $response = $v2cardservice >inquirystatus($parameter); response parameter sample response { "txid" "ionpaytest01202212140949101366", "imid" "ionpaytest", "currency" "idr", "amt" "5000", "instmntmon" "1", "instmnttype" "1", "referenceno" "ordno20221214091293", "goodsnm" "goods", "paymethod" "01", "billingnm" "hantu kesorean", "reqdt" "20221214", "reqtm" "094910", "status" "0", "resultcd" "0000", "resultmsg" "paid", "cardno" "453211 1111", "preauthtoken" null, "acqubankcd" "bmri", "issubankcd" "othr", "vacctvaliddt" null, "vacctvalidtm" null, "vacctno" null, "bankcd" null, "payno" null, "mitracd" null, "receiptcode" null, "cancelamt" null, "transdt" "20221214", "transtm" "094910", "recurringtoken" null, "cctranstype" "1", "payvaliddt" null, "payvalidtm" null, "mrefno" null, "acqustatus" "10", "cardexpyymm" "2712", "acqubanknm" "mandiri", "issubanknm" "other", "depositdt" null, "deposittm" null, "paymentexpdt" null, "paymentexptm" null, "paymenttrxsn" null, "canceltrxsn" null, "userid" null, "shopid" null, "authno" "101366", "acquirerdata" { "rrn" null } }