NICEPAY API
...
Registration - API Payloan
Seamless - Registration API Payloan
18 min
tentang seamless registration api payloan transaksi tipe seamless adalah milik memberikan pengalaman nanti atau cicilan lebih cepat dan efisien melalui ini, pengguna dapat menghubungkan akun mereka dengan tanpa perlu melakukan autentikasi seperti login akun terlebih dahulu saat sehingga, setiap antara dan dapat berjalan lebih efisien tanpa pengulangan tahap autentikasi login akun pengguna dengan keamanan tetap terjaga dan dapat diandalkan oleh saat ini, hanya kredivo sudah mendukung fitur seamless terdapat dua cara untuk mengaktifkan dengan tipe seamless, yaitu m elakukan tokenize data dengan membuat terlebih dahulu menggunakan fitur docid\ iwdion18mil5dyf 5fl3w halaman ini menjelaskan lebih mendalam mengenai tokenize data melalui pertama, sehingga fitur seamless dapat digunakan untuk berikutnya alur proses tokenize tokenize with transaction tokenize with transaction deskripsi alur melakukan checkout mengajukan checkout kepada mengajukan checkout kepada mengajukan checkout kepada mendaftarkan checkout mengirimkan response kepada mengirimkan redirect url kepada mengarahkan menuju melakukan login pada halaman login mengirimkan kredensial kepada melakukan validasi login mengirimkan laporan kepada melihat laporan membayar dan mengonfirmasi kepada melakukan validasi pada saat berlangsung jika disetujui, maka mem persetujuan mengirimkan hasil persetujuan kepada menerima hasil persetujuan mengirimkan hasil persetujuan kepada menerima hasil persetujuan melakukan pengajuan kepada melakukan pengecekan mengirimkan hasil kepada menerima akhir mengirimkan kepada menerima hasil persetujuan jika masih diperiksa, maka mengarahkan menuju / ditampilkan / menunggu persetujuan tokenize without transaction tokenize without transaction deskripsi alur mendaftarkan nomor telepon kepada mengajukan penghubungan akun kepada mengajukan penghubungan akun kepada melakukan validasi mengirimkan response kepada melakukan return redirect url terhadap mengarahkan menuju melakukan login melalui halaman login mengirimkan kredensial kepada melakukan validasi login melakukan return otp terhadap memasukkan otp kepada melakukan generate user token mengarahkan menuju / pada saat pengajuan penghubungan akun pada halaman / ditampilkan pada menunggu persetujuan dari notifikasi mengirimkan kepada menerima mengirimkan kepada menerima menampilkan hasil penghubungan akun kepada deactivate tokenize kunjungi docid\ wiucdqtrpbwlzgorlprhs untuk lebih lanjut terkait 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 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 's reference number ord12345 callbackurl ans 255 result url goodsnm required required an 100 goods name test transaction 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 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 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 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 , 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 transaction tokenize type 0 normal 1 tokenize (first transaction) 2 seamless (next ) 1 clientuserkey required required an 100 seamless (mandatory) user key, must be unique for each 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 ) ionpaytest02201607291027025291 referenceno ans 40 order number (key from ) ordno20160525000 52104 paymethod n 2 docid\ iifmsruuw7j9vmwefjz97 06 amt n 12 amount 1000 currency an 3 currency idr goodsnm an 100 goods name 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 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 expiry date ( yyyymmdd ) 20201005 paymentexptm n 6 qr 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 gili heriawan\@nicepay co id setelah berhasil melakukan dengan tokenize, akan mendapatkan parameter usertoken dari docid\ tulcqsl5ciqkzdym3dfiv terkait sukses melalui url parameter dbprocessurl pada saat registrasi tokenize sebelumnya usertoken tersebut akan digunakan untuk mengaktifkan fitur seamless pada 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 request date 20170708123456 imid an 10 mandatory id payloantes paymethod an 2 mandatory docid\ iifmsruuw7j9vmwefjz97 06 payloan 06 currency an 3 mandatory currency idr amt n 12 mandatory amount 1000 referenceno ans 40 mandatory order number (key from referencenumber001 goodsnm an 100 mandatory goods name 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 notification url (async notification) "http //www merchant com/notification” description an 100 transaction description description merchanttoken an 255 mandatory token 6cfccfc0046773c1b589d8e98f8b596c284f3c70a4ecf86eba14c18944b74bcd userip an 15 mandatory user ip ( ) 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 charge 2 charge 2 instmntmon n 2 mandatory installment month 1 mitracd a 4 mandatory docid\ tm257gq3dxgzf98uz0l33 kdvi kredivo kdvi tokenizeuser n 1 seamless transaction tokenize type 0 normal 1 tokenize (first transaction) 2 seamless (next ) 2 usertoken an 50 seamless user token for using seamless 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 ) ionpaytest02201607291027025291 referenceno ans 40 order number (key from ) ordno20160525000 52104 paymethod n 2 docid\ iifmsruuw7j9vmwefjz97 06 amt n 12 amount 1000 currency an 3 currency idr goodsnm an 100 goods name 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 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 expiry date ( yyyymmdd ) 20201005 paymentexptm n 6 qr 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 response body when 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" }