Olá! Este tópico explica como realizar a integração e a configuração do webhook do Pagar.me na plataforma Ecom-d, permitindo a sincronização automática dos status de pagamento dos pedidos.
Durante o processo, você utilizará dois ambientes:
- Painel do Pagar.me;
- Painel da Ecom-D.
1. Configuração no Painel da Ecom-d
1.1 - Acesse as configurações do Pagar.me
Na plataforma Ecom-d, você deve acessar as configurações da integração com o Pagar.me.
Para isso, vá até Integrações > Pagamentos > Pagar.me, conforme mostrado na imagem abaixo.
1.2 Acesse as configurações de webhook do Pagar.me
Após acessar as configurações da integração com o Pagar.me, role a página até o final do formulário. Você encontrará a seção Configurações do Webhook, que estará desativada por padrão. Para ativá-la e configurá-la, siga os passos abaixo:
- Neste campo, você pode habilitar o webhook do Pagar.me na plataforma Ecom-d.
- Este switch, quando ativado, faz com que o pedido seja automaticamente cancelado caso o Pagar.me retorne um status relacionado a falha no pagamento.
Além disso, existem os campos de autenticação do webhook, que são de suma importância para o funcionamento correto da integração.
Por motivos de segurança, a plataforma Ecom-d ignora webhooks enviados pelo Pagar.me que não possuam autenticação (configuração realizada diretamente no painel do Pagar.me).
Para gerar as credenciais de autenticação, siga os passos abaixo:
1 - Clique em “Gerar credenciais” para que o username e o password sejam criados.
2. Após a geração, armazene as credenciais em um local seguro.
Após salvar o formulário, essas informações serão ocultadas e, caso seja necessário recuperá-las, será preciso gerar novas credenciais.
Importante: essas credenciais serão utilizadas posteriormente na configuração dos webhooks no painel do Pagar.me.
3. Após concluir os passos acima, clique em Salvar para aplicar as configurações.
2. Configuração no Painel do Pagar.me
2.1 Acesse as configurações de webhooks
Após efetuar login no painel do Pagar.me, selecione sua loja, acesse o perfil da conta e vá até Configurações > Webhooks, conforme mostrado na imagem abaixo. Logo em seguida, clique em “Criar webhook” para iniciarmos sua criação.
2.2 Criação do Webhook
Após iniciarmos a criação do webhook, irá ser exibido essa tela. Segue abaixo a descrição de cada passo ilustrado na imagem:
1. Neste campo, deve ser informada a URL que receberá os eventos enviados pelo Pagar.me. Utilize o seguinte formato: https://seu-dominio/api/pagarmePay
Importante: certifique-se de incluir o prefixo https:// na URL. Sem ele, os eventos do webhook não funcionarão corretamente.
2. Este campo define a quantidade de tentativas que o Pagar.me fará para reenviar os eventos do webhook em caso de falha no envio. O Pagar.me permite configurar no máximo 3 tentativas. Recomendamos definir no mínimo 2 tentativas, para garantir o reenvio dos eventos caso ocorra algum erro temporário.
3. Este campo é essencial para o funcionamento dos webhooks na plataforma Ecom-d. Por motivos de segurança, a Ecom-d não processa webhooks do Pagar.me que não possuam autenticação. Portanto, caso este campo não seja configurado, os eventos enviados pelo Pagar.me não serão recebidos pela plataforma. Após habilitar a autenticação, informe o username e o password gerados na plataforma Ecom-d, que devem ter sido armazenados previamente em um local seguro.
Após concluir essas configurações, siga para a etapa de seleção dos eventos que serão enviados para este webhook.
De modo geral, este tutorial aborda a integração dos status de pagamento com o Pagar.me. Portanto, os eventos relacionados à Cobrança (charge) são os que devem receber maior atenção durante essa configuração.
A seguir, estão listados os eventos que a plataforma Ecom-d trata para atualização dos status de pagamento dos pedidos:
- charge.antifraud_reproved
- charge.paid
- charge.payment_failed
- charge.pending
- charge.refunded
- charge.underpaid
- charge.updated
Após finalizar as configurações do webhook, será solicitado que você informe a sua senha do Pagar.me para confirmar as alterações. Após inserir a senha, clique em Salvar, conforme indicado na imagem abaixo.
3. Conclusão
Dessa maneira, a integração e a configuração do webhook do Pagar.me na plataforma Ecom-d estarão concluídas.
A partir desse momento, os eventos de cobrança (charge) enviados pelo Pagar.me passarão a ser recebidos e processados pela Ecom-d, permitindo a atualização automática dos status de pagamento dos pedidos.
