NICEPAY API
...
Registration - API Payloan
Seamless - Registration API Payloan
18 min
tentang seamless registration api payloan transaksi tipe seamless adalah {{layanan}} {{payloan}} milik {{nicepay}} {{yang}} memberikan pengalaman {{pembayaran}} nanti atau cicilan lebih cepat dan efisien melalui {{layanan}} ini, pengguna dapat menghubungkan akun mereka dengan {{merchant}} tanpa perlu melakukan autentikasi {{transaksi}} seperti login akun terlebih dahulu saat {{pembayaran}} sehingga, setiap {{proses}} {{transaksi}} antara {{pelanggan}} dan {{merchant}} dapat berjalan lebih efisien tanpa pengulangan tahap autentikasi login akun pengguna dengan keamanan {{yang}} tetap terjaga dan dapat diandalkan oleh {{nicepay}} saat ini, hanya kredivo {{yang}} sudah mendukung fitur seamless terdapat dua cara untuk mengaktifkan {{transaksi}} dengan tipe seamless, yaitu m elakukan tokenize data {{pelanggan}} dengan membuat {{transaksi}} terlebih dahulu menggunakan fitur docid\ iwdion18mil5dyf 5fl3w halaman ini menjelaskan lebih mendalam mengenai {{proses}} tokenize data {{pelanggan}} melalui {{transaksi}} pertama, sehingga fitur seamless dapat digunakan untuk {{transaksi}} berikutnya alur proses tokenize tokenize with transaction tokenize with transaction deskripsi alur {{pelanggan}} melakukan checkout {{pelanggan}} mengajukan checkout kepada {{merchant}} {{merchant}} mengajukan checkout kepada {{nicepay}} {{nicepay}} mengajukan checkout kepada {{payloan}} {{partner}} {{payloan}} {{partner}} mendaftarkan checkout {{payloan}} {{partner}} mengirimkan response kepada {{nicepay}} {{nicepay}} mengirimkan redirect url kepada {{merchant}} {{merchant}} mengarahkan {{pelanggan}} menuju {{halaman}} {{partner}} {{pelanggan}} melakukan login pada halaman login {{partner}} {{pelanggan}} mengirimkan kredensial kepada {{payloan}} {{partner}} {{payloan}} {{partner}} melakukan validasi login {{payloan}} {{partner}} mengirimkan laporan {{settlement}} kepada {{pelanggan}} {{pelanggan}} melihat laporan {{settlement}} {{pelanggan}} membayar dan mengonfirmasi {{settlement}} kepada {{payloan}} {{partner}} {{payloan}} {{partner}} melakukan validasi {{pembayaran}} pada saat {{proses}} {{transaksi}} berlangsung jika {{transaksi}} disetujui, maka {{payloan}} {{partner}} mem {{proses}} persetujuan {{payloan}} {{partner}} mengirimkan hasil persetujuan kepada {{nicepay}} {{nicepay}} menerima hasil persetujuan {{nicepay}} mengirimkan hasil persetujuan kepada {{merchant}} {{merchant}} menerima {{notifikasi}} hasil persetujuan {{merchant}} melakukan pengajuan {{status}} kepada {{nicepay}} {{nicepay}} melakukan pengecekan {{status}} {{nicepay}} mengirimkan hasil {{status}} kepada {{merchant}} {{merchant}} menerima {{status}} akhir {{merchant}} mengirimkan {{status}} {{notifikasi}} kepada {{pelanggan}} {{pelanggan}} menerima hasil persetujuan jika {{transaksi}} masih diperiksa, maka {{payloan}} {{partner}} mengarahkan {{pelanggan}} menuju {{halaman}} {{merchant}} / {{nicepay}} {{pelanggan}} ditampilkan {{halaman}} {{merchant}} / {{nicepay}} {{pelanggan}} menunggu persetujuan tokenize without transaction tokenize without transaction deskripsi alur {{pelanggan}} mendaftarkan nomor telepon kepada {{merchant}} {{merchant}} mengajukan penghubungan akun kepada {{nicepay}} {{nicepay}} mengajukan penghubungan akun kepada {{payloan}} {{partner}} {{payloan}} {{partner}} melakukan validasi {{payloan}} {{partner}} mengirimkan response kepada {{nicepay}} {{nicepay}} melakukan return redirect url terhadap {{merchant}} {{merchant}} mengarahkan {{pelanggan}} menuju {{halaman}} {{partner}} {{pelanggan}} melakukan login melalui halaman login {{partner}} {{pelanggan}} mengirimkan kredensial kepada {{payloan}} {{partner}} {{payloan}} {{partner}} melakukan validasi login {{payloan}} {{partner}} melakukan return otp terhadap {{pelanggan}} {{pelanggan}} memasukkan otp kepada {{payloan}} {{partner}} {{payloan}} {{partner}} melakukan generate user token {{payloan}} {{partner}} mengarahkan {{pelanggan}} menuju {{halaman}} {{merchant}} / {{nicepay}} pada saat {{proses}} pengajuan penghubungan akun pada {{bagian}} {{pelanggan}} halaman {{nicepay}} / {{merchant}} ditampilkan pada {{pelanggan}} {{pelanggan}} menunggu persetujuan dari {{bagian}} notifikasi {{payloan}} {{partner}} mengirimkan {{notifikasi}} kepada {{nicepay}} {{nicepay}} menerima {{notifikasi}} {{nicepay}} mengirimkan {{notifikasi}} kepada {{merchant}} {{merchant}} menerima {{notifikasi}} {{merchant}} menampilkan hasil penghubungan akun kepada {{pelanggan}} deactivate tokenize {{silakan}} kunjungi {{halaman}} docid\ wiucdqtrpbwlzgorlprhs untuk {{informasi}} lebih lanjut terkait {{proses}} menonaktifkan user token pada fitur seamless tokenize registration api payloan (first payment) api endpoint nicepay/direct/v2/registration request method post post description create user token merchant token sha256 ( imid + referenceno + billingphone + merchantkey ) request format application/json request parameter for tokenize registration api payloan (first payment) 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 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\\"}}] tokenizeuser required required n 1 seamless {{payloan}} transaction tokenize type 0 normal 1 tokenize (first transaction) 2 seamless (next {{paymentproduct}} ) 1 clientuserkey required required an 100 seamless {{payloan}} (mandatory) user key, must be unique for each {{customer}} gili heriawan\@nicepay co id response parameter for tokenize registration api payloan (first payment) 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 (key from {{nicepay}} ) ionpaytest02201607291027025291 referenceno ans 40 {{merchant}} order number (key from {{merchant}} ) ordno20160525000 52104 paymethod n 2 docid\ iifmsruuw7j9vmwefjz97 06 amt n 12 {{paymentproduct}} amount 1000 currency an 3 currency idr goodsnm an 100 goods name {{merchant}} goods 1 billingnm a 30 buyer name buyer name transdt n 8 transaction date ( yyyymmdd ) 20160303 transtm n 6 transaction time ( hh24miss ) 135959 description an 100 transaction description payment of ordno20160525000 52104 bankcd a 4 docid\ ky4ppujot06atnie easf bmri vacctno n 20 {{va}} number 123457891011 vacctvaliddt n 8 va expiry date ( yyyymmdd ) 20160303 vacctvalidtm n 6 va expiry time ( hh24miss ) 135959 mitracd an 4 docid\ tm257gq3dxgzf98uz0l33 kdvi payno n 12 cvs number 123456789012 payvaliddt n 8 cvs expiry date ( yyyymmdd ) 20170313 payvalidtm n 6 cvs expiry time ( hh24miss ) 135959 paymentexpdt n 6 qr {{paymentproduct}} expiry date ( yyyymmdd ) 20201005 paymentexptm n 6 qr {{paymentproduct}} expiry time ( hh24miss ) 124354 qrcontent ans 360 qr string in plain text 00020101021226590016id co shopee www011893600918000041566602064156660303ume52045399530336054045 005802id5913nicepay dummy6015kota jakarta se61051287062360520082020100512385458400708t000000163044a04 qrurl ans 360 url for qr image, valid for 5 minutes https //api wallet airpay co id/v3/merchant host/qr/download?qr=wocikheixwgyjnuuk6phjlts1e9ros7zf0esj6aavq clientuserkey an 100 user key, must be unique for each {{customer}} gili heriawan\@nicepay co id setelah {{pelanggan}} berhasil melakukan {{pembayaran}} {{transaksi}} dengan tokenize, {{merchant}} akan mendapatkan parameter usertoken dari docid\ tulcqsl5ciqkzdym3dfiv terkait {{pembayaran}} sukses melalui url parameter dbprocessurl pada saat registrasi {{transaksi}} tokenize sebelumnya usertoken tersebut akan digunakan untuk mengaktifkan fitur seamless pada {{transaksi}} berikutnya sample parameter for tokenize registration api payloan (first payment) request parameter { "timestamp" "20210913090977", "imid" "payloantes", "paymethod" "06", "currency" "idr", "amt" "25145", "referenceno" "ord20210913090977", "goodsnm" "test transaction nicepay", "billingnm" "customer name", "billingphone" "12345678", "billingemail" "email\@merchant com", "billingaddr" "jalan bukit berbunga 22", "billingcity" "jakarta", "billingstate" "dki jakarta", "billingpostcd" "12345", "billingcountry" "indonesia", "deliverynm" "email\@merchant com", "deliveryphone" "12345678", "deliveryaddr" "jalan bukit berbunga 22", "deliverycity" "jakarta", "deliverystate" "dki jakarta", "deliverypostcd" "12345", "deliverycountry" "indonesia", "dbprocessurl" "http //ptsv2 com/t/nicepay test/post", "merchanttoken" "596129570572f2ce4f6b459a09c8c1aaf36910ed6f3feb5a6da0a7086233714a", "reqdomain" "merchant com", "reqserverip" "127 0 0 1", "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\\" \[{\\"goods id\\" \\"bb12345678\\",\\"goods detail\\" \\"bb12345678\\",\\"goods name\\" \\"pasar modern\\",\\"goods amt\\" \\"25145\\",\\"goods type\\" \\"sembako\\",\\"goods url\\" \\"http //merchant com/cellphones/iphone5s 64g\\",\\"goods quantity\\" \\"1\\",\\"goods sellers id\\" \\"sel123\\",\\"goods sellers name\\" \\"sellers 1\\"}]}", "sellers" "\[{\\"sellersid\\" \\"sel123\\",\\"sellersnm\\" \\"sellers 1\\",\\"sellersemail\\" \\"sellers\@test com\\",\\"sellersaddress\\" {\\"sellernm\\" \\"sellers\\",\\"sellerlastnm\\" \\"1\\",\\"selleraddr\\" \\"jalan berbangsa 1\\",\\"sellercity\\" \\"jakarta barat\\",\\"sellerpostcd\\" \\"12344\\",\\"sellerphone\\" \\"08123456789\\",\\"sellercountry\\" \\"id\\"}}]", "instmnttype" "2", "instmntmon" "1", "mitracd" "kdvi", "tokenizeuser" "1", "clientuserkey" "gili heriawan\@nicepay co id", "usertoken" "" } response parameter { "resultcd" "0000", "resultmsg" "success", "txid" "payloantes06202109130937199795", "referenceno" "ord20210913090977", "paymethod" "06", "amt" "25145", "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, "clientuserkey" "gili heriawan\@nicepay co id" } seamless registration api payloan api endpoint nicepay/direct/v2/registration request method post post description create user token merchant token sha256 ( imid + referenceno + billingphone + merchantkey ) request format application/json request parameter for seamless registration api payloan parameter tipe ukuran kebutuhan deskripsi contoh / catatan timestamp n 14 mandatory {{api}} request date 20170708123456 imid an 10 mandatory {{merchant}} id payloantes paymethod an 2 mandatory docid\ iifmsruuw7j9vmwefjz97 06 payloan 06 currency an 3 mandatory currency idr amt n 12 mandatory {{paymentproduct}} amount 1000 referenceno ans 40 mandatory {{merchant}} order number (key from {{merchant}} referencenumber001 goodsnm an 100 mandatory goods name {{merchant}} goods 1 billingnm a 30 mandatory buyer name buyer name billingphone n 15 mandatory buyer phone number 02112345678 billingemail an 40 mandatory buyer email buyer\@merchant com billingaddr an 100 buyer address billing address billingcity a 50 mandatory buyer city jakarta billingstate a 50 mandatory billing state jakarta billingpostcd n 10 mandatory billing post number 12345 billingcountry a 10 mandatory billing country indonesia deliverynm a 30 mandatory delivery name buyer name deliveryphone n 15 mandatory delivery phone number 02112345678 deliveryaddr an 100 mandatory delivery address billing address deliverycity a 50 mandatory delivery city jakarta deliverystate a 50 mandatory delivery state jakarta deliverypostcd n 10 mandatory delivery post number 12345 deliverycountry a 10 mandatory delivery country indonesia dbprocessurl an 255 mandatory {{paymentproduct}} notification url (async notification) "http //www merchant com/notification” description an 100 transaction description description merchanttoken an 255 mandatory {{merchant}} token 6cfccfc0046773c1b589d8e98f8b596c284f3c70a4ecf86eba14c18944b74bcd userip an 15 mandatory user ip ( {{customer}} ) 127 0 0 1 usersessionid an 100 user session id usersessionid useragent an 100 user agent information mozilla userlanguage a 2 user language en us cartdata an 4000 mandatory cart data (json format) sellers an 4000 mandatory sellers (json format) instmnttype n 2 mandatory installment type 1 {{customer}} charge 2 {{merchant}} charge 2 instmntmon n 2 mandatory installment month 1 mitracd a 4 mandatory docid\ tm257gq3dxgzf98uz0l33 kdvi kredivo kdvi tokenizeuser n 1 seamless {{payloan}} transaction tokenize type 0 normal 1 tokenize (first transaction) 2 seamless (next {{paymentproduct}} ) 2 usertoken an 50 seamless {{payloan}} user token for using seamless {{payloan}} feature you can get this token from dbprocessurl notification after tokenize is success 59bd0cc5 0b26 42ae be0f caeab9424f95 response parameter for seamless registration api payloan parameter tipe ukuran deskripsi contoh / catatan resultcd n 4 result code 0000 resultmsg an 255 result message success txid an 30 transaction id (key from {{nicepay}} ) ionpaytest02201607291027025291 referenceno ans 40 {{merchant}} order number (key from {{merchant}} ) ordno20160525000 52104 paymethod n 2 docid\ iifmsruuw7j9vmwefjz97 06 amt n 12 {{paymentproduct}} amount 1000 currency an 3 currency idr goodsnm an 100 goods name {{merchant}} goods 1 billingnm a 30 buyer name buyer name transdt n 8 transaction date ( yyyymmdd ) 20160303 transtm n 6 transaction time ( hh24miss ) 135959 description an 100 transaction description payment of ordno20160525000 52104 bankcd a 4 docid\ ky4ppujot06atnie easf bmri vacctno n 20 {{va}} number 123457891011 vacctvaliddt n 8 va expiry date ( yyyymmdd ) 20160303 vacctvalidtm n 6 va expiry time ( hh24miss ) 135959 mitracd an 4 docid\ tm257gq3dxgzf98uz0l33 kdvi payno n 12 cvs number 123456789012 payvaliddt n 8 cvs expiry date ( yyyymmdd ) 20170313 payvalidtm n 6 cvs expiry time ( hh24miss ) 135959 paymentexpdt n 6 qr {{paymentproduct}} expiry date ( yyyymmdd ) 20201005 paymentexptm n 6 qr {{paymentproduct}} expiry time ( hh24miss ) 124354 qrcontent ans 360 qr string in plain text 00020101021226590016id co shopee www011893600918000041566602064156660303ume52045399530336054045 005802id5913nicepay dummy6015kota jakarta se61051287062360520082020100512385458400708t000000163044a04 qrurl ans 360 url for qr image, valid for 5 minutes https //api wallet airpay co id/v3/merchant host/qr/download?qr=wocikheixwgyjnuuk6phjlts1e9ros7zf0esj6aavq clientuserkey an 100 user key gili heriawan\@nicepay co id usertoken an 50 user token for seamless, only returned in {{the}} response body when {{the}} {{transaction}} is seamless (tokenizeuser 2 ) 59bd0cc5 0b26 42ae be0f caeab9424f95 sample parameter for seamless payment api payloan request parameter { "timestamp" "20210913090998", "imid" "payloantes", "paymethod" "06", "currency" "idr", "amt" "25145", "referenceno" "ord20210913090998", "goodsnm" "test transaction nicepay", "billingnm" "customer name", "billingphone" "12345678", "billingemail" "email\@merchant com", "billingaddr" "jalan bukit berbunga 22", "billingcity" "jakarta", "billingstate" "dki jakarta", "billingpostcd" "12345", "billingcountry" "indonesia", "deliverynm" "email\@merchant com", "deliveryphone" "12345678", "deliveryaddr" "jalan bukit berbunga 22", "deliverycity" "jakarta", "deliverystate" "dki jakarta", "deliverypostcd" "12345", "deliverycountry" "indonesia", "dbprocessurl" "http //ptsv2 com/t/nicepay test/post", "merchanttoken" "14d2461cb1d5399c82343d0e3a8e12cdcc845625e966d0ed5fb8de6a02b3433d", "reqdomain" "merchant com", "reqserverip" "127 0 0 1", "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\\" \[{\\"goods id\\" \\"bb12345678\\",\\"goods detail\\" \\"bb12345678\\",\\"goods name\\" \\"pasar modern\\",\\"goods amt\\" \\"25145\\",\\"goods type\\" \\"sembako\\",\\"goods url\\" \\"http //merchant com/cellphones/iphone5s 64g\\",\\"goods quantity\\" \\"1\\",\\"goods sellers id\\" \\"sel123\\",\\"goods sellers name\\" \\"sellers 1\\"}]}", "sellers" "\[{\\"sellersid\\" \\"sel123\\",\\"sellersnm\\" \\"sellers 1\\",\\"sellersemail\\" \\"sellers\@test com\\",\\"sellersaddress\\" {\\"sellernm\\" \\"sellers\\",\\"sellerlastnm\\" \\"1\\",\\"selleraddr\\" \\"jalan berbangsa 1\\",\\"sellercity\\" \\"jakarta barat\\",\\"sellerpostcd\\" \\"12344\\",\\"sellerphone\\" \\"08123456789\\",\\"sellercountry\\" \\"id\\"}}]", "instmnttype" "2", "instmntmon" "1", "mitracd" "kdvi", "tokenizeuser" "2", "clientuserkey" "", "usertoken" "e0478456 6b50 460c 85e0 627a1e22d2e0" } response parameter { "resultcd" "0000", "resultmsg" "success", "txid" "payloantes06202109130955379813", "referenceno" "ord20210913090998", "paymethod" "06", "amt" "25145", "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, "usertoken" "e0478456 6b50 460c 85e0 627a1e22d2e0" }