Central de Ajuda Paylog Central de Ajuda Paylog

Conectar a Yampi

Configure o webhook da Yampi e relacione o SKU do item ao pacote.

Nesta página 4

Conecte a Yampi para receber pedidos pagos e encaminhar os produtos físicos à expedição do Paylog.

1. Crie a integração

Em Ferramentas > Integrações > Todas as integrações, abra o cartão Yampi, clique em Nova integração e informe o Identificador/Usuário da loja, a Data de início e a Hora de início.

Campos para criar uma integração Yampi

Importante

Na Yampi, o Paylog compara a data de criação da transação (ou, na falta dela, a data de criação do pedido) com a data e hora de início. Pedidos criados antes desse instante são ignorados permanentemente como Fora de Prazo.

2. Configure o webhook

Abra a aba Webhooks da página da Yampi e clique em Copiar URL. No painel Yampi, acesse Configurações > Webhooks > Novo webhook e cadastre a URL. A nomenclatura dos eventos pode variar; confirme na documentação atual da Yampi.

O pedido é criado quando a situação da compra chega como paid, invoiced, sent ou delivered. waiting_payment, cancelled e refused são registrados sem criar pedido, e os eventos de carrinho, cliente, produto e estoque (cart.reminder, customer.created, product.*) são descartados.

URL do webhook Yampi

3. Relacione o SKU ao pacote

O Paylog usa o SKU do primeiro item recebido no pedido para localizar o pacote.

Em Catálogo > Pacotes, crie ou edite o pacote e adicione uma referência Yampi com o SKU exato da variação vendida.

Importante

Como a identificação parte do primeiro item, mantenha o SKU e a composição da oferta consistentes. Se uma mesma venda puder começar por SKUs diferentes, valide cada cenário antes de ativar em produção.

4. Confirme e teste

Na aba Configurações, confirme que a integração aparece com o status ATIVO. Faça um pedido pago com endereço completo e confira o evento em Ferramentas > Integrações > Postbacks e o pacote escolhido.

Situação O que verificar
Pacote não encontrado SKU da variação diferente da referência Yampi.
Fora de Prazo Data de criação da transação/pedido anterior ao início.
Pedido não criado Situação da compra fora da lista aceita ou todos os itens marcados como is_digital.
Pacote incorreto Ordem dos itens e SKU do primeiro item enviado pela Yampi.
Atualizado em 07/08/2026