Seamless - Registration API Paylater
18 min
tentang seamless registration api paylater 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 registration & notification account binding paylater api docid\ hu q 9uzjxf32uv9glbgk 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 deactivate account binding paylater api docid\ zzvrqbo6u quaiv2a0tmj untuk lebih lanjut terkait menonaktifkan user token pada fitur seamless tokenize registration api paylater (first payment) api endpoint nicepay/direct/v2/registration request method \<font color="#3b9f0f">post\</font> description create user token merchant token sha256 ( imid + referenceno + billingphone + merchantkey ) request format application/json request parameter for tokenize registration api paylater (first payment) parameter tipe ukuran deskripsi contoh / catatan timestamp \<font color="#2166ae">required\</font> n 14 request timestamp ( yyyymmddhh24miss ) 20220131125959 imid \<font color="#2166ae">required\</font> an 10 id payloantes paymethod \<font color="#2166ae">required\</font> n 2 payment method code docid\ g7inrv70xcsa9lp7bpmok 06 currency \<font color="#2166ae">required\</font> a 3 currency idr amt \<font color="#2166ae">required\</font> n 12 amount 10000 referenceno \<font color="#2166ae">required\</font> ans 40 's reference number ord12345 callbackurl ans 255 result url goodsnm \<font color="#2166ae"> \</font> \<font color="#2166ae">required\</font> an 100 goods name test transaction billingnm \<font color="#2166ae">required\</font> a 100 buyer name john doe billingphone \<font color="#2166ae">required\</font> n 15 buyer phone number 08123456789 billingemail \<font color="#2166ae">required\</font> ans 40 buyer e mail email\@merchant com billingaddr \<font color="#2166ae">required\</font> an 100 buyer address jalan bukit berbunga 22 billingcity \<font color="#2166ae">required\</font> a 50 buyer city jakarta billingstate \<font color="#2166ae">required\</font> a 50 billing state dki jakarta billingpostcd \<font color="#2166ae">required\</font> n 10 billing post number 12345 billingcountry \<font color="#2166ae">required\</font> a 10 billing country cartdata \<font color="#2166ae">required\</font> 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/ http //www nicestore com/product/beanie/ "}, ]} userip \<font color="#2166ae">required for cc, e wallet, paylater, qris\</font> an 15 user ip 127 0 0 1 dbprocessurl \<font color="#2166ae">required\</font> ans 255 notification url https //merchant com/dbprocessurl merchanttoken \<font color="#2166ae">required\</font> an 255 token 9b38b12e83b6ee124d4b549238f232c6179b168effc4ffb7f64d00c15f08e230 deliverynm \<font color="#2166ae">required\</font> a 30 delivery name email\@merhchant com deliveryphone \<font color="#2166ae">required\</font> n 15 delivery phone 08123456789 deliveryaddr \<font color="#2166ae">required\</font> an 100 delviery address jalan bukit berbunga 22 deliverycity \<font color="#2166ae">required\</font> a 50 delivery city jakarta deliverystate \<font color="#2166ae">required\</font> a 50 delivery state dki jakarta deliverypostcd \<font color="#2166ae">required\</font> n 10 delivery post code 12345 deliverycountry \<font color="#2166ae">required\</font> a 10 delivery country mitracd \<font color="#2166ae">required\</font> n 2 mitra code docid\ dwzaqdd7dxzmecz80a6o8 kdvi instmnttype \<font color="#2166ae">required\</font> n 8 installment type code docid 7cix u 4z295xgtnvesbo 2 instmntmon \<font color="#2166ae">required\</font> 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 \<font color="#2166ae">required\</font> 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 \<font color="#2166ae">required\</font> n 1 seamless transaction tokenize type 0 normal 1 tokenize (first transaction) 2 seamless (next ) 1 clientuserkey \<font color="#2166ae">required\</font> an 100 seamless (mandatory) user key, must be unique for each gili heriawan\@nicepay co id response parameter for tokenize registration api paylater (first payment) parameter tipe ukuran deskripsi contoh / catatan resultcd n 4 result code docid\ gvadbbr0sq92n1zhplsfm 0000 resultmsg an 255 result message error code docid\ yeh1va9k2y6sl1kqf2awd success txid an 30 transaction id (key from ) ionpaytest02201607291027025291 referenceno ans 40 order number (key from ) ordno20160525000 52104 paymethod n 2 payment method code docid\ g7inrv70xcsa9lp7bpmok 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 bank code docid 1u7qoax wrzxmocg mqad 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 mitra code docid\ dwzaqdd7dxzmecz80a6o8 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 notification api paylater docid\ tlx6s6yonkvomuyhjmq8z 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 paylater (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 paylater api endpoint nicepay/direct/v2/registration request method \<font color="#3b9f0f">post\</font> description create user token merchant token sha256 ( imid + referenceno + billingphone + merchantkey ) request format application/json request parameter for seamless registration api paylater parameter tipe ukuran kebutuhan deskripsi contoh / catatan timestamp n 14 mandatory request date 20170708123456 imid an 10 mandatory id payloantes paymethod an 2 mandatory payment method code docid\ g7inrv70xcsa9lp7bpmok 06 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 mitra code docid\ dwzaqdd7dxzmecz80a6o8 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 paylater 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 payment method code docid\ g7inrv70xcsa9lp7bpmok 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 bank code docid 1u7qoax wrzxmocg mqad 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 mitra code docid\ dwzaqdd7dxzmecz80a6o8 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 paylater 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" }