NICEPAY API
...
API E-Wallet
Registration - API E-Wallet
13 min
about api for e wallet registration currently, is working with 5 channels that facilitate s in business, namely ovo linkaja dana shopeepay astrapay in general, stages for ovo, linkaja, dana, and shopeepay are same however, there are significant differences in of astrapay specifically for astrapay registration and payment , please visit docid 8qytjgylymk7zndm8zncz and docid\ xvpxic xuenkuvyqkcsxm api for e wallet registration registration uses so that s can connect with with so, that has been provided and hosted from side can integrate with from the following s can use for ovo, linkaja, dana, and shopeepay api endpoint /nicepay/direct/v2/registration request method post post description performs transaction regist to merchant token sha256( timestamp + imid + txid + amt + merchantkey ) request format application/json the following s can be implemented for ovo, linkaja, dana and shopeepay visit docid 8qytjgylymk7zndm8zncz to know about of astrapay registration visit docid\ xvpxic xuenkuvyqkcsxm to know about of astrapay request parameter for e wallet registration the following is a list of s for requesting registration of this uses in platform as one of stages so that 's can connect with s from parameter type size description example / notes timestamp required required n 14 request timestamp ( yyyymmddhh24miss ) 20210315112359 imid required required an 10 id ionpaytest paymethod required required n 2 docid\ ek 0djw7nuhytcda4sa3p 05 currency required required a 3 currency idr amt required required n 12 amount 1000 referenceno required required ans 40 's reference number ord54321 goodsnm required required an 100 goods name test transaction billingnm required required a 100 buyer name john doe billingphone required required n 15 buyer phone number 08123456789 billingemail required required ans 40 buyer e mail email\@merchant com billingaddr required required an 100 buyer address jalan bukit berbunga 22 billingcity required required a 50 buyer city jakarta billingstate required required a 50 billing state dki jakarta billingpostcd required required n 10 billing post number 12345 billingcountry required required a 10 billing country cartdata jsonstring 4000 cart data { } mitracd required required a 4 docid 0upx1lyg1o2f4biu3ssp ovoe userip required required an 15 user ip 127 0 0 1 dbprocessurl required required ans 255 notification url https //merchant com/dbprocessurl merchanttoken required required an 255 token a45e163042746131307bad89ef6cc0c517c136895a6cfe6cb77c4a62ce1ee5b3 deliverynm a 30 delivery name john doe deliveryphone n 15 delivery phone 8124125931 deliveryaddr an 100 delviery address jln merdeka riau 161 deliverycity a 50 delivery city riau deliverystate a 50 delivery state riau deliverypostcd n 10 delivery post code 14350 deliverycountry a 10 delivery country vat n 12 0 fee n 12 service fee 0 description an 100 transaction description test transaction reqdomain ans 100 request domain merchant com reqserverip ans 15 request server ip 127 0 0 1 userip required required an 15 user ip address 127 0 0 1 reqclientver ans 50 client version 1 0 usersessionid an 100 user session id usersessionid useragent ans 100 user agent mozilla userlanguage a 2 user language en us useragent required required ans 100 user agent information mozilla notaxamt n 12 tax free amount reqdt n 8 request date ( yyyymmdd ) reqtm n 6 request time ( hh24miss ) visit docid\ mkxgm04 smrzpcmmynuk0 to learn general regarding s response parameter for e wallet registration the following is response from result of request to register on parameter type size description example / notes resultcd n 4 docid 2r5sr3xvppu1eju1nitg 0000 resultmsg an 255 result message docid 4 fpewlvczfhcvygxwck9 success txid an 30 transaction id ionpaytest05202103151123583200 referenceno ans 40 reference number ord54321 paymethod n 2 docid\ ek 0djw7nuhytcda4sa3p 05 amt n 12 amount 1000 transdt n 8 transaction date ( yyyymmdd ) 20210315 transtm n 6 transaction time ( hh24miss ) 112358 description an 100 transaction description null bankcd a 4 docid\ qbeq29lj53z vbvxtvb7l null vacctno n 20 null mitracd a 4 docid 0upx1lyg1o2f4biu3ssp ovoe payno n 12 cvs number null currency a 3 currency idr goodsnm an 100 goods name test transaction billingnm a 100 buyer name john doe payvaliddt n 8 cvs expiry date ( yyyymmdd ) (cvs) null payvalidtm n 6 cvs expiry time ( hh24miss ) (cvs) null vacctvaliddt n 8 expiry date ( yyyymmdd ) null vacctvalidtm n 6 expiry time ( hh24miss ) null requesturl ans 360 request url null paymentexpdt n 6 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 for e wallet registration json request { "timestamp" "20210315112359", "imid" "ionpaytest", "paymethod" "05", "currency" "idr", "amt" "1000", "referenceno" "ord54321", "goodsnm" "test transaction nicepay", "billingnm" "john doe", "billingphone" "08123456789", "billingemail" "email\@merchant com", "billingaddr" "jalan bukit berbunga 22", "billingcity" "jakarta", "billingstate" "dki jakarta", "billingpostcd" "12345", "billingcountry" "indonesia", "deliverynm" "email\@merchant com", "deliveryphone" "08123456789", "deliveryaddr" "jalan bukit berbunga 22", "deliverycity" "jakarta", "deliverystate" "dki jakarta", "deliverypostcd" "12345", "deliverycountry" "indonesia", "dbprocessurl" "https //merchant com/api/dbprocessurl/notif", "vat" "", "fee" "", "notaxamt" "", "description" "", "merchanttoken" "a45e163042746131307bad89ef6cc0c517c136895a6cfe6cb77c4a62ce1ee5b3", "reqdt" "", "reqtm" "", "reqdomain" "merchant com", "reqserverip" "127 0 0 1", "reqclientver" "", "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", "cartdata" "{\\"count\\" 1,\\"item\\" \[{\\"img url\\" \\"http \\/\\/www jamgora com\\/media\\/avatar\\/noimage png\\",\\"goods name\\" \\"hoodie\\",\\"goods detail\\" \\"hoodie\\",\\"goods amt\\" \\"1000\\"}]}", "mitracd" "ovoe" } json response { "resultcd" "0000", "resultmsg" "success", "txid" "ionpaytest05202103151123583200", "referenceno" "ord54321", "paymethod" "05", "amt" "1000", "transdt" "20210315", "transtm" "112358", "description" "", "bankcd" null, "vacctno" null, "mitracd" "ovoe", "payno" null, "currency" "idr", "goodsnm" "test transaction nicepay", "billingnm" "john doe", "vacctvaliddt" null, "vacctvalidtm" null, "payvaliddt" null, "payvalidtm" null, "requesturl" null, "paymentexpdt" null, "paymentexptm" null, "qrcontent" null, "qrurl" null } java request // ewallet registration // // ewallet registration mandatory field nicepay settimestamp("20220101123456"); nicepay setimid("testewallet"); nicepay setpaymethod("05"); nicepay setcurrency("idr"); nicepay setamt("10000"); nicepay setreferenceno("ord12345"); nicepay setgoodsnm("john doe"); nicepay setbillingnm("john doe"); nicepay setbillingphone("08123456789"); nicepay setbillingemail("email\@merchant com"); nicepay setbillingaddr("jalan bukit berbunga 22"); nicepay setbillingcity("jakarta"); nicepay setbillingstate("dki jakarta"); nicepay setbillingpostcd("12345"); nicepay setbillingcountry("indonesia"); nicepay setdescription("test transaction"); nicepay setdbprocessurl("https //merchant com/api/dbprocessurl/notif"); nicepay setmitracd("ovoe"); nicepay setmerchanttoken(nicepay maketoken(nicepay getmerchanttoken())); // request ewallet registration nicepay ewalletregist(); // 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"); string description = nicepay get("description"); string mitracd = nicepay get("mitracd"); string currency = nicepay get("currency"); string goodsnm = nicepay get("goodsnm"); string billingnm = nicepay get("billingnm"); cart data e wallet registration cartdata in registration contains items including their details and price for each item parameter description example count the total number of all card data 2 item it is divided into 4 kinds of s, namely img url , goods name , goods detail and goods amt detailed explanation on item s parameter description example img url url goods picture (size 50px x 50px) htttps\ //www merchant com/image goods1 jpg goods name goods name nama item 1 goods detail goods detail description detail item 1 goods amt goods price 1000 goods quantity goods quantity 1 cartdata e wallet registration { "count" "2", "item" \[ { "img url" "http //www merchant com/image goods1 jpg", "goods name" "item 1 name", "goods detail" "item 1 detail", "goods amt" "1000", "goods quantity" "1" }, { "img url" "http //www merchant com/image goods2 jpg", "goods name" "item 2 name", "goods detail" "item 2 detail", "goods amt" "1000" "goods quantity" "1" } ] }