NICEPAY API
API Versi 1
V1 Check Transaction Status
11min
tentang v1 check transaction status {{api}} ini berguna untuk memeriksa {{status}} {{transaksi}} ketika notifikasi di dbprocessurl sudah diterima, sangat disarankan bagi {{merchant}} untuk melakukan verifikasi menggunakan v1 check transaction status docid\ o 8bahmphnogvne8gmqcy ketika callbackurl sudah diterima, kami merekomendasikan para {{merchant}} untuk melakukan verifikasi status dengan menggunakan v1 check transaction status docid\ o 8bahmphnogvne8gmqcy callback handling berguna untuk mengurangi aksi fraud , kami merekomendasikan {{merchant}} untuk melakukan verifikasi dengan callback handling callback handling flow deskripsi langkah {{merchant}} melakukan checkout {{merchant}} mengajukan {{pembayaran}} kepada {{nicepay}} {{nicepay}} mengirimkan response callback dan hasil {{pembayaran}} ( callbackurl ) kepada {{merchant}} {{merchant}} memeriksa {{status}} {{merchant}} mengirimkan {{status}} kepada {{nicepay}} {{nicepay}} mengirimkan response ( final status flag ) kepada {{merchant}} api check transaction status api endpoint /nicepay/api/onepassstatus do request method application/x www form urlencoded application/x www form urlencoded post post description inquires {{transaction}} {{status}} to {{nicepay}} server merchant token sha256( imid + referenceno + amt + merchantkey ) notification handling tersebut sangat membantu untuk meminimalisir tindakan fraud , sangat disarankan bagi {{merchant}} untuk melakukan notification handling notification handling flow deskripsi langkah {{merchant}} melakukan checkout {{merchant}} mengirimkan {{pembayaran}} kepada {{nicepay}} {{nicepay}} mengirimkan url {{notifikasi}} ( dbprocessurl ) kepada {{merchant}} {{merchant}} memeriksa {{status}} {{merchant}} mengirimkan {{status}} kepada {{nicepay}} {{nicepay}} mengembalikan response ( final status flag ) kepada {{merchant}} request parameters check status check status request parameter // order status mandatory field nicepay settrxid("ionpaytest02201603091207051498"); nicepay setreferenceno("merchantreferencenumber001"); nicepay setamt("1000"); nicepay setmerchanttoken(nicepay maketoken(nicepay getamt(), nicepay getreferenceno())); // order status request nicepay orderstatus(); // order status response system out println("response string " + nicepay getresponsestring()); // json in string format nicepay gethtresponse(); // json in hashtable\<string, string> format string resultcd = nicepay get("resultcd"); string resultmsg = nicepay get("resultmsg"); string txid= nicepay get("txid "); string imid= nicepay get("imid"); string currency= nicepay get("currency"); string amount= nicepay get("amount"); string instmntmon= nicepay get("instmntmon"); string instmnttype= nicepay get("instmnttype"); string referenceno= nicepay get("referenceno"); string goodsnm = nicepay get("goodsnm"); string paymethod = nicepay get("paymethod"); string billingnm= nicepay get("billingnm"); string merchanttoken= nicepay get("merchanttoken"); string reqdt= nicepay get("reqdt"); string reqtm = nicepay get("reqtm"); string status = nicepay get("status"); string bankcd= nicepay get("bankcd"); string vacctvaliddt= nicepay get("vacctvaliddt"); string vacctvalidtm= nicepay get("vacctvalidtm"); string vacctno= nicepay get("vacctno"); parameter tipe ukuran deskripsi contoh / catatan imid required required an 10 {{merchant}} id ionpaytest merchanttoken required required an 255 {{merchant}} token 6cfccfc0046773c1b89d8e98c txid required required an 30 transaction id ionpaytest02201603091207051498 amt required required n 12 goods amount 1000 referenceno required required ans 40 {{merchant}} order number merchantreferencenumber001 response parameter check status check status response parameter { "txid" "normaltest01202002031344071337", "imid" "normaltest", "currency" "idr", "amt" "12000", "instmntmon" "1", "instmnttype" "1", "referenceno" "ord20200203130299", "goodsnm" "testing normal full payment cc va", "paymethod" "01", "billingnm" "customer name", "reqdt" "20200203", "reqtm" "134407", "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, "acquirerdata" { "rrn" "332510237487" } } parameter tipe ukuran deskipsi resultcd n 4 v1 nicepay code docid\ pnv6uw k42cisgzemke y resultmsg an 255 v1 nicepay code docid\ pnv6uw k42cisgzemke y txid an 30 transaction id referenceno ans 40 {{merchant}} reference number paymethod n 2 v1 nicepay code docid\ pnv6uw k42cisgzemke y amt n 12 {{paymentproduct}} amount reqdt n 8 transaction date ( yyyymmdd ) reqtm n 6 transaction time ( hh24miss ) currency a 3 currency goodsnm an 100 goods name billingnm an 30 billing name status n 1 v1 nicepay code docid\ pnv6uw k42cisgzemke y instmntmon n 2 installment month instmnttype n 2 v1 nicepay code docid\ pnv6uw k42cisgzemke y acquirerdata array 20 a dynamic array consisting of a unique reference number rrn that is provided by {{the}} banking {{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}} additional response for virtual account parameter tipe ukuran deskripsi vacctvaliddt n 8 batas tanggal va ( yyyymmdd ) vacctvalidtm n 6 batas waktu va ( hh24miss ) vacctno n 16 nomor va bankcd a 4 v1 nicepay code docid\ pnv6uw k42cisgzemke y additional response for qris parameter tipe ukuran deskripsi mitracd a 4 v1 nicepay code docid\ pnv6uw k42cisgzemke y (qris) cancelamt n 12 nominal pembatalan paymenttrxsn an 32 nomor pembayaran transaksi paymentexpdt n 6 batas waktu pembayaran qr ( yyyymmdd ) shopid an 32 shop id transtm n 6 tanggal transaksi ( hh24miss ) paymentexptm n 6 batas waktu pembayaran qr ( hh24miss ) canceltrxsn an 32 nomor pembatalan transaksi userid an 128 hash id pengguna {{qris}} transdt n 8 tanggal transaksi ( yyyymmdd ) depositdt n 8 tanggal transaksi terbayar ( yyyymmdd ) deposittm n 6 tanggal transaksi terbayar ( hh24miss ) additional response for others payment method parameter tipe ukuran deskripsi mitracd a 4 v1 nicepay code docid\ pnv6uw k42cisgzemke y (cvs, {{ewallet}} , {{payloan}} ) payno n 12 nomor pembayaran (cvs) payvaliddt n 8 batas tanggal pembayaran cvs ( yyyymmdd ) payvalidtm n 6 batas waktu pembayaran cvs ( hh24miss ) receiptcode ans 18 authorization number