NICEPAY API
...
Registration - API Payloan
Seamless - Registration API Payloan
18 min
about seamless registration api payloan seamless type {{transaction}} is a {{payloan}} {{service}} owned by {{nicepay}} that provides a faster and more efficient paylater and installment {{payment}} experience through this {{service}} , users can link their accounts with {{merchant}} s without needing to performs {{transaction}} authentication beforehand, such as logging in, during {{the}} {{payment}} therefore, every {{transaction}} between {{customer}} s and {{merchant}} s can run efficiently without re authenticating {{the}} user account login steps with security that remain protected and reliable by {{nicepay}} currently, only kredivo which already supports {{the}} seamless feature there are 2 steps to activates a {{transaction}} with seamless type, which are performs {{the}} {{customer}} 's data tokenization by making a {{transaction}} first using {{the}} docid\ rs x7jhsv 7xj6nk u6yt feature this {{page}} explain {{the}} {{customer}} 's data tokenization on first {{payment}} {{process}} deeper, so that {{the}} seamless feature can be used on {{the}} next {{transaction}} process flow tokenize tokenize with transaction tokenize with transaction flow description the {{customer}} does checkout the {{customer}} requests a {{checkout}} to {{the}} {{merchant}} the {{merchant}} requests a {{checkout}} to {{nicepay}} {{nicepay}} requests a {{checkout}} to {{the}} {{payloan}} {{partner}} the {{payloan}} {{partner}} registers {{the}} {{checkout}} the {{payloan}} {{partner}} sends a response to {{nicepay}} nicepay sends a redirect url to {{the}} {{merchant}} the {{merchant}} redirects {{the}} {{customer}} to {{the}} {{partner}} 's {{page}} the {{customer}} do logins through {{the}} {{partner}} login page the {{customer}} mengirimkan kredensial kepada the {{payloan}} {{partner}} the {{payloan}} {{partner}} melakukan validasi pembayaran during the transaction process if the transaction is approved, then the {{payloan}} {{partner}} processes the approval the {{payloan}} {{partner}} sends an approval result to nicepay nicepay receives the approval result nicepay sends the approval result to the merchant the {{merchant}} receives the approval result notification the {{merchant}} request a status to nicepay nicepay checks the status nicepay sends a status result to the merchant the {{merchant}} receives the final status the {{merchant}} sends a notification status to {{the}} {{customer}} the {{customer}} receives the approval result if the transaction is still processing the {{payloan}} {{partner}} directs {{the}} {{customer}} to the merchant/nicepay page the merchant/nicepay page will be shown to the {{customer}} the {{customer}} waiting for approval tokenize without transaction tokenize without transaction flow description the {{customer}} submits a phone number to {{the}} {{merchant}} the {{merchant}} requests an account binding to {{nicepay}} {{nicepay}} requests an account binding to {{the}} {{payloan}} {{partner}} the {{payloan}} {{partner}} performs validation the {{payloan}} {{partner}} sends a response to {{nicepay}} {{nicepay}} returns {{the}} redirects url to the {{merchant}} the {{merchant}} redirects {{the}} {{customer}} to {{the}} {{partner}} 's {{page}} the {{customer}} do logins through {{the}} {{partner}} login page the {{customer}} sends a credential to {{the}} {{payloan}} {{partner}} the {{payloan}} {{partner}} performs login validation the {{payloan}} {{partner}} returns an otp to {{the}} {{customer}} the {{customer}} inputs the otp to {{the}} {{payloan}} {{partner}} the {{payloan}} {{partner}} generates a user token the {{payloan}} {{partner}} directs {{the}} {{customer}} to {{the}} {{merchant}} / {{nicepay}} {{page}} during {{the}} account binding {{process}} on {{the}} {{customer}} 's {{section}} the {{merchant}} / {{nicepay}} {{page}} will be shown to {{the}} {{customer}} the {{customer}} waiting for approval from {{the}} notification {{section}} {{payloan}} {{partner}} sends a {{notification}} to {{the}} {{nicepay}} {{nicepay}} receives {{the}} {{notification}} {{nicepay}} sends a {{notification}} to {{the}} {{merchant}} the {{merchant}} receives {{the}} {{notification}} the {{merchant}} displays {{the}} account binding result to {{the}} {{customer}} deactivate tokenize {{please}} visit {{the}} docid\ oejszomb2auxasvc4ivfq {{page}} for further {{information}} about {{the}} user token inactivation {{process}} with seamless feature 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 type length description example / notes 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}} , if 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 after {{the}} {{customer}} successfully make {{transaction}} {{payment}} with tokenization, {{merchant}} will obtain a usertoken parameter from docid\ mx4cicfhpck1zbto ufek regarding {{the}} success {{payment}} through a dbprocessurl parameter url during {{the}} registration of previous tokenized {{transaction}} usertoken will be used to activate {{the}} seamless feature on {{the}} next {{transaction}} 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 type length mandatory description example / notes timestamp n 14 mandatory {{api}} request date 20170708123456 imid an 10 mandatory {{merchant}} id payloantes paymethod an 2 mandatory {{paymentproduct}} method 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}} ) {{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 0upx1lyg1o2f4biu3ssp 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 caeab9424f9y response parameter for seamless registration api payloan parameter type length description example / notes 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 registration 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" }