Como configurar o Pagar.me V5

[Luiza]

Pagar.me V5

Este tutorial é do aplicativo Pagar.me V5, que usa a API v5 do Pagar.me. O aplicativo antigo chamado só Pagar.me usava a API anterior, que o Pagar.me descontinuou: se a sua loja ainda usa o app antigo, instale e configure o Pagar.me V5.

Com o Pagar.me V5 você recebe pagamentos com cartão de crédito, boleto e Pix, e também pode vender assinaturas (pagamento recorrente com cartão ou boleto):

• Integração direta com a API v5 do Pagar.me;
• Atualização automática de status da transação;
• Plano de assinatura customizável.

Antes de começar

Configurações no Pagar.me necessárias para o funcionamento total da integração.

Com o seu dashboard do Pagar.me aberto:

Configurações da conta

1. Vá no menu lateral e clique na opção CONFIGURAÇÕES
2. Em seguida clique em Conta
3. Nas opções de configuração da conta, clique em Editar
4. Vá até Domínios
   
5. Adicione os domínios usados pela sua loja e clique em Salvar

Adicionando os webhooks

1. No menu lateral, na opção CONFIGURAÇÕES
2. Clique na opção Webhooks
3. Nas opções de webhooks, clique em Criar Webhook
4. Na URL, adicione a seguinte url:
   https://us-central1-ecom-pagarme5.cloudfunctions.net/app/pagarme/webhooks?store_id=SEU_STORE_ID_AQUI

OBS.: troque SEU_STORE_ID_AQUI pelo número da sua loja. Ele aparece no painel da E-Com Plus em Configurações > Conta, no rodapé do quadro, como Store ID.

5. Em Eventos, marque os seguintes eventos:

Assinatura

• subscription.canceled
• subscription.created

Cobrança

• charge.overpaid
• charge.paid
• charge.partial_canceled
• charge.payment_failed
• charge.pending
• charge.processing
• charge.refunded
• charge.underpaid
• charge.updated

Pedido (para transações que NÃO são assinaturas)

• order.canceled
• order.paid
• order.payment_failed

6. Por fim, clique em Salvar

Obtendo as chaves

1. Ainda no menu lateral CONFIGURAÇÕES
2. Clique em Chaves
3. Copie a chave pública e a chave secreta. Elas serão usadas no aplicativo, no próximo passo.

Configurando o app na E-Com Plus

1. No painel, acesse Aplicativos e abra o Pagar.me V5. Se ainda não estiver instalado, clique em Instalar.
2. Na configuração do app, cole a Chave pública e a Chave secreta que você copiou no Pagar.me.
3. Se quiser, ajuste as outras opções:
   • Descrição da cobrança: como a cobrança aparece na fatura do cartão ou no boleto.
   • Cartão de crédito, Boleto bancário e Pix: rótulo e texto de cada forma de pagamento, ou a opção de desabilitar uma delas. Em Boleto bancário também ficam os dias até o vencimento e as instruções; em Pix, os minutos de validade.
   • Parcelamento: parcela mínima, máximo de parcelas, juros mensais e quantas parcelas sem juros.
   • Desconto: desconto para pagamento no boleto, no cartão ou no Pix (não vale para assinaturas).
   • Recorrência e Categorias para assinatura: só se você vende assinaturas. Para habilitar, marque Habilitar recorrência via cartão e/ou Habilitar recorrência via boleto.
4. Clique em Salvar.

Depois de salvar, faça um pedido de teste na loja.

---

Se o pagamento não aparecer no checkout ou o status do pedido não atualizar, abra um ticket informando o número do pedido, a forma de pagamento usada e um print da tela de webhooks do Pagar.me (não envie a chave secreta).