Ajuda Delivery
Search
⌃K

Autenticação Externa

Essa funcionalidade serve quando você já tem um publico construido em uma outra ferramenta e deseja que ele entre logado em seu delivery e quem sabe um desconto especial se ele for um consumidor especial ou participar de um clube que você criou.
Para implementação dessa funcionalidade será necessario você criar um provider com o protocolo OAuth2, para mais detalhes dessa implementação, verifique a documentação no site oficial.

Configuração Inicial

Em seu painel vai em Integrações > Autenticação Externa e informe os dados solicitados e ative, depois dessa configuração já vai ser possível fazer um login transparente do seu consumidor.

Autenticação Transparente

Você vai aprender como enviar um consumidor do seu aplicativo diretamente para o seu marketplace e já deixar ele com logado com a conta dele.
Você deve enviar ele para uma URL especifica do seu delivery com um code aonde ele servirá para realizar chamadas ao seu aplicativo perante o protocolo OAuth2.
Exemplo de chamada:
https://meudelivery.com/accounts/auth/delivery/callback?code=<SEU CODE AQUI>
Você também deve disponibilizar uma API para consultar os dados do consumidor e a URL deve ser.
Request GET /api/delivery/me
e o retorno deve ser um json com o seguinte formato, com todos os campos sendo obrigatórios.
Resposta
{
"id": "123",
"email": "[email protected]",
"name": "Meu Consumidor",
"phone": "00000000000"
}
Lembrando que na chamada de POST /oauth/token o retorno deve conter, token, refresh_token, expires_at.

Autenticação pelo Botão de Login

Em seu painel vai em Integrações > Autenticação Externa e clique em um ícone no canto direto em cima e vai em Botão de Login.
Configurando esse botão será possível o seu consumidor realizar um login diretamente no seu aplicativo, igual quando você entra em outros aplicativos e dá para "entrar com o facebook", que só nesse caso é o seu aplicativo.
Lembrando que para funcionar corretamente você tem que ter um provider com o OAuth2 configurado e com as seguintes rotas:
GET /oauth/authorize
POST /oauth/token
GET /api/delivery/me

Consumidor VIP

Agora você pode dar alguns mimos para os seus consumidores que assinam o seu clube de assinatura como um desconto por exemplo. Quando você habilitar isso, será possivel dar um desconto inteligente ou cupom para o seu consumidor vip, mas para isso funcionar precisamos saber se ele é realmente um consumidor vip e você vai precisar disponibilizar mais uma rota em sua api para a consulta:
Request GET /api/delivery/status/subscription
Retorno
{
"active": true
}