Abrir o Connect

Para abrir o nosso produto você precisa antes de tudo das suas chaves de API. Tudo o que você precisa fazer é usar o nosso link de integração passando o seu CLIENT_ID e a CALLBACK_URL cadastrada e algumas informações do usuário como parâmetros na URL, assim como mostra o código abaixo.

COPIAR
https://connect.guiabolso.com.br/#/integracao
?clientId=CLIENT_ID
&callbackURL=CALLBACK_URL
&fallbackURL=https%3A%2F%2Fconnect.guiabolso.com.br%2F
&userTrackingId=USER_TRACKING_ID
&email=user@domain.com.br
&cpf=12345678909
&phone=11999999999

Toda URL, tanto a de callback quanto a de fallback, devem ser decodificadas em UTF-8.


Glossário de Parâmetros


ParâmetroDescrição
cpfOBRIGATÓRIOCPF do usuário em formato numérico, por exemplo, 99999999999
emailOPCIONALEmail do usuário, por exemplo, user@domain.com.br
phoneOPCIONALTelefone do usuário com DDD em formato numérico, por exemplo, 11999999999
userTrackingIdOBRIGATÓRIOEsse ID do usuário deve ser único e não sensível, ou seja, não use o CPF do usuário aqui mas use um UUID, por exemplo, 273117c3-e374-436c-a7ad-adba544872ba. Esse campo será usado para rastrearmos seu usuário dentro da nossa plataforma.
clientIdOBRIGATÓRIOID da sua chave de API
callbackURLOBRIGATÓRIOURL de redirecionamento quando o usuário clicar em "Compartilhar análise", enviaremos o usuário para essa URL, por padrão definido como https://connect.guiabolso.com.br/callback
fallbackURLOBRIGATÓRIOURL de redirecionamento quando o usuário fechar o modal ou a janela em qualquer momento, por padrão definido como https://connect.guiabolso.com.br/

Criptografia dos Dados


Para garantir o tráfego seguro dessas informações mesmo dentro do protocolo de comunicação TLS 1.3 e criptografia RSA 2048 bits, nós fornecemos uma API para que o link de integração seja criptografado com informações pessoais do usuário. Para gerar o link criptografado para cada usuário, envie um POST request para https://kasbah.guiabolso.com.br para a rota /partner/events/.

COPIAR
{
"name": "gbconnect:url:generate",
"version": 1,
"id": UUID,
"flowId": UUID,
"payload": {
"user": {
"cpf": "12345678909",
"email": "user@domain.com.br",
"phone": "11999999999",
"trackingId": USER_TRACKING_ID
},
"callbackURL": CALLBACK_URL,
"fallbackURL": FALLBACK_URL
},
"identity": {
"clientId": CLIENT_ID
},
"auth": {
"clientSecret": CLIENT_SECRET
},
"metadata": {}
}

Você receberá uma resposta no seguinte formato, com a URL de integração para este usuário.

COPIAR
{
"name": "gbconnect:url:generate:response",
"version": 1,
"id": UUID,
"flowId": UUID,
"auth": {},
"identity": {},
"payload": {
"url": "https://connect.guiabolso.com.br/#/integracao?blob=AQICAHiT%2Bk%2FPDMzLasWvXiVYaTXLzKvx3T41Fl%2B5G6%2FP7kLi4gG9whJsF8amCIe1LrZZHt1XAAABujCCAbYGCSqGSIb3DQEHBqCCAacwggGjAgEAMIIBnAYJKoZIhvcNAQcBMB4GCWCGSAFlAwQBLjARBAzub3YMnXQ%2FscxMnOQCARCAggFtzA4FU3frvNWjNMMjwslpPf%2FDKBKoylIlkCdxyHIzLvziPCC8%2BBIIA%2Bf%2BNUxnca1y2282uXu%2BmsBn%2FusWpqittUIZobpz73nf4WkF4oCfPzzmCINJZnS3L7BOeHLHEi0FFTJWOkERJoJJnI%2BkEc%2BZeSjc9vyXQEa0aauLBa98huRTD8MNBwSCF%2FcJ%2BZuTpeQU%2FXwNc4%2FdvgmYt0fDpSagefjbc7ftk84gRev%2Fz33HfhJsS53eA1CLmPLRebA1GmuK2nAJ2u%2F2OzOpg6mBu71fpET%2FImINMPnEeFePG5bfOfC6BDFEDCR4NGU%2FVZuqYfwOTXd%2BsfSUU5tUAtBUtrDPR5LFnSGY5EWIJHNLVoN2t4p5i7t3LW%2FkeI%2FqpDMPePHcFeatJ9H%2BA%2Fg%2Bb4aEv3qBMpLs7B3hhxM%2F8iMf8ZQ6ylNdGXJ19TOb%2BgukJCdeaw45MQ%2BU6g42d0r3veCDfZQ5iCDuuetsyQXA4TIVe"
},
"metadata": {}
}

Redirecionamento vs. Modal


Existem hoje 3 formas de abrir o Connect, a primeira redirecionando o usuário para o nosso ambiente, a segunda abrindo um modal (popup) e a terceira através de um iFrame. Esta última ainda está em fase de teste e deverá ser anunciada em breve.

Modal


Você pode disponibilizar um botão na sua página que abra o modal do Connect (nós recomendamos que o tamanho do modal seja de 992 x 800). Neste caso, você também precisaria cadastrar um Listener para o evento de retorno onde receberá o código de autorização do usuário, como mostrado abaixo.

COPIAR
<button onclick="openGuiabolsoConnect()">Guiabolso Connect</button>
<script>
const openGuiabolsoConnect = () => {
window.open(INTEGRATION_URL, 'gbConnectWindow', 'width=992,height=800');
};
</script>
COPIAR
window.addEventListener("message", handleGBData, false);
const handleGBData = message => {
const hasAuthCode = message?.data?.authcode;
const isGBCOrigin =
message?.origin === 'https://connect.guiabolso.com.br';
if (isGBCOrigin && hasAuthCode) {
const oauthcode = message?.data?.authcode;
console.log('@oauthcode', oauthcode);
}
};

Redirecionamento


De forma alternativa, você pode simplesmente redirecionar o usuário para o nosso ambiente. Isso quer dizer que quando o usuário terminar o fluxo e clicar em Compartilhar análise na última tela da nossa experiência, nós redirecionaremos o usuário de volta para sua plataforma através da CALLBACK_URL e enviaremos o código de autorização dentro dessa URL como query parameter.

COPIAR
https://callback.com/?code=<AUTH_CODE>

Mas preste atenção, este código de autorização é válido por 60 minutos, isso significa que você tem 60 minutos para pedir autorização para nossa API em nome do usuário usando esse código.

IFrame

Conteúdo será disponibilizado em breve.

Anterior
Fluxo de Integração
Próximo
2. Obter Token de Acesso

© GuiaBolso Finanças Correspondente Bancário e Serviços LTDA 2020

O Guiabolso Connect utiliza cookies e tecnologias similares, como pixels e tags, para oferecer a melhor experiência para o usuário. Ao utilizar nossos serviços, você concorda com essa utilização. Mais detalhes no item 5 da nossa Política de Privacidade