Whitelabel Initiation

whitelabel application customization klavi payment whitelabel application support certain customization, such as font and its size, page style, title and other information please reach out to us at suporte\@klavi ai get a starting payment url first of all, you need to get a starting adapter url by calling /payment/customer/v1/payment links then use this adapter url to redirect the user to input payment data, and to checkout at last note you should always call /payment/customer/v1/payment links on your backend service for security reasons curl request example curl location 'https //api sandbox klavi ai/payment/customer/v1/payment links' \\ \ header 'content type application/json' \\ \ header 'accept application/json' \\ \ header 'authorization bearer null' \\ \ data '{ "accesskey" "8db39152 428d 11f0 b712 46c9ef66b111", "secretkey" "6abe2470 7c27 482e b515 2623e9cd3c98", "payment" { "institutionid" "c8f0bf49 4744 4933 8960 7add6e590841", "clientrequestid" "1", "customer" { "identifiertype" "cpf", "identifier" "76109277673", "name" "klavi test" }, "date" "2025 07 02", "inittype" "pix manu", "amount" "1333 00", "currency" "brl", "redirecturl" "http //test", "creditoraccount" { "ispb" "87654321", "issuer" "1234", "number" "12345678", "accounttype" "cacc", "holder" { "identifier" "44471172000119", "name" "klavi", "identifiertype" "cnpj" } }, "clientmetadata" { "os" "macos", "osversion" "3 2 1", "platform" "browser" } } }' response example { "id" "fcb72e3a b346 4f71 b044 971dc23232c9", "paymenturl" "https //api sandbox klavi ai/?v=rvgvvvddoyir81gywjx9h1kbk55", } redirect user to payment url once you receive response from /payment links , redirect the user to paymenturl the user can complete the payment initiation flow on klavi front page redirect user back to redirect url user inputs payment data and checkouts on klavi front page the front page loops to get status of payment initiation once the front page receives the status of successful payment initiation, it redirects the user to the paymenturl which was sent in the /payment links request once receives the status of error payment initiation, it redirects user to the paymenturl check the status of the payment initiation once your system redirects user to adapterurl, the user completes the payment initiation flow totally in klavi front page environment but your system can check the status of the payment initiation by looping to call /payments/\ id/status every few seconds the id property was included in the response at /payment links endpoint in order for your system to better track user payment initiation, the externalid proprety is advised in the request payload at /payment links endpoint api call sequence diagram ​ https //docs klavipay ai/docs/dev guides/integration page/page#flows