NICEPAY API
...
Advance API
Virtual Account - Advance API

NICEPAY Inquiry Virtual Account

23min
about api nicepay inquiry virtual account bulk {{integration}} uses for {{va}} nicepay inquiry virtual account type {{paymethod}} in this {{paymethod}} , {{merchant}} s maintain {{customer}} data so, every {{payment}} from a {{bank}} , {{nicepay}} requires {{customer}} data inquiry to {{the}} {{merchant}} also included for {{payment}} confirmation, {{nicepay}} makes a {{payment}} request to {{the}} {{merchant}} nicepay inquiry virtual account flow inquiry process nicepay to merchant this {{process}} aims to find out {{the}} details of {{the}} bill after {{nicepay}} gets an inquiry request from {{the}} {{bank}} {{nicepay}} will call {{the}} {{merchant}} {{service}} to get detailed {{customer}} data {{information}} then, {{the}} data will be stored in {{the}} internal history of {{the}} {{nicepay}} {{system}} and sent to {{the}} {{bank}} using {{the}} inquiry {{bank}} response format api url https // < merchant url for inquiry > request method post (body raw json) post (body raw json) merchant token request format inquiry request parameter the following is a list of {{parameter}} s to {{proceed}} {{the}} {{nicepay}} inquiry {{process}} to {{the}} {{merchant}} from {{the}} executed {{transaction}} on {{va}} 's nicepay inquiry virtual account type {{paymethod}} this {{parameter}} uses through {{the}} {{api}} {{testing}} platform as one of {{the}} stages so that {{the}} {{merchant}} 's {{system}} can connect with {{service}} s from {{nicepay}} parameter type size description example / notes customerid n 9 {{customer}} id 891011101 merchanttoken an 255 sha256 ( merchant id + customer id + merchant key ) 141fd2368aa80ea0e600b1b4d7a42c1e731e74a27a03521e8e28150cc00bc05b prefix n 7 {{va}} prefix number 7015102 bankcd an 4 bank code docid\ qbeq29lj53z vbvxtvb7l "cena inquiry response parameter following are {{the}} response {{parameter}} s from {{the}} results of {{the}} request {{parameter}} s for {{the}} {{nicepay}} to {{merchant}} inquiry process parameter type size description example / notes billingnm n 100 {{customer}} name john doe goodsnm an 100 goods/item name testing buying referenceno n 40 reference number for {{paymentproduct}} ordno20221130101148 amt an 12 total bill amount 5000 normal amount only resultcd n 4 result code docid 2r5sr3xvppu1eju1nitg of inquiry status 0000 resultmsg an 255 result message for {{the}} result code docid 2r5sr3xvppu1eju1nitg success sample json inquiry process nicepay to merchant json request { "customerid" "891011101", "merchanttoken" "141fd2368aa80ea0e600b1b4d7a42c1e731e74a27a03521e8e28150cc00bc05b", "prefix" "7015102", "bankcd" "cena" } json response { "resultcd" "0000", "resultmsg" "success", "billingnm" "john doe", "goodsnm" "testing buying", "referenceno" "ordno20221130101148", "amt" "5000" } java request //inquiry to merchant// nicepay setcustomerid("123456"); nicepay setprefix("000001"); nicepay setbankcd("cena"); nicepay setmerchanttoken(nicepay maketoken(nicepay getcustomerid()); //request inquiry// nicepay inquiry(); //response inquiry// string resultcd = nicepay get("resultcd"); string resultmsg = nicepay get("resultmsg"); string billingnm = nicepay get("billingnm"); string referenceno = nicepay get("referenceno"); string goodsnm = nicepay get("goodsnm"); string amt = nicepay get("amt"); payment process nicepay to merchant payment process nicepay to merchant is {{the}} stage to continue {{the}} {{payment}} {{process}} made by {{the}} {{customer}} when {{the}} {{bank}} makes a {{payment}} request to {{nicepay}} using a {{va}} number, {{nicepay}} will call {{the}} {{merchant}} {{payment}} url {{service}} to {{process}} {{the}} {{payment}} the {{merchant}} determines {{the}} {{payment}} response to accept or reject {{payment}} s from {{customer}} s api end point https // < {{merchant}} url for {{payment}} > method post (body raw json) post (body raw json) payment request parameter the following is a list of {{parameter}} s for {{proceed}} {{the}} nicepay to merchant payment process from {{transaction}} s made on {{the}} {{va}} 's nicepay inquiry virtual account type {{paymethod}} this {{parameter}} is used through {{the}} {{api}} {{testing}} platform as one of {{the}} stages so that {{the}} {{merchant}} 's {{system}} can be connected to {{service}} s from {{nicepay}} parameter type size description example / notes customerid n 9 {{customer}} id 110000001 merchanttoken an 255 sha256 ( merchant id + customer id + amt + merchant key ) 141fd2368aa80ea0e600b1b4d7a42c1e731e74a27a03521e8e28150cc00bc05b referenceno an 40 reference number from inquiry ordno202210102323223 prefix n 7 {{va}} prefix number 7015102 bankcd an 4 bank code docid\ qbeq29lj53z vbvxtvb7l cena amt n 12 total bill amount 10000 txid an 30 transaction id from {{nicepay}} normaltest02202211301010513135 payment response parameter following are {{the}} response {{parameter}} s from {{the}} results of {{the}} request {{parameter}} s for {{the}} nicepay to merchant payment process parameter type size description example / notes billingnm n 100 {{customer}} name john doe goodsnm an 255 goods/item name testing buying referenceno n 7 reference number for {{paymentproduct}} ordno2022113010114 amt an 4 total bill amount normal amount only resultcd 4 result code docid 2r5sr3xvppu1eju1nitg of inquiry status 0000 resultmsg an 255 result message for {{the}} result code docid 2r5sr3xvppu1eju1nitg success sample json payment process nicepay to merchant json request { "customerid" "110000001", "merchanttoken" "141fd2368aa80ea0e600b1b4d7a42c1e731e74a27a03521e8e28150cc00bc05b", "referenceno" "ordno202210102323223", "prefix" "7015102", "bankcd" "cena", "amt" "10000", "txid" "normaltest02202211301010513135" } json response { "resultcd" "0000", "resultmsg" "success", "billingnm" "john doe", "goodsnm" "testing buying", "referenceno" "ordno20221130101148", "amt" "10000" } java request { &#x9;merchanttoken=b360a7dfd4e004e63a161d7298a006ac7900add126b8e19375c4a594ab2e806e, &#x9;vaccttype=1, &#x9;referenceno=2211jd1x7tx5, &#x9;prefix=70015267, &#x9;proxyurl=http //172 30 51 31 8080/nicepay proxy/api/bulkpayment do, &#x9;customerid=60028392, &#x9;bankcd=bmri, &#x9;txid=oyindon00402202211160002385044, &#x9;amt=150000, &#x9;targeturl=https //payfeedback oyindonesia com/nicepay/va/bulk/payment } reversal process nicepay to merchant reversal process nicepay to merchant is a refund {{process}} that occurs caused of an issue happen from internal {{bank}} {{system}} in this {{process}} , {{nicepay}} will continue {{the}} {{information}} {{status}} receive from {{bank}} to {{the}} {{merchant}} api end point https // < {{merchant}} url for reversal> method post (body raw json) post (body raw json) process flow reversal request parameter the following is a list of {{parameter}} s for performing {{the}} nicepay to merchant reversal process from {{transaction}} s made to {{the}} nicepay inquiry virtual account type {{va}} {{paymethod}} this {{parameter}} is used through {{the}} {{api}} {{testing}} platform as one of {{the}} stages so that {{the}} {{merchant}} 's {{system}} can connect with {{service}} s from {{nicepay}} parameter type size description example / notes customerid n 9 {{customer}} id 110000001 merchanttoken an 255 sha256 ( merchant id + customer id + amt + merchant key ) 141fd2368aa80ea0e600b1b4d7a42c1e731e74a27a03521e8e28150cc00bc05b referenceno an 40 reference number from inquiry ordno202210102323223 prefix n 7 {{va}} prefix number 7015102 bankcd an 4 bank code docid\ qbeq29lj53z vbvxtvb7l cena amt n 12 total bill amount 10000 txid an 30 transaction id from {{nicepay}} normaltest02202211301010513135 reversal response parameter following are {{the}} response {{parameter}} s from {{the}} results of {{the}} request {{parameter}} s for {{the}} nicepay to merchant reversal process parameter type size description example / notes billingnm n 100 {{customer}} name john doe topup mount only goodsnm an 100 goods/item name testing reversal transaction topup amount only referenceno n 40 reference number for {{paymentproduct}} ordno202210102323223 amt an 12 total bill amount 50000 resultcd 34 result code of inquiry status result code docid 2r5sr3xvppu1eju1nitg 0000 resultmsg 255 result message for {{the}} result code docid 2r5sr3xvppu1eju1nitg success sample json reversal process nicepay to merchant json request { "customerid" "110000001", "merchanttoken" "141fd2368aa80ea0e600b1b4d7a42c1e731e74a27a03521e8e28150cc00bc05b", "referenceno" "ordno202210102323223", "prefix" "7015102", "bankcd" "cena", "amt" "10000", "txid" "normaltest02202211301010513135" } json response { "resultcd" "0000", "resultmsg" "success", "billingnm" "john doe", "referenceno" "ordno202210102323223", "goodsnm" "testing reversal transaction", "amt" "50000" } java request //reversal to merchant// nicepay setcustomerid("123456"); nicepay settxid("normaltest02202211301010513135"); nicepay setbankcd("cena"); nicepay setprefix("7015102"); nicepay setamt("10000"); nicepay setreferenceno("ordno202210102323223"); nicepay setmerchanttoken(nicepay maketoken(nicepay getcustomerid()); //request reversal// nicepay reversal(); //response reversal// string resultcd = nicepay get("resultcd"); string resultmsg = nicepay get("resultmsg"); string billingnm = nicepay get("billingnm"); string goodsnm = nicepay get("goodsnm"); string referenceno = nicepay get("referenceno"); string amt = nicepay get("amt"); see also {{visit}} {{the}} status inquiry api checkout docid 7thqvphz6emwezw5 d4an {{page}} to find out {{api}} to check {{status}} inquiry specific for {{checkoutproduct}} {{visit}} {{the}} cancel api checkout docid\ nosop1r8knfg81vmkxsc {{page}} to find out {{api}} to cancel {{transaction}} specific for {{checkoutproduct}} {{visit}} {{the}} status inquiry api virtual account docid\ itcm3ihd d5tjo3i0zjen {{page}} to find out {{the}} {{api}} {{va}} to check {{status}} inquiry on {{api}} specific for {{paymentproduct}} {{visit}} {{the}} cancel api virtual account docid\ ijkwakzulovgqblditk d {{page}} to find out {{api}} {{va}} to cancel {{the}} {{transaction}} on {{api}} specific for {{paymentproduct}}