NICEPAY API
...
Payment API
API E-Wallet
Registration - API E-Wallet
13 min
about api for e wallet registration currently, {{nicepay}} is working with 5 {{ewallet}} channels that facilitate {{payment}} {{transaction}} s in {{the}} {{merchant}} business, namely ovo linkaja dana shopeepay astrapay in general, {{the}} {{integration}} stages for {{ewallet}} ovo, linkaja, dana, and shopeepay are {{the}} same however, there are significant differences in {{the}} {{integration}} of {{ewallet}} astrapay specifically for astrapay registration and payment , please visit astrapay registration api e wallet docid 8qytjgylymk7zndm8zncz and astrapay payment api e wallet docid\ xvpxic xuenkuvyqkcsxm api for e wallet registration {{ewallet}} registration {{api}} uses so that {{merchant}} s can connect with {{the}} {{ewallet}} {{payment}} {{api}} {{system}} with {{the}} {{nicepay}} {{system}} so, {{the}} {{payment}} {{system}} that has been provided and hosted from {{the}} {{merchant}} side can integrate with {{the}} {{system}} from {{nicepay}} the following {{api}} s can use for {{ewallet}} ovo, linkaja, dana, and shopeepay api endpoint /nicepay/direct/v2/registration request method post post description performs transaction regist to {{nicepay}} merchant token sha256( timestamp + imid + txid + amt + merchantkey ) request format application/json the following {{api}} s can be implemented for {{ewallet}} ovo, linkaja, dana and shopeepay {{please}} visit astrapay registration api e wallet docid 8qytjgylymk7zndm8zncz {{page}} to know about {{the}} {{integration}} of {{ewallet}} astrapay registration {{please}} visit {{the}} astrapay payment api e wallet docid\ xvpxic xuenkuvyqkcsxm {{page}} to know about {{the}} {{integration}} of {{ewallet}} astrapay {{payment}} request parameter for e wallet registration the following is a list of {{parameter}} s for requesting registration of {{the}} {{ewallet}} {{paymethod}} this {{parameter}} uses in {{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 timestamp required required n 14 request timestamp ( yyyymmddhh24miss ) 20210315112359 imid required required an 10 {{merchant}} id ionpaytest paymethod required required n 2 payment method code docid\ ek 0djw7nuhytcda4sa3p 05 currency required required a 3 currency idr amt required required n 12 amount 1000 referenceno required required ans 40 {{merchant}} 's reference number ord54321 goodsnm required required an 100 goods name test transaction {{nicepay}} 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 {{indonesia}} cartdata jsonstring 4000 cart data { } mitracd required required a 4 mitra code 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 {{merchant}} 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 {{indonesia}} vat n 12 {{vat}} 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 ) {{please}} visit e wallet docid\ mkxgm04 smrzpcmmynuk0 to learn general {{information}} regarding {{ewallet}} {{paymethod}} s response parameter for e wallet registration the following is {{the}} response {{parameter}} from {{the}} result of {{the}} request {{parameter}} to register on {{the}} {{ewallet}} {{paymethod}} parameter type size description example / notes resultcd n 4 result code docid 2r5sr3xvppu1eju1nitg 0000 resultmsg an 255 result message error code docid 4 fpewlvczfhcvygxwck9 success txid an 30 transaction id ionpaytest05202103151123583200 referenceno ans 40 {{merchant}} reference number ord54321 paymethod n 2 payment method code docid\ ek 0djw7nuhytcda4sa3p 05 amt n 12 {{paymentproduct}} 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 bank code docid\ qbeq29lj53z vbvxtvb7l null vacctno n 20 {{va}} null mitracd a 4 mitra code docid 0upx1lyg1o2f4biu3ssp ovoe payno n 12 cvs {{paymentproduct}} number null currency a 3 currency idr goodsnm an 100 goods name test transaction {{nicepay}} 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 {{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 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 {{ewallet}} registration contains {{the}} {{checkout}} items including their details and {{the}} price for each item parameter description example count the total number of all card data 2 item it is divided into 4 kinds of {{parameter}} s, namely img url , goods name , goods detail and goods amt detailed explanation on item {{parameter}} 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" } ] }