Seamless - Registration API Payloan

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