Antes de instalar qualquer extensão Pagar.me no WooCommerce, identifique a versão de API e o produto de pagamento da conta. A documentação do Pagar.me diferencia versões e parte do material legado está marcada como antiga. Não misture exemplos de API, chaves ou payloads de versões diferentes.
Faça uma verificação de compatibilidade
Parta dos links atuais fornecidos pelo painel/atendimento Pagar.me e confirme quem mantém o plugin, quando foi atualizado, quais versões declara suportar e quais meios de pagamento cobre. O repositório público do plugin ajuda a inspecionar seu estado, mas não substitui a confirmação comercial/técnica de compatibilidade com sua conta.
Confira também WordPress, WooCommerce, checkout, moeda, moeda de liquidação e operação de reembolso. Registre dependências e custo, e faça backup antes de testar qualquer mudança na loja em produção.
Teste em ambiente controlado
Use sandbox e credenciais de teste conforme documentação da versão contratada. Verifique aprovação, recusa, cancelamento, atualização do pedido, notificações e conciliação no painel. Se não houver ambiente de teste para a jornada necessária, peça ao suporte um procedimento seguro; não faça cobranças fictícias em produção.
Critérios para decidir
Considere a integração aprovada apenas quando o fornecedor confirmar compatibilidade e os testes reproduzirem a jornada acordada. Documente extensão, versão de API, credenciais por ambiente, eventos de notificação, responsáveis e procedimento de reversão. Reavalie após atualizações importantes.
Referências oficiais
- Repositório do plugin Pagar.me para WooCommerce
- Visão geral das APIs atuais do Pagar.me
- Documentação Pagar.me v2 marcada como legada
- Pagamentos no WooCommerce