Registration - API Virtual Account

about api virtual account registration virtual account is one of s offered at s have more options via atm, sms ing, internet ing, and mobile ing using this method there are real time s that are sent automatically to as soon as completes if you want to see a general explanation of s, you can visit va payment guide docid\ ie9rxfmm gpysjakmrbvl for settings for fix open and features, you can visit virtual account advance api docid\ cadfseimkqmertral3p4u virtual account length number specification as explained on virtual account structure docid\ zf1ak3ppg5z1my1oevy7a , length of va number that can be created varies from each the length of va can be determined according to needs as long as va number does not exceed maximum length capacity that includes and prefix the following is a table of requirements for va length number for some s bank nicepay + bank prefix length max total va bca 8 23 bri 8 18 mandiri 8 19 maybank 8 16 bni 7 16 permata & syariah 7 16 cimb 7 19 danamon 7 16 hana 7 16 bjb 7 16 bnc 11 19 dki 9 16 bsi 8 28 note + prefix length is number length requirement for and prefix numbers a case study if you as a want to integrate mandiri va, then you are required to provide a space of 8 digits for va prefix which consists of and prefix later, number after prefix will be divided into 2 types according to type of va you want to create fixed va you can customize number after va prefix number that refers to as id or merfixacctid with a note that number is no longer than maximum 19 digits length for va numbers from mandiri normal va you cannot customize number after va prefix number because that number will be generated automatically and randomly by with a note that number is no longer than maximum 19 digits length for va numbers from mandiri the default length of va number is 16 digits unless there are a special schemes from s, , and s although each may have different length of va number, s are considered to be able to accommodate a va number lengths maximum of 30 digits in a row api virtual account registration registration aims so that can connect to a with a from so, that has to provide and hosted from side can integrate with from api endpoint /nicepay/direct/v2/registration request method \<font color="#3b9f0f">post\</font> description performs transaction regist to merchant token sha256( timestamp + imid + referenceno + amt + merchantkey ) request format application/json request parameter for registration virtual account the following is a list of s for requesting registration of this is used through platform as one of stages so that 's can connect with s from parameter type size description example / notes timestamp \<font color="#2166ae">required\</font> n 14 request timestamp ( yyyymmddhh24miss ) 20221214151286 imid \<font color="#2166ae">required\</font> an 10 id normaltest paymethod \<font color="#2166ae">required\</font> n 2 payment method code docid\ ek 0djw7nuhytcda4sa3p 02 currency \<font color="#2166ae">required\</font> a 3 currency idr amt \<font color="#2166ae">required\</font> n 12 amount 10000 referenceno \<font color="#2166ae">required\</font> ans 40 's reference number ordno20221214151286 goodsnm \<font color="#2166ae"> \</font> \<font color="#2166ae">required\</font> an 100 goods name goods for testing billingnm \<font color="#2166ae"> \</font> \<font color="#2166ae">required\</font> a 100 buyer name john doe billingphone \<font color="#2166ae"> \</font> \<font color="#2166ae">required\</font> n 15 buyer phone number 081288998899 billingemail \<font color="#2166ae"> \</font> \<font color="#2166ae">required\</font> ans 40 buyer e mail john doe\@example com billingaddr \<font color="#2166ae"> \</font> \<font color="#2166ae">required\</font> an 100 buyer address jln raya kasablanka kav 88 billingcity \<font color="#2166ae"> \</font> \<font color="#2166ae">required\</font> a 50 buyer city south jakarta billingstate \<font color="#2166ae"> \</font> \<font color="#2166ae">required\</font> a 50 billing state dki jakarta billingpostcd \<font color="#2166ae"> \</font> \<font color="#2166ae">required\</font> n 10 billing post number 12800 billingcountry \<font color="#2166ae"> \</font> \<font color="#2166ae">required\</font> a 10 billing country cartdata \<font color="#2166ae"> \</font> jsonstring 4000 cart data {} bankcd \<font color="#2166ae"> \</font> \<font color="#2166ae">required for va\</font> a 4 bank code docid\ qbeq29lj53z vbvxtvb7l cena vacctvaliddt \<font color="#2166ae"> \</font> \<font color="#2166ae">required\</font> n 8 va expiry date ( yyyymmdd ) 20221231 vacctvalidtm \<font color="#2166ae"> \</font> \<font color="#2166ae">required\</font> n 6 va expiry time ( hh24miss ) 235959 merfixacctid \<font color="#2166ae"> \</font> \<font color="#2166ae">required \</font> \<font color="#2166ae">for va type fixclose\</font> an 40 reserved va id userip \<font color="#2166ae">required for cc, e wallet, payloan,qris\</font> an 15 user ip 127 0 0 1 dbprocessurl \<font color="#2166ae">required\</font> ans 255 notification url https //ptsv2 com/t/merchant/post/ merchanttoken \<font color="#2166ae">required\</font> an 255 token c94d31f554faea1c5f28617dd0a9de70fcb4dc8de55a343bb887d032d95dd60a deliverynm a 30 delivery name delivery\@example com deliveryphone n 15 delivery phone 081288998899 deliveryaddr an 100 delviery address jln raya kasablanka kav 88 deliverycity a 50 delivery city south jakarta deliverystate a 50 delivery state dki jakarta deliverypostcd n 10 delivery post code 12800 deliverycountry a 10 delivery country description an 100 transaction description testing registration reqdomain ans 100 request domain merchant com reqserverip ans 15 request server ip 127 0 0 1 usersessionid an 100 user session id 697d6922c961070967d3ba1ba5699c2c useragent ans 100 user agent mozilla userlanguage a 2 user language en us visit virtual account (va) docid\ zf1ak3ppg5z1my1oevy7a to learn general about s the s below contain additional regarding registration response parameter for registration virtual account the following is a response from request results to register parameter type size description example / notes resultcd n 14 result code docid 2r5sr3xvppu1eju1nitg 0000 resultmsg an 255 result message error code docid 4 fpewlvczfhcvygxwck9 success txid an 30 transaction id normaltest02202212141509411648 referenceno ans 40 reference number ordno20221214151286 paymethod n 2 payment method code docid\ ek 0djw7nuhytcda4sa3p 02 amt n 12 amount 1000 transdt \<font color="#2166ae"> \</font> n 8 transaction date ( yyyymmdd ) 20221214 transtm n 6 transaction time ( hh24miss ) 150941 description an 100 description testing registration bankcd an 4 bank code docid\ qbeq29lj53z vbvxtvb7l cena vacctno n 20 va number 9912304000001486 mitracd an 4 mitra code docid 0upx1lyg1o2f4biu3ssp null payno n 12 payment number null currency an 3 currency idr goodsnm an 100 goods name goods for testing billingnm a 100 buyer name john doe vacctvaliddt n 8 va expiry date ( yyyymmdd ) 20221231 vacctvalidtm n 6 va expiry time ( hh24miss ) 235959 payvaliddt n 8 expiry date ( yyyymmdd ) null payvalidtm n 6 expiry time ( hh24miss ) null requesturl ans 360 request url null paymentexpdt n 8 qr expiry date ( yyyymmdd ) null paymentexptm n 6 qr expiry time ( hh24miss ) null qrcontent ans 360 qr string in plain text null qrurl ans 360 url for qr image, valid for 5 minutes null sample json registrasi virtual account json request { "timestamp" "20221214151286", "imid" "normaltest", "paymethod" "02", "currency" "idr", "bankcd" "cena", "amt" "10000", "referenceno" "ordno20221214151286", "merchanttoken" "c94d31f554faea1c5f28617dd0a9de70fcb4dc8de55a343bb887d032d95dd60a", "vacctvaliddt" "20221231", "vacctvalidtm" "235959", "merfixacctid" "", "dbprocessurl" "https //ptsv2 com/t/merchant/post/", "mitracd" "", "goodsnm" "goods for testing virtual account", "cartdata" "{}", "billingnm" "john doe", "billingphone" "081288998899", "billingemail" "john doe\@example com", "billingaddr" "jln raya kasablanka kav 88", "billingcity" "south jakarta", "billingstate" "dki jakarta", "billingpostcd" "12800", "billingcountry" "indonesia", "deliverynm" "delivery\@example com", "deliveryphone" "081288998899", "deliveryaddr" "jln raya kasablanka kav 88", "deliverycity" "south jakarta", "deliverystate" "dki jakarta", "deliverypostcd" "12800", "deliverycountry" "indonesia", "description" "testing registration virtual account", "reqdomain" "merchant com", "reqserverip" "127 0 0 1", "userip" "127 0 0 1", "usersessionid" "697d6922c961070967d3ba1ba5699c2c", "useragent" "mozilla/5 0 (windows nt 10 0; win64; x64) applewebkit/537 36 (khtml,like gecko) chrome/60 0 3112 101 safari/537 36", "userlanguage" "ko kr,en us;q=0 8,ko;q=0 6,en;q=0 4" } json response { "resultcd" "0000", "resultmsg" "success", "txid" "normaltest02202212141509411648", "referenceno" "ordno20221214151286", "paymethod" "02", "amt" "10000", "transdt" "20221214", "transtm" "150941", "description" "testing registration virtual account", "bankcd" "cena", "vacctno" "9912304000001486", "mitracd" null, "payno" null, "currency" "idr", "goodsnm" "goods for testing virtual account", "billingnm" "john doe", "vacctvaliddt" "20221231", "vacctvalidtm" "235959", "payvaliddt" null, "payvalidtm" null, "requesturl" null, "paymentexpdt" null, "paymentexptm" null, "qrcontent" null, "qrurl" null } java request //virtual account registration// nicepay settimestamp("20221202141217"); nicepay setimid("ionpaytest"); nicepay setpaymethod("02"); nicepay setcurrency("idr"); nicepay setamt("5000"); nicepay setreferenceno("ordno20221202141217"); nicepay setinstmnttype("1"); nicepay setinstmntmon("1"); nicepay setmerchanttoken(nicepay maketoken(nicepay getmerchanttoken()); nicepay setgoodsnm("testing registration virtual account"); nicepay setbillingnm("john doe"); nicepay setbillingphone("081288998899"); nicepay setbillingemail("john doe\@example com"); nicepay setbillingaddr("jln raya kasablanka kav 88"); nicepay setbillingcity("south jakarta"); nicepay setbillingstate("dki jakarta"); nicepay setbillingcountry("indonesia"); nicepay setbillingpostcd("12800"); nicepay setdbprocessurl("http //ptsv2 com/t/merchant/post"); // request virtual account registration nicepay ccregist(); // 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 amt = nicepay get("amt"); string transdt = nicepay get("transdt"); string transtm = nicepay get("transtm");