Pular para o conteúdo

Yampi

Veja como conectar a sua plataforma com a Yampi.

Nesta página

Com a integração da Yampi, cada pedido aprovado libera o acesso do aluno aos cursos da entrega. Reembolso, chargeback e cancelamento removem o acesso.

1. Crie a entrega na sua plataforma

  1. No painel, acesse Vendas › Entregas e clique em Nova Entrega.
  2. Na tela Selecione um Gateway, digite "Yampi" no filtro e clique em Yampi.
  3. Dê um nome à entrega e escolha a Modalidade de Venda: Venda única ou Assinatura.
  4. Em Conexão com o gateway, cole no campo ID do Produto o ID do produto na Yampi (veja abaixo). Um por linha.
  5. O campo Token é opcional: deixe em branco (veja a dica abaixo).
  6. Em Conteúdo entregue, marque os cursos ou vitrines que a venda libera e, se quiser, o Tempo de acesso e a turma em Liberação. Em Tags, marque as tags que o aluno deve receber.
  7. Clique em Salvar.
  8. Copie o endereço completo do campo URL de Postback, no formato https://<sua-plataforma>/api/postback/yampi/<token>. Ele só aparece depois de salvar.

Onde encontrar o ID do produto na Yampi

No painel da Yampi, clique em Produtos › ver todos. O ID aparece na linha de cada produto.

Sobre o campo Token

A Yampi mostra uma Chave Secreta na tela do webhook. Se você colar essa chave no campo Token, a venda só é aceita quando esse mesmo valor vier no envio. Se o teste mostrar o erro "Token do gateway não confere com o cadastrado na entrega", apague o campo, salve e reprocesse: a URL completa da entrega já autoriza as vendas.

2. Configure o webhook na Yampi

  1. No painel da Yampi, clique em Configurações › Webhooks e em Novo Webhook.
  2. Em Nome, coloque um nome que identifique a sua plataforma.
  3. Em URL, cole a URL de postback copiada da entrega.
  4. Selecione os eventos:
    • Pedido criado
    • O status de um pedido foi atualizado
    • Pedido atualizado
    • Pedido aprovado
  5. Selecione os produtos desta entrega.
  6. Clique em Salvar.

Sempre que passar a entregar um produto novo, acrescente-o à lista de produtos do webhook.

Kits (order bump da Yampi)

Cadastre normalmente os produtos de cada kit nas suas entregas. A Yampi envia uma notificação com cada ID de produto do kit.

3. Teste

  1. Faça uma compra de teste com um e-mail que não seja de administrador da plataforma (vendas com e-mail de administrador são recusadas).
  2. Acesse Vendas › Vendas. A venda aparece em Últimas (enquanto é processada, fica em Na Fila).
  3. Abra a venda (menu ··· › Ver detalhes) e confira o evento recebido, os IDs de produto/oferta no payload e, se houver, o Motivo do erro.
  4. Se precisar ajustar a entrega, corrija e clique em Reprocessar na venda.
Integração por leitura automática

A plataforma reconhece os campos mais comuns do envio da Yampi (e-mail, número do pedido, status e IDs dos produtos). Valide com uma venda real antes de abrir as vendas. Se algo não for reconhecido, a venda aparece em Vendas › Vendas, na aba Com erro, com o motivo.

Esta página ajudou?

Artigos relacionados