NICEPAY API
...
Payment API
API Payloan

Registration - API Payloan

17min
about api for payloan registration this {{api}} uses by {{merchant}} s to register {{transaction}} s with {{the}} {{nicepay}} {{system}} so that they can register {{transaction}} s api for payloan registration the {{payloan}} registration {{api}} uses so that {{the}} {{merchant}} s can connect to {{the}} {{payloan}} {{payment}} {{api}} {{system}} from {{nicepay}} so that {{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 indodana, akulaku, and kredivo registrations 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 payloan registration the following is a list of {{parameter}} s for requesting registration of {{the}} {{payloan}} {{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 tipe ukuran deskripsi contoh / catatan timestamp required required n 14 request timestamp ( yyyymmddhh24miss ) 20220131125959 imid required required an 10 {{merchant}} id payloantes paymethod required required n 2 payment method code docid\ iifmsruuw7j9vmwefjz97 06 currency required required a 3 currency idr amt required required n 12 amount 10000 referenceno required required ans 40 {{merchant}} 's reference number ord12345 callbackurl ans 255 {{paymentproduct}} result url 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 required required jsonstring 4000 cart data {"count" 3,"item" \[{"goods id" 30,"goods name" "beanie","goods type" "accessories","goods amt" 5000,"goods sellers id" "nicepay namamerchant","goods sellers name" "nicepayshop","goods quantity" 1,"goods url" " http //www nicestore com/product/beanie/ http //www nicestore com/product/beanie/ "}, ]} 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 //merchant com/dbprocessurl merchanttoken required required an 255 {{merchant}} token 9b38b12e83b6ee124d4b549238f232c6179b168effc4ffb7f64d00c15f08e230 deliverynm required required a 30 delivery name email\@merhchant com deliveryphone required required n 15 delivery phone 08123456789 deliveryaddr required required an 100 delviery address jalan bukit berbunga 22 deliverycity required required a 50 delivery city jakarta deliverystate required required a 50 delivery state dki jakarta deliverypostcd required required n 10 delivery post code 12345 deliverycountry required required a 10 delivery country {{indonesia}} mitracd required required n 2 mitra code docid 0upx1lyg1o2f4biu3ssp kdvi instmnttype required required n 8 request date ( yyyymmdd ) 2 instmntmon required required n 6 request time ( hh24miss ) 1 usersessionid an 255 id user session 697d6922c961070967d3ba1ba5699c2c useragent ans 255 user agent mozilla/5 0 (windows nt 10 0; win64; x64) applewebkit/537 36 (khtml,like gecko) chrome/60 0 3112 101 safari/537 36 userlanguage ans 255 user language ko kr,en us;q=0 8,ko;q=0 6,en;q=0 4 sellers required required json string 4000 seller data \[{\\"sellersid\\" \\"nicepay namamerchant\\",\\"sellersnm\\" \\"nicepayshop\\",\\"sellersurl\\" \\"http //nicestore store/product/beanie/\\",\\"sellersemail\\" \\"nicepay\@nicepay co id\\",\\"sellersaddress\\" {\\"sellernm\\" \\"nicepayshop\\",\\"sellerlastnm\\" \\"nicepayshop\\",\\"selleraddr\\" \\"jln kasablanka kav 88\\",\\"sellercity\\" \\"jakarta\\",\\"sellerpostcd\\" \\"14350\\",\\"sellerphone\\" \\"082111111111\\",\\"sellercountry\\" \\"id\\"}}] {{please}} visit payloan docid\ jksux9c rbjjecnooqqel {{section}} to learn general {{information}} about {{the}} {{payloan}} {{paymethod}} response parameter for payloan registration the following is {{the}} response {{parameter}} from {{the}} result of {{the}} request {{parameter}} for registering {{the}} {{payloan}} {{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 payloantes06202212051018325178 referenceno ans 40 {{merchant}} reference number ord12345 paymethod n 2 payment method code docid\ ek 0djw7nuhytcda4sa3p 06 amt n 12 {{paymentproduct}} amount 10000 transdt n 8 transaction date ( yyyymmdd ) null transtm n 6 transaction time ( hh24miss ) null 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 kdvi payno n 12 cvs {{paymentproduct}} number null currency a 3 currency null goodsnm an 100 goods name null billingnm a 100 buyer name null payvaliddt n 8 expiry date ( yyyymmdd ) null payvalidtm 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 payloan registration json request { "timestamp" "20220131125959", "imid" "payloantes", "paymethod" "06", "currency" "idr", "amt" "10000", "referenceno" "ord12345", "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", "description" "", "merchanttoken" "9b38b12e83b6ee124d4b549238f232c6179b168effc4ffb7f64d00c15f08e230", "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\\" 3,\\"item\\" \[{\\"goods id\\" 30,\\"goods name\\" \\"beanie\\",\\"goods type\\" \\"accessories\\",\\"goods amt\\" 5000,\\"goods sellers id\\" \\"nicepay namamerchant\\",\\"goods sellers name\\" \\"nicepayshop\\",\\"goods quantity\\" 1,\\"goods url\\" \\"http //www nicestore com/product/beanie/\\"},{\\"goods id\\" 31,\\"goods name\\" \\"belt\\",\\"goods type\\" \\"accessories\\",\\"goods amt\\" 4500,\\"goods sellers id\\" \\"nicepay namamerchant\\",\\"goods sellers name\\" \\"nicepayshop\\",\\"goods quantity\\" 1,\\"goods url\\" \\"http //www nicestore store/product/belt/\\"},{\\"img url\\" \\"http //www jamgora com/media/avatar/noimage png\\",\\"goods name\\" \\"shipping fee\\",\\"goods id\\" \\"shipping for ref no 278\\",\\"goods detail\\" \\"flat rate\\",\\"goods type\\" \\"shipping with flat rate\\",\\"goods amt\\" \\"500\\",\\"goods sellers id\\" \\"nicepay namamerchant\\",\\"goods sellers name\\" \\"nicepayshop\\",\\"goods quantity\\" \\"1\\",\\"goods url\\" \\"https //wwww nicestore store\\"}]}", "sellers" "\[{\\"sellersid\\" \\"nicepay namamerchant\\",\\"sellersnm\\" \\"nicepayshop\\",\\"sellersurl\\" \\"http //nicestore store/product/beanie/\\",\\"sellersemail\\" \\"nicepay\@nicepay co id\\",\\"sellersaddress\\" {\\"sellernm\\" \\"nicepayshop\\",\\"sellerlastnm\\" \\"nicepayshop\\",\\"selleraddr\\" \\"jln kasablanka kav 88\\",\\"sellercity\\" \\"jakarta\\",\\"sellerpostcd\\" \\"14350\\",\\"sellerphone\\" \\"082111111111\\",\\"sellercountry\\" \\"id\\"}}]", "instmnttype" "2", "instmntmon" "1", "mitracd" "kdvi" } json response { "resultcd" "0000", "resultmsg" "success", "txid" "payloantes06202212051018325178", "referenceno" "ord12345", "paymethod" "06", "amt" "10000", "transdt" null, "transtm" null, "description" null, "bankcd" null, "vacctno" null, "mitracd" "kdvi", "payno" null, "currency" null, "goodsnm" null, "billingnm" null, "vacctvaliddt" null, "vacctvalidtm" null, "payvaliddt" null, "payvalidtm" null, "requesturl" null, "paymentexpdt" null, "paymentexptm" null, "qrcontent" null, "qrurl" null } java request // payloan registration // // payloan registration mandatory field nicepay settimestamp("20220101123456"); nicepay setimid("testewallet"); nicepay setpaymethod("0"); 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 setdeliverynm("test transaction"); nicepay setdeliveryphone("test transaction"); nicepay setdeliveryaddr("test transaction"); nicepay setdeliverycity("test transaction"); nicepay setdeliverystate("test transaction"); nicepay setdeliverypostcd("test transaction"); nicepay setdeliverycountry("test transaction"); nicepay setcartdata("{\\"count\\" 3,\\"item\\" \[{\\"goods id\\" 30,\\"goods name\\" \\"beanie\\",\\"goods type\\" \\"accessories\\",\\"goods amt\\" 5000,\\"goods sellers id\\" \\"nicepay namamerchant\\",\\"goods sellers name\\" \\"nicepayshop\\",\\"goods quantity\\" 1,\\"goods url\\" \\"http //www nicestore com/product/beanie/\\"},{\\"goods id\\" 31,\\"goods name\\" \\"belt\\",\\"goods type\\" \\"accessories\\",\\"goods amt\\" 4500,\\"goods sellers id\\" \\"nicepay namamerchant\\",\\"goods sellers name\\" \\"nicepayshop\\",\\"goods quantity\\" 1,\\"goods url\\" \\"http //www nicestore store/product/belt/\\"},{\\"img url\\" \\"http //www jamgora com/media/avatar/noimage png\\",\\"goods name\\" \\"shipping fee\\",\\"goods id\\" \\"shipping for ref no 278\\",\\"goods detail\\" \\"flat rate\\",\\"goods type\\" \\"shipping with flat rate\\",\\"goods amt\\" \\"500\\",\\"goods sellers id\\" \\"nicepay namamerchant\\",\\"goods sellers name\\" \\"nicepayshop\\",\\"goods quantity\\" \\"1\\",\\"goods url\\" \\"https //wwww nicestore store\\"}]}"); nicepay setsellers("\[{\\"sellersid\\" \\"nicepay namamerchant\\",\\"sellersnm\\" \\"nicepayshop\\",\\"sellersurl\\" \\"http //nicestore store/product/beanie/\\",\\"sellersemail\\" \\"nicepay\@nicepay co id\\",\\"sellersaddress\\" {\\"sellernm\\" \\"nicepayshop\\",\\"sellerlastnm\\" \\"nicepayshop\\",\\"selleraddr\\" \\"jln kasablanka kav 88\\",\\"sellercity\\" \\"jakarta\\",\\"sellerpostcd\\" \\"14350\\",\\"sellerphone\\" \\"082111111111\\",\\"sellercountry\\" \\"id\\"}}]"); nicepay setinstmnttype("2"); nicepay setinstmntmon("1"); nicepay setmitracd("kdvi"); nicepay setmerchanttoken(nicepay maketoken(nicepay getmerchanttoken())); // request payloan registration nicepay payloanregist(); // 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"); cart data payloan each {{partner}} that works together with {{nicepay}} has different condition following are detailed terms for each {{partner}} indodana cartdata in {{payloan}} registration is useful for declaring items that will check out along with item details and {{the}} price per item parameter description contoh count the total number of all card data 2 item it divides 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 / notes goods id goods id aa12345 goods name goods name beanie goods amt goods price 5000 goods type goods type others goods quantity goods quantity 1 goods url goods link http //nicestore go/product/beanie/ http //nicestore go/product/beanie/ goods sellers id goods seller id {{nicepay}} nama {{merchant}} goods sellers name goods seller name {{nicepay}} shop cartdata payloan indodana registration { 	"count" 2, 	"item" \[ 	 { 	 "goods id" "aa12345", 	 "goods name" "beanie", 	 "goods amt" "5000", 	 "goods type" "others", 	 "goods quantity" 1, 	 "goods url" "http //nicestore go/product/beanie/" 	 "goods sellers id" "nicepay namamerchant", 	 "goods sellers name" "nicepayshop" 	 }, 	 { 	 "goods id" "bb12345", 	 "goods name" "belt", 	 "goods amt" "5000", 	 "goods type" "others", 	 "goods quantity" "1", 	 "goods url" "http //nicestore go/product/belt/", 	 "goods sellers id" "nicepay namamerchant", 	 "goods sellers name" "nicepayshop" 	 } 	] } akulaku / kredivo cartdata in {{payloan}} registration is useful for declaring what items will check out along with item details and {{the}} price for each item parameter description contoh count the total number of all card data 2 item it divides into 4 kinds of {{parameter}} s, namely img url , goods name , goods detail , and goods amt detailed explanation on item parameters parameter description example / notes goods id goods id aa12345 goods name goods name beanie goods amt goods price 5000 goods type goods type others goods detail goods detail aa1345678 goods quantity goods quantity 1 goods url goods link http //nicestore go/product/beanie/ goods sellers id goods seller id {{nicepay}} nama {{merchant}} goods sellers name goods seller name {{nicepay}} shop cartdata payloan akulaku/kredivo registration { 	"count" "2", 	"item" \[ 	 { 	 "goods id" "aa12345", 	 "goods name" "beanie", 	 "goods amt" "5000", 	 "goods type" "others", 	 "goods detail" "aa1345678", 	 "goods quantity" "1", 	 "goods url" "http //nicestore go/product/beanie/", 	 "goods sellers id" "nicepay namamerchant", 	 "goods sellers name" "nicepayshop" 	 }, 	 { 	 "goods id" "bb12345", 	 "goods name" "belt", 	 "goods amt" "5000", 	 "goods type" "others", 	 "goods detail" "bb12345678", 	 "goods quantity" "1", 	 "goods url" "http //nicestore go/product/belt/", 	 "goods sellers id" "nicepay namamerchant", 	 "goods sellers name" "nicepayshop" 	 } 	] } payloan seller data {{payloan}} seller data contains seller data {{information}} sent from seller to {{nicepay}} {{partner}} to be used as seller validation during {{transaction}} using {{payloan}} {{paymethod}} parameter description example sellersid seller id sel123 sellersnm seller name sellers 1 sellersemail seller e mail sellers\@test com sellersurl seller link http //nicestore store http //nicestore store sellersaddress > sellernm seller name sellers sellersaddress > sellerlastnm seller last name 1 sellersaddress > selleraddr seller address jalan berbangsa 1 sellersaddress > sellercity seller city origin jakarta barat sellersaddress > sellerpostcd seller postal code 12344 sellersaddress > sellerphone seller phone number 08123456789 sellersaddress > sellercountry seller country origin id payloan seller data \[ { "sellersid" "sel123", "sellersnm" "sellers 1", "sellersemail" "sellers\@test com", "sellersurl" "http //nicestore store", "sellersaddress" { "sellernm" "sellers", "sellerlastnm" "1", "selleraddr" "jalan berbangsa 1", "sellercity" "jakarta barat", "sellerpostcd" "12344", "sellerphone" "08123456789", "sellercountry" "id" } }, { "sellersid" "sel124", "sellersnm" "sellers 2", "sellersemail" "sellers2\@test com", "sellersurl" "http //nicestore store", "sellersaddress" { "sellernm" "sellers", "sellerlastnm" "2", "selleraddr" "jalan berkelok 3", "sellercity" "jakarta utara", "sellerpostcd" "12222", "sellerphone" "081255556789", "sellercountry" "id" } } ]