Como integrar a Pagar.me ao Vestige

Este guia mostra como cadastrar no painel da Pagar.me o webhook gerado pelo Vestige e informar a credencial necessária para validar as notificações.

Antes de começar

Seu usuário da Pagar.me precisa ter acesso de administrador, gerente ou desenvolvedor. Você também precisará de acesso às configurações de webhooks e às chaves da conta.

1. Obtenha a URL no Vestige

1. Acesse Configurações → Integrações.
2. Abra Pagar.me.
3. Copie a URL do webhook exibida pela integração.

Use a URL apresentada pela sua conta do Vestige. Não copie a URL de screenshots antigos ou de exemplos de outras contas.

2. Crie o webhook na Pagar.me

1. Acesse o painel da Pagar.me.
2. Abra Configurações → Webhooks.
3. Clique em Criar Webhook.
4. Cole a URL copiada do Vestige.
5. Configure o máximo de tentativas como 3, quando esse campo estiver disponível.
6. Não habilite uma autenticação adicional no webhook, conforme o procedimento de referência da integração.
7. Selecione os eventos disponíveis para a integração. No procedimento antigo, a orientação era Todos.
8. Selecione Todos os produtos, quando a tela oferecer essa opção.
9. Digite sua senha no campo de confirmação da criação.
10. Salve as alterações.

Os nomes dos campos podem mudar na interface da Pagar.me. O ponto importante é cadastrar a URL do Vestige no recurso de Webhooks da conta correta.

3. Informe a chave da Pagar.me no Vestige

1. No painel da Pagar.me, abra Configurações → Chaves.
2. Localize a Chave secreta.
3. Copie a chave sem alterar seu conteúdo.
4. Volte à integração Pagar.me no Vestige.
5. Cole a chave no campo Token.
6. Salve a configuração da integração.

Trate a chave secreta como credencial. Não publique o valor, não o coloque em screenshots e não o envie em canais de suporte.

4. Teste

Depois de salvar o webhook e o token, siga Como testar uma integração de vendas. Uma requisição recebida não significa automaticamente que uma venda válida foi criada: o Vestige ainda precisa receber um evento compatível com o processamento da integração.

Vendas por boleto só devem ser esperadas no relatório depois da compensação do pagamento. Para diferenciar aprovação, pendência e reembolso, consulte Quais status de venda o Vestige considera?.

Se as vendas não aparecerem

Confira novamente a URL, a conta Pagar.me, a permissão do usuário, o webhook ativo, os eventos selecionados e o token informado no Vestige. Depois, consulte O webhook está configurado, mas as vendas não aparecem.