NICEPAY API
...
API Payloan
Registration - API Payloan
21 min
tentang api for payloan registration {{api}} ini digunakan oleh {{merchant}} untuk mendaftarkan {{transaksi}} kepada {{sistem}} {{nicepay}} agar dapat melakukan pendaftaran {{transaksi}} api for payloan registration {{api}} {{payloan}} registration digunakan supaya {{merchant}} dapat terhubung dengan {{sistem}} {{api}} {{pembayaran}} {{payloan}} dari {{nicepay}} sehingga {{sistem}} {{pembayaran}} {{yang}} sudah disediakan dan di host dari sisi {{merchant}} dapat ter {{integrasi}} dengan {{sistem}} dari {{nicepay}} {{api}} berikut dapat digunakan untuk registrasi indodana, akulaku, dan kredivo 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 berikut ini adalah daftar {{parameter}} untuk melakukan request registrasi {{metodebayar}} {{payloan}} 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 ) 20220131125959 imid required required an 10 {{merchant}} id payloantes paymethod required required n 2 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/ "}, ]} 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 docid\ tm257gq3dxgzf98uz0l33 kdvi instmnttype required required n 8 docid\ rt2c32s9hfl aohyoebv5 2 instmntmon required required n 6 1 1 month/full {{paymentproduct}} , jika instmnttype null/1 3 3 months 6 6 months 12 12 months docid 7y1ihoi4ienaisarnc8g7 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 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\\"}}] {{silakan}} kunjungi docid\ epab99fmzp5 sydpkudxr untuk mempelajari {{informasi}} umum mengenai {{metodebayar}} {{payloan}} response parameter for payloan registration berikut adalah response parameter dari hasil request parameter untuk mendaftarkan {{metodebayar}} {{payloan}} parameter tipe ukuran deskripsi contoh / catatan resultcd n 4 docid 7o8nl7guqp asiwfdqi3v 0000 resultmsg an 255 result message docid\ wpcemazro xvnxz 1zaib success txid an 30 transaction id payloantes06202212051018325178 referenceno ans 40 {{merchant}} reference number ord12345 paymethod n 2 docid\ iifmsruuw7j9vmwefjz97 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 docid\ ky4ppujot06atnie easf null vacctno n 20 {{va}} number null mitracd a 4 docid\ tm257gq3dxgzf98uz0l33 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 masing masing {{mitra}} {{yang}} bekerja sama dengan {{nicepay}} memiliki ketentuan {{yang}} berbeda beda berikut adalah rincian ketentuan dari masing masing {{mitra}} indodana cartdata pada registrasi {{payloan}} berguna untuk mendeklarasikan item {{yang}} akan di {{checkout}} berserta rincian item dan harga per item nya parameter deskripsi contoh count total jumlah dari keseluruhan cart data 2 item terbagi menjadi 4 macam {{parameter}} , yaitu img url , goods name , goods detail dan goods amt penjelasan rincian pada {{parameter}} item parameter deskripsi contoh / catatan goods id id barang aa12345 goods name nama barang beanie goods amt harga barang 5000 goods type tipe barang others goods quantity jumlah barang 1 goods url tautan barang http //nicestore go/product/beanie/ goods sellers id id penjual barang {{nicepay}} nama {{merchant}} goods sellers name nama penjual barang {{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 cartdata pada registrasi {{payloan}} berguna untuk mendeklarasikan item apa saja {{yang}} akan di checkout berserta rincian dan harga per item parameter deskripsi contoh count total jumlah keseluruhan cart data 2 item parameter {{yang}} berisi rincian cart data, seperti img url , goods name , goods detail , dan goods amt penjelasan rinci pada {{parameter}} item parameter deskripsi contoh / catatan goods id id barang aa12345 goods name nama barang beanie goods amt harga barang 5000 goods type tipe barang others goods detail rincian barang aa1345678 goods quantity jumlah barang 1 goods url tautan barang http //nicestore go/product/beanie/ goods sellers id id penjual barang {{nicepay}} nama {{merchant}} goods sellers name nama penjual barang {{nicepay}} shop cartdata payloan 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 pada registrasi {{payloan}} berguna untuk mendeklarasikan item apa saja {{yang}} akan di checkout berserta rincian dan harga per item parameter deskripsi contoh count total jumlah keseluruhan cart data 3 item parameter {{yang}} berisi rincian cart data, seperti img url , goods name , goods detail , dan goods amt penjelasan rinci pada {{parameter}} item parameter deskripsi contoh / catatan goods id id barang aa12345 dapat berisi kode yang berasal dari {{merchant}} , taxfee , shippingfee atau discount goods name nama barang ant life goods amt harga barang 200000 goods type tipe barang others goods detail rincian barang aa1345678 goods quantity jumlah barang 1 goods url tautan barang http //nicestore go/product/book/ goods sellers id id penjual barang {{nicepay}} nama {{merchant}} goods sellers name nama penjual barang {{nicepay}} shop cartdata payloan 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" } ] } parameter goods id pada cartdata mempengaruhi perhitungan amt dengan rumus seperti berikut amt = ( shipmentfee + taxfee + goods amt + ) discount contoh berikut perhitungan berdasarkan data dari cartdata {{payloan}} kredivo registration shipmentfee = 10000 taxfee = 5000 goods amt = 200000 discount = 20000 amt = (10000 + 5000 + 200000) 20000 = 215000 20000 = 195000 payloan seller data {{payloan}} seller data berisi data {{informasi}} seller {{yang}} dikirimkan oleh seller kepada {{partner}} {{nicepay}} untuk digunakan sebagai validasi seller saat ber {{transaksi}} menggunakan {{metodebayar}} {{payloan}} parameter deskripsi contoh sellersid id seller sel123 sellersnm nama seller sellers 1 sellersemail email seller sellers\@test com sellersurl tautan seller http //nicestore store sellersaddress > sellernm nama seller sellers sellersaddress > sellerlastnm nama belakang seller 1 sellersaddress > selleraddr alamat seller jalan berbangsa 1 sellersaddress > sellercity kota asal seller jakarta barat sellersaddress > sellerpostcd kode pos seller 12344 sellersaddress > sellerphone telepon seller 08123456789 sellersaddress > sellercountry negara asal seller 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" } } ]