Registration - API Paylater

21 min

about api for paylater registration this uses by s to register s with so that they can register s api for paylater registration the registration uses so that s can connect to from so that that has been provided and hosted from side can integrate with from the following s can use for indodana, akulaku, and kredivo registrations api endpoint /nicepay/direct/v2/registration request method \post\ description performs transaction regist to merchant token sha256( timestamp + imid + referenceno + amt + merchantkey ) request format application/json request parameter for paylater 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 tipe ukuran deskripsi contoh / catatan timestamp \required\ n 14 request timestamp ( yyyymmddhh24miss ) 20220131125959 imid \required\ an 10 id payloantes paymethod \required\ n 2 payment method code docid\ iifmsruuw7j9vmwefjz97 06 currency \required\ a 3 currency idr amt \required\ n 12 amount 10000 referenceno \required\ ans 40 's reference number ord12345 callbackurl ans 255 result url goodsnm \ \ \required\ an 100 goods name test transaction billingnm \required\ a 100 buyer name john doe billingphone \required\ n 15 buyer phone number 08123456789 billingemail \required\ ans 40 buyer e mail email\@merchant com billingaddr \required\ an 100 buyer address jalan bukit berbunga 22 billingcity \required\ a 50 buyer city jakarta billingstate \required\ a 50 billing state dki jakarta billingpostcd \required\ n 10 billing post number 12345 billingcountry \required\ a 10 billing country cartdata \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, paylater,qris\ an 15 user ip 127 0 0 1 dbprocessurl \required\ ans 255 notification url https //merchant com/dbprocessurl merchanttoken \required\ an 255 token 9b38b12e83b6ee124d4b549238f232c6179b168effc4ffb7f64d00c15f08e230 deliverynm \required\ a 30 delivery name email\@merhchant com deliveryphone \required\ n 15 delivery phone 08123456789 deliveryaddr \required\ an 100 delviery address jalan bukit berbunga 22 deliverycity \required\ a 50 delivery city jakarta deliverystate \required\ a 50 delivery state dki jakarta deliverypostcd \required\ n 10 delivery post code 12345 deliverycountry \required\ a 10 delivery country mitracd \required\ n 2 mitra code docid 0lup35kfowksisrzkx6yz kdvi instmnttype \required\ n 8 installment type code docid wzur5wjwhrdr8yxi ppi 2 instmntmon \required\ n 6 1 1 month/full , if instmnttype null/1 3 3 months 6 6 months 12 12 months paylater rule and limitation docid\ yp8wkbudyslwg9r hyrzq 3 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\ 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\\"}}] visit paylater docid 8eqxklid9vhncmdggww c to learn general about response parameter for paylater registration the following is response from result of request for registering parameter type size description example / notes resultcd n 4 result code docid 9ec3yh9cqqpb6crwauwwo 0000 resultmsg an 255 result message error code docid\ fsx1gesjkxop0t9rvuhp success txid an 30 transaction id payloantes06202212051018325178 referenceno ans 40 reference number ord12345 paymethod n 2 payment method code docid\ nq1y7vma25ztvqhn5he6w 06 amt n 12 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\ hlxvgrxvxwd90n8ohnkm0 null vacctno n 20 null mitracd a 4 mitra code docid 0lup35kfowksisrzkx6yz kdvi payno n 12 cvs 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 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 paylater 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 paylater each that works together with has different condition following are detailed terms for each indodana cartdata in registration is useful for declaring items that will check out along with item details and price per item parameter description contoh count the total number of all card data 2 item it divides into 4 kinds of s, namely img url , goods name , goods detail and goods amt detailed explanation on item 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 nama goods sellers name goods seller name shop cartdata paylater 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 cartdata in registration is useful for declaring what items will check out along with item details and price for each item parameter description contoh count the total number of all card data 2 item it divides into 4 kinds of 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 nama goods sellers name goods seller name shop cartdata paylater akulaku 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" 	 } 	] } kredivo cartdata in registration is useful for declaring what items will check out along with item details and price for each item parameter deskripsi contoh count the total number of all card data 3 item it divides into 4 kinds of 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 it can contain code from , taxfee , shippingfee or discount goods name goods name ant life goods amt goods price 200000 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 nama goods sellers name goods seller name shop cartdata paylater kredivo registration { "count" "3", "item" \[ { "goods id" "aa12345", "goods detail" "aa1345678", "goods name" "ant life", "goods amt" 200000, "goods type" "book", "goods url" "http //nicestore go/product/book/", "goods quantity" 1, "goods sellers id" "nicepay namamerchant", "goods sellers name" "nicepayshop" }, { "goods id" "taxfee", "goods detail" "", "goods name" "", "goods amt" 5000, "goods type" "", "goods url" "", "goods quantity" 1, "goods sellers id" "nicepay namamerchant", "goods sellers name" "nicepayshop" }, { "goods id" "discount", "goods detail" "", "goods name" "discount", "goods amt" 20000, "goods type" "", "goods url" "", "goods quantity" 1, "goods sellers id" "nicepay namamerchant", "goods sellers name" "nicepayshop" }, { "goods id" "shippingfee", "goods detail" "biaya pengiriman", "goods name" "biaya pengiriman", "goods amt" 10000, "goods type" "book", "goods url" "http //nicestore go/product/book/", "goods quantity" 1, "goods sellers id" "nicepay namamerchant", "goods sellers name" "nicepayshop" } ] } goods id on cartdata affect amt calculation with following formula amt = ( shipmentfee + taxfddee + goods amt + ) discount example following is calculation based from cartdata kredivo registration shipmentfee = 10000 taxfee = 5000 goods amt = 200000 discount = 20000 amt = (10000 + 5000 + 200000) 20000 = 215000 20000 = 195000 paylater seller data seller data contains seller data sent from seller to to be used as seller validation during using 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 paylater 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" } } ]

Registration - API Paylater

Welcome to NICEPAY DOCS