Um checkout externo pode mudar a página de pagamento, o retorno à loja e a forma como pedidos são sincronizados. Antes de instalar uma extensão, confirme no canal oficial Yampi se a integração com WooCommerce e as versões de WordPress, WooCommerce e PHP do projeto são suportadas atualmente.
Faça um inventário da operação atual
Registre gateway ativo, plugins de pagamento, regras de frete, cupons, estoque, eventos de analytics e emails. Identifique qual sistema será a fonte oficial do status do pedido e quem tratará falhas de sincronização. Revise taxa, prazo de repasse, chargebacks, cancelamento e regras contratuais diretamente com Yampi e o provedor.
Instale a integração oficial Checkout Yampi para WooCommerce indicada na central de ajuda Yampi, seguindo o vídeo e a tela de instalação correspondentes à versão atual. Faça backup, instale primeiro em staging e conecte pela conta Yampi; não use plugin com nome parecido de terceiro. Depois, no WordPress, confira WooCommerce > Configurações > Avançado > Webhooks: a documentação Yampi cita os webhooks Yampi product create, Yampi product updated, Yampi product deleted e Yampi order updated; confirme que estão ativos para sincronizar catálogo e pedidos.
A Yampi lista incompatibilidades conhecidas com alguns plugins de cache/segurança e numeração de pedidos — entre eles W3 Total Cache, Wordfence, LiteSpeed Cache, Sequential Order Number for WooCommerce e 301 Redirects na data da documentação consultada. Não remova componentes indiscriminadamente: confirme a lista atual com o suporte, desative um por vez em staging e valide checkout, webhooks e segurança antes de decidir.
Teste checkout e retorno ao WooCommerce
Percorra um pedido aprovado, recusado, cancelado e reembolsado. Confira se o comprador retorna ao endereço correto, se estoque e status atualizam uma vez, se a notificação chega e se pedido duplicado não é criado. Teste frete, desconto, variação, mobile e email de confirmação.
| Cenário | Conferência |
|---|---|
| Compra aprovada | Pedido pago e conciliação pela referência correta |
| Pagamento recusado | Sem baixa indevida de estoque ou status pago |
| Retorno interrompido | Notificação atualiza o pedido quando aplicável |
| Reembolso | Fluxo e estado financeiro documentados |
Se não houver Sandbox, combine teste controlado e estorno conforme as regras do fornecedor. Só publique a integração após repetir os fluxos críticos numa janela combinada. Se mudanças de produto não chegarem ao painel da Yampi, examine o status dos quatro webhooks; se pedidos duplicarem ou não atualizarem, consulte erros e logs da integração antes de reprocessar. A lista de plugins incompatíveis pode mudar, portanto consulte a documentação atual do WooCommerce na Yampi. Use o checklist de compra antes do lançamento.