Webview
Nossos parceiros podem integrar a página Klavi Ki em seus próprios aplicativos através de webview.
Os parceiros podem usar os seguintes parâmetros predefinidos ao chamar a página Klavi Ki. Além disso, é possível personalizar quaisquer parâmetros que correspondam ao esquema de URL com base em seus próprios negócios.
Parâmetro | Propósito | Observação |
uuid (exigido) | Identificador de usuário único no sistema do parceiro. | Se fornecido, esses dados serão incluídos no relatório JSON para correspondência de usuários no sistema do parceiro. |
cpf (opcional) | - Identificação do usuário; - Necessário como credencial de conexão bancária; | Se não for fornecido pelo parceiro, o usuário precisará inseri-lo na página do link (Klavi Ki). |
bank_id (opcional) | O banco restrito para conexão. | Se o bank_id estiver incluído, o usuário só poderá se conectar ao banco específico. O bank_id segue os códigos do banco central: - Banco do Brasil: 001 - Bradesco: 237 - Caixa: 104 - Itaú: 341 - Santander: 033 |
callback_url (exigido) | A URL de redirecionamento após a conexão com o banco. Podendo ser uma página da web ou uma página de aplicativo nativo. | Para incluir um callback_url dentro da URL completa, o valor do callback_url deve ser processado na função encodeURIcompenent() da seguinte maneira: - “%3a” substitui “:” - “%2f” substitui “/” - “%3f” substitui “?” - “%3d” substitui “=” |
cancel_url (exigido) | A URL de redirecionamento quando os usuários cancelam a conexão com o banco. Podendo ser uma página da web ou uma página de aplicativo nativo. | Para incluir um cancel_url dentro da URL completa, o valor do cancel_url deve ser processado na função encodeURIcompenent() da seguinte maneira: - “%3a” replaces “:” - “%2f” replaces “/” - “%3f” replaces “?” - “%3d” replaces “=” |
Exemplo de URL Klavi Ki redirecionando para uma página da web:
A URL de retorno (callback_url) correspondente após a decodificação:
https://partnerDomain.com?partnerParameter=value
O link completo para incorporar o Klavi Ki através do webview é o seguinte:
https://open-test.klavi.ai/partner_code?cpf=12345678910&callback_url=https%3a%2f%2fpartnerDomain.com%3fpartnerParameter%3dvalue