Magic Link

O Connect é aberto através de um link customizado para cada usuário. Esse link pode ser aberto pelo usuário através de um SMS, Email, Whatsapp ou em através de um clique de botão no seu aplicativo ou website.

Para isso é necessário que algumas informações pessoais do usuário sejam repassadas para o Guiabolso, como por exemplo, o email, cpf e telefone do usuário. Mas não se preocupe, nós garantimos o tráfego seguro de informações do usuário através do protocolo de comunicação TLS 1.3 e criptografia RSA 2048 bits.


ParâmetroDescrição
cpfCPF válido do usuário em formato numérico, por exemplo, 12345678910
emailEmail válido do usuário, por exemplo, meunome@minhaempresa.com.br
phoneTelefone do usuário com DDD em formato numérico, por exemplo, 119123456789
userTrackingIdID do usuário do lado do cliente, deve ser único e não sensível, ou seja, não use o CPF do usuário aqui mas um hash de CPF que seja único por usuário ou um UUID por exemplo, 273117c3-e374-436c-a7ad-adba544872ba. Esse campo será usado para rastrearmos seu usuário dentro da nossa plataforma. Toda a comunicação de suporte será feita através desse ID.
clientIdID da sua credencial
callbackURLURL de redirecionamento, precisa ser previamente cadastrada no Guiabolso e precisa ser uma página dentro do domínio do cliente. Caso o cliente ainda não tenha uma, podemos usar a seguinte página interna de forma temporária: https://connect.guiabolso.com.br/callback. Isso não prejudicará o uso do Connect em fase de testes.
fallbackURLURL usada como rota de fuga caso o usuário feche o Connect e não deseje continuar no fluxo

Para gerar um link basta fazer a seguinte chamada na nossa API passando o seguinte objeto JSON no body da requisição.

POST https://kasbah.guiabolso.com.br/partner/events/

COPIAR
{
"name": "gbconnect:url:generate",
"version": 1,
"id": UUID,
"flowId": UUID,
"payload": {
"user": {
"cpf": CPF_VALIDO,
"email": EMAIL_VALIDO,
"phone": TELEFONE_NUMERICO_VALIDO_COM_DDD,
"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 o link gerado deste 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": {}
}
Anterior
Como funciona a integração
Próximo
2. Popup vs. IFrame

© 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