Conectar a Yever
Como conectar o checkout Yever com o token de API e criar o webhook de pedidos no painel da Yever, em 2 passos.
Atualizado em 09/11/2026Só o dono da marca
A Yever é conectada em dois passos: o token de API (para criar os cupons) e o webhook de pedidos (para os pedidos chegarem). A Yever não deixa criar webhooks por API, então o segundo passo é feito no painel dela. Só o dono da marca pode conectar.
Passo 1: token de API#
- Na Yever, vá em Configuração › API › Novo token, gere um token e copie (ele só aparece uma vez lá).
- No painel da marca, abra Configurações › Loja. Se a plataforma ainda não foi escolhida, clique em Yever.
- No card Yever, clique em Conectar Yever.
- Em 1. Token de API, cole o token em Token de API e clique em Conectar. Antes de salvar, o painel testa o acesso.
Se você ainda não tem o token do webhook, aparece "Yever conectada." com o aviso "Falta o token do webhook: sem ele os pedidos não chegam em tempo real."
Passo 2: webhook de pedidos#
- Em 2. Webhook de pedidos, clique em Copiar URL.
- No painel da Yever, crie um webhook com essa URL.
- Marque os eventos Pedido criado, Pedido atualizado, Pedido pago e Pedido enviado. Os de carrinho, cashback e assinatura podem ficar desmarcados.
- Copie o token que a Yever mostrar, cole em Token do webhook e clique em Salvar.
- Aparece "Token do webhook salvo. Os próximos pedidos já chegam por aqui."
Depois, use Sincronizar produtos no card Ações para trazer o catálogo.
O que cada status significa#
| Status | Significado |
|---|---|
| Conectado | Token de API salvo e válido. No card da Loja, "Conectado, falta o webhook" indica que o passo 2 não foi feito. |
| Erro | A Yever recusou o token ou uma operação falhou. O motivo aparece em "Último erro". |
| Não configurado | Nenhuma conta conectada. |
Erros comuns e o que fazer#
| Mensagem | Por quê | O que fazer |
|---|---|---|
| "Esse não parece um token de API da Yever (formato 123|abc...). Copie o token inteiro, com o número e a barra." | O token foi colado pela metade. | Copie o token inteiro, incluindo o número e a barra. |
| "A Yever recusou esse token. Gere um novo em Configuração › API › Novo token e cole aqui." | Token revogado ou inválido. | Gere um token novo na Yever. |
| "O token do webhook deve ter só letras e números (64 caracteres na Yever)." | Foi colado o token errado no campo do webhook. | Cole o token exibido na configuração do webhook na Yever. |
| "Não foi possível falar com a Yever: …" | A Yever não respondeu. | Tente de novo em alguns minutos. |
| "Somente o dono da marca pode alterar a conexão com a Yever." | Você é da equipe. | Peça para o dono. |
Trocar o token ou desconectar#
- Trocar token de API → Salvar novo token: troca o token sem perder nada.
- Trocar token do webhook: troca só o token do passo 2.
- Desconectar: os pedidos já sincronizados ficam; novos cupons e pedidos param. Para revogar o acesso de vez, apague o token e o webhook no painel da Yever.

