NICEPAY API
...
Payment API
API Payloan
Status Inquiry - API Payloan
10 min
about api payloan status inquiry integration of {{the}} status inquiry {{api}} in {{payloan}} is required so that {{merchant}} s can check {{the}} ongoing {{status}} of {{the}} {{transaction}} {{process}} carried out by {{the}} {{customer}} whether {{the}} {{status}} is success, fail, and others so, {{the}} {{system}} can have a report on that {{information}} api payloan status inquiry integration of inquiry status on {{the}} {{payloan}} aims to enable {{merchant}} s to connect with {{the}} {{api}} {{system}} to check {{the}} {{status}} of {{payloan}} {{paymethod}} s regularly 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 when your dbprocessurl received a {{notification}} , {{nicepay}} strongly encourage {{merchant}} s to verify {{the}} {{notification}} using {{the}} status inquiry api payloan docid\ ikbnpmy56gww3hk0v3emu notification handling is very useful to minimize {{the}} risk of fraud we strongly encourage {{merchant}} s to verify notification handling you can read more detailed {{information}} about notification handling on notification api payloan docid\ mx4cicfhpck1zbto ufek {{page}} request parameter for payloan status inquiry the following is a list of responses to request {{status}} inquiries on {{payloan}} {{transaction}} {{process}} es parameter type size description example / notes timestamp required required n 14 request timestamp ( yyyymmddhh24miss ) 20221114114338 txid required required an 30 transaction id payloantes06202212051018325178 imid required required an 10 {{merchant}} id payloantes referenceno required required ans 40 {{merchant}} order number ord12345 amt required required n 12 transaction amount 10000 merchanttoken required required an 255 {{merchant}} token 3a04d0c8581ae37727f87130a0b32f2fe9fe39c66b88347352e7b90aeb5cb6e6 response parameter for payloan status inquiry the following is a list of responses to request {{status}} inquiries on {{payloan}} {{transaction}} {{process}} es parameter type size description example / notes resultcd n 4 result code docid 2r5sr3xvppu1eju1nitg 0000 resultmsg an 255 result message error code docid 4 fpewlvczfhcvygxwck9 init txid an 30 transaction id payloantes06202212051018325178 imid an 10 {{merchant}} id payloantes referenceno ans 40 {{merchant}} reference number ord12345 paymethod n 2 payment method code docid\ ek 0djw7nuhytcda4sa3p 06 amt n 12 {{paymentproduct}} amount 10000 cancelamt n 12 cancel amount null reqdt n 8 transaction request date ( yyyymmdd ) 20221205 reqtm n 6 transaction request time ( hh24miss ) 101832 transdt n 8 transaction date ( yyyymmdd ) null transtm n 6 transaction time ( hh24miss ) null 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 payment status code docid\ allhyf9mj hw8 mpz4tmu 9 instmntmon n 2 installment month 1 instmnttype n 2 installment type code docid\ wfsinjxqc2s9yubbybpep 2 cardno n 20 {{cc}} number null preauthtoken an 64 pre auth token null acqubankcd a 4 bank code docid\ qbeq29lj53z vbvxtvb7l null issubankcd a 4 bank code docid\ qbeq29lj53z vbvxtvb7l null 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 bank code docid\ qbeq29lj53z vbvxtvb7l null payno n 12 {{paymentproduct}} number null mitracd a 4 mitra code docid 0upx1lyg1o2f4biu3ssp kdvi receiptcode ans 20 authorization number null cancelamt n 12 cancel amount null recurringtoken an 255 recurring token (needed for recurring {{paymentproduct}} ) cctranstype n 2 payment status code docid 7pas vd5ylg4vdurmygwo null 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 purchase status 1 normal 2 recurring 3 pre auth 4 capture null cardexpyymm n 4 expiry ( yymm ) null acqubanknm a 255 acquiring {{bank}} name null issubanknm a 255 issuing {{bank}} name null paymentexpdt n 6 qr {{paymentproduct}} expiry date ( yyyymmdd ) null paymentexptm n 6 qr {{paymentproduct}} expiry time ( hh24miss ) null canceltrxsn an 32 cancel transaction number null userid an 128 {{qris}} user id hash null shopid an 32 shop id null additional response parameter for payloan status inquiry the following is additional response list {{information}} from request {{status}} inquiry in other {{transaction}} {{process}} es parameter type size description mitracd a 4 mitra code docid 0upx1lyg1o2f4biu3ssp (cvs, {{directdebit}} , {{ewallet}} , {{payloan}} ) payno n 12 cvs number (cvs) payvaliddt n 8 cvs expiry date ( yyyymmdd ) (cvs) payvalidtm n 6 cvs expiry time ( hh24miss ) (cvs) receiptcode ans 20 authorization code (cvs) mrefno an 20 {{bank}} reference number ( {{directdebit}} ) sample json for payloan status inquiry json request { 	"timestamp" "20221114114338", 	"txid" "payloantes06202212051018325178", 	"imid" "payloantes", 	"referenceno" "ord12345", 	"amt" "10000", 	"merchanttoken" "3a04d0c8581ae37727f87130a0b32f2fe9fe39c66b88347352e7b90aeb5cb6e6" } json response { "txid" "payloantes06202212051018325178", "imid" "payloantes", "currency" "idr", "amt" "10000", "instmntmon" "1", "instmnttype" "2", "referenceno" "ord12345", "goodsnm" "test transaction nicepay", "paymethod" "06", "billingnm" "john doe", "reqdt" "20221205", "reqtm" "101832", "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" "kdvi", "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("20221208091279"); nicepay setimid("ionpaytest"); nicepay setamt("10000"); nicepay setreferenceno("ordno20221202141217"); nicepay setmerchanttoken(nicepay maketoken(nicepay getmerchanttoken()); nicepay settxid("ionpaytest08202212080918308275"); // 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");