Status Inquiry - API Paylater
10 min
about api paylater status inquiry integration of status inquiry in is required so that s can check ongoing of carried out by whether is success, fail, and others so, can have a report on that api paylater status inquiry integration of inquiry status on aims to enable s to connect with to check of s regularly api end point /nicepay/direct/v2/inquiry request method \<font color="#3b9f0f">post\</font> description performs inquiry request to for status checking merchant token sha256( timestamp + imid + referenceno + amt + merchantkey ) request format application/json when your dbprocessurl received a , strongly encourage s to verify using status inquiry api paylater docid\ c7by1comgvlnauoqjixnx notification handling is very useful to minimize risk of fraud we strongly encourage s to verify notification handling you can read more detailed about notification handling on notification api paylater docid\ s6hf8ym1 sq0qmtglzwgy request parameter for paylater status inquiry the following is a list of responses to request inquiries on es parameter type size description example / notes timestamp \<font color="#2166ae">required\</font> n 14 request timestamp ( yyyymmddhh24miss ) 20221114114338 txid \<font color="#2166ae">required \</font> an 30 transaction id payloantes06202212051018325178 imid \<font color="#2166ae">required \</font> an 10 id payloantes referenceno \<font color="#2166ae">required\</font> ans 40 order number ord12345 amt \<font color="#2166ae">required \</font> n 12 transaction amount 10000 merchanttoken \<font color="#2166ae">required \</font> an 255 token 3a04d0c8581ae37727f87130a0b32f2fe9fe39c66b88347352e7b90aeb5cb6e6 response parameter for paylater status inquiry the following is a list of responses to request inquiries on es parameter type size description example / notes resultcd n 4 result code docid 9ec3yh9cqqpb6crwauwwo 0000 resultmsg an 255 result message error code docid\ fsx1gesjkxop0t9rvuhp init txid an 30 transaction id payloantes06202212051018325178 imid an 10 id payloantes referenceno ans 40 reference number ord12345 paymethod n 2 payment method code docid\ nq1y7vma25ztvqhn5he6w 06 amt n 12 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 billingnm a 100 buyer name john doe status n 1 payment status code docid\ qpnu5vtjkczpxfrhiayas 9 instmntmon n 2 installment month 1 instmnttype n 2 installment type code docid wzur5wjwhrdr8yxi ppi 2 cardno n 20 number null preauthtoken an 64 pre auth token null acqubankcd a 4 acquiring bank code docid\ hlxvgrxvxwd90n8ohnkm0 null issubankcd a 4 issuing bank code docid\ hlxvgrxvxwd90n8ohnkm0 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\ hlxvgrxvxwd90n8ohnkm0 null payno n 12 number null mitracd a 4 mitra code docid 0lup35kfowksisrzkx6yz kdvi receiptcode ans 20 authorization number null cancelamt n 12 cancel amount null recurringtoken an 255 recurring token (needed for recurring ) cctranstype n 2 credit card transaction type 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 reference number ( ) 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 name null issubanknm a 255 issuing name null paymentexpdt n 6 qr expiry date ( yyyymmdd ) null paymentexptm n 6 qr expiry time ( hh24miss ) null canceltrxsn an 32 cancel transaction number null userid an 128 user id hash null shopid an 32 shop id null additional response parameter for paylater status inquiry the following is additional response list from request inquiry in other es parameter type size description mitracd a 4 mitra code docid 0lup35kfowksisrzkx6yz (cvs, , , ) 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 reference number ( ) sample json for paylater 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");