Registration - API Virtual Account

tentang api virtual account registration virtual account adalah salah satu {{metodebayar}} {{yang}} ditawarkan di {{nicepay}} {{pelanggan}} memiliki lebih banyak pilihan {{pembayaran}} melalui atm, sms {{bank}} ing, internet {{bank}} ing, maupun mobile {{bank}} ing dengan menggunakan metode ini terdapat real time notifikasi {{yang}} terkirim langsung secara otomatis pada {{pelanggan}} sesaat setelah {{pelanggan}} menyelesaikan {{pembayaran}} jika {{anda}} ingin melihat penjelasan umum {{metodebayar}} {{va}} , {{anda}} dapat mengunjungi docid\ bsnuzmhnlj9h0wrndsqyj untuk pengaturan {{integrasi}} fitur fix open dan {{niva}} , {{anda}} dapat mengunjungi {{halaman}} docid\ am8crh2ruexb3sp pybex spesifikasi panjang nomor virtual account seperti {{yang}} sudah dijelaskan pada {{halaman}} docid 9tv3ro3 lj1f guz2gark , panjang dari nomor va {{yang}} dapat dibuat berbeda beda pada setiap {{bank}} panjang nomor va dapat ditentukan sendiri sesuai dengan kebutuhan {{bisnis}} selama nomor va tersebut tidak melebihi kapasitas panjang maksimum {{yang}} sudah termasuk dengan angka prefix {{bank}} dan prefix {{nicepay}} berikut adalah tabel persyaratan panjang nomor va untuk beberapa {{bank}} 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 catatan {{nicepay}} + {{bank}} prefix length merupakan persyaratan panjang angka untuk nomor prefix {{nicepay}} dan {{bank}} contoh kasus apabila {{anda}} sebagai {{merchant}} ingin melakukan {{integrasi}} dengan va {{bank}} mandiri, maka {{anda}} wajib untuk memberikan ruang sebesar 8 digit untuk prefix va {{yang}} terdiri dari prefix {{bank}} dan prefix {{nicepay}} selanjutnya, angka setelah prefix akan terbagi menjadi 2 tipe sesuai dengan tipe va {{yang}} ingin buat fixed va {{anda}} dapat melakukan kustomisasi angka setelah angka prefix va {{yang}} {{nicepay}} sebut sebagai customer id atau merfixacctid dengan catatan bahwa angka tersebut tidak lebih dari 19 digit panjang maksimal untuk nomor va dari {{bank}} mandiri normal va {{anda}} tidak dapat melakukan kustomisasi angka setelah angka prefix va karena angka tersebut akan melalui {{proses}} generate secara otomatis dan acak oleh {{sistem}} dengan catatan bahwa angka tersebut tidak lebih dari 19 digit panjang maksimal untuk nomor va dari {{bank}} mandiri panjang nomor va secara default adalah 16 digit kecuali ada skema khusus dari {{bank}} , {{nicepay}} , dan {{merchant}} meskipun setiap {{bank}} dapat memiliki panjang nomor va {{yang}} berbeda, {{merchant}} disarankan untuk dapat mengakomodasi panjang nomor va dalam satu deret maksimum 30 digit api virtual account registration registrasi {{va}} bertujuan supaya {{merchant}} dapat terhubung dengan {{sistem}} {{api}} {{pembayaran}} {{va}} dengan {{sistem}} dari {{nicepay}} sehingga {{sistem}} {{pembayaran}} {{yang}} sudah disediakan dan di host dari sisi {{merchant}} dapat ter {{integrasi}} dengan {{sistem}} dari {{nicepay}} api endpoint /nicepay/direct/v2/registration request method post post description performs transaction regist to {{nicepay}} merchant token sha256( timestamp + imid + referenceno + amt + merchantkey ) request format application/json request parameter for registration virtual account berikut ini adalah daftar {{parameter}} untuk melakukan request registrasi {{metodebayar}} {{va}} parameter ini digunakan melalui platform pengujian {{api}} sebagai salah satu tahapan supaya {{sistem}} milik {{merchant}} dapat terhubung dengan {{layanan}} dari {{nicepay}} parameter tipe ukuran deskripsi contoh / catatan timestamp required required n 14 request timestamp ( yyyymmddhh24miss ) 20221214151286 imid required required an 10 {{merchant}} id normaltest paymethod required required n 2 docid\ iifmsruuw7j9vmwefjz97 02 currency required required a 3 currency idr amt required required n 12 amount 10000 referenceno required required ans 40 {{merchant}} 's reference number ordno20221214151286 goodsnm required required an 100 goods name goods for testing {{va}} billingnm required required a 100 buyer name john doe billingphone required required n 15 buyer phone number 081288998899 billingemail required required ans 40 buyer e mail john doe\@example com billingaddr required required an 100 buyer address jln raya kasablanka kav 88 billingcity required required a 50 buyer city south jakarta billingstate required required a 50 billing state dki jakarta billingpostcd required required n 10 billing post number 12800 billingcountry required required a 10 billing country {{indonesia}} cartdata jsonstring 4000 cart data bankcd required for va required for va a 4 docid\ ky4ppujot06atnie easf cena vacctvaliddt required required n 8 va expiry date ( yyyymmdd ) 20221231 vacctvalidtm required required n 6 va expiry time ( hh24miss ) 235959 merfixacctid required required for va type fixclose for va type fixclose an 40 {{merchant}} reserved va id userip required for cc, e wallet, payloan,qris required for cc, e wallet, payloan,qris an 15 user ip 127 0 0 1 dbprocessurl required required ans 255 notification url https //ptsv2 com/t/merchant/post/ merchanttoken required required an 255 {{merchant}} token c94d31f554faea1c5f28617dd0a9de70fcb4dc8de55a343bb887d032d95dd60a deliverynm a 30 delivery name delivery\@example com deliveryphone n 15 delivery phone 081288998899 deliveryaddr an 100 delivery 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 {{indonesia}} description an 100 transaction description testing registration {{va}} 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 {{silakan}} kunjungi {{bagian}} docid 9tv3ro3 lj1f guz2gark untuk mempelajari {{informasi}} umum mengenai {{metodebayar}} {{va}} parameter di bawah berisi {{informasi}} tambahan mengenai {{informasi}} registrasi {{va}} response parameter for registration virtual account berikut adalah response {{parameter}} dari hasil request {{parameter}} untuk mendaftarkan {{metodebayar}} {{va}} parameter tipe ukuran deskripsi contoh / catatan resultcd n 14 docid 7o8nl7guqp asiwfdqi3v 0000 resultmsg an 255 result message docid\ wpcemazro xvnxz 1zaib success txid an 30 transaction id normaltest02202212141509411648 referenceno ans 40 {{merchant}} reference number ordno20221214151286 paymethod n 2 docid\ ek 0djw7nuhytcda4sa3p 02 amt n 12 {{paymentproduct}} amount 1000 transdt n 8 transaction date ( yyyymmdd ) 20221214 transtm n 6 transaction time ( hh24miss ) 150941 description an 100 description testing registration {{va}} bankcd an 4 docid\ ky4ppujot06atnie easf cena vacctno n 20 va number 9912304000001486 mitracd an 4 docid\ tm257gq3dxgzf98uz0l33 null payno n 12 {{paymentproduct}} number null currency an 3 currency idr goodsnm an 100 goods name goods for testing {{va}} 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 {{paymentproduct}} expiry date ( yyyymmdd ) null paymentexptm n 6 qr {{paymentproduct}} 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 setelah {{anda}} mendapatkan nomor va untuk {{pelanggan}} {{anda}} dari {{parameter}} vacctno di response tersebut, {{anda}} pun dapat langsung memberikan nomor va nya kepada {{pelanggan}} {{anda}} untuk dibayarkan 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");