Pular para o conteúdo

Pagar.me

Veja como conectar a sua plataforma com a Pagar.me.

Nesta página

Com a integração da Pagar.me, cada pedido pago libera o acesso do aluno aos cursos da entrega. Pedido cancelado e assinatura cancelada removem o acesso.

1. Crie a entrega na sua plataforma

  1. No painel, acesse Vendas › Entregas e clique em Nova Entrega.
  2. Na tela Selecione um Gateway, clique em PagarMe (fica no grupo Principais).
  3. Dê um nome à entrega e escolha a Modalidade de Venda: Venda única ou Assinatura.
  4. Em Conexão com o gateway, cole no campo ID do Produto ou Assinatura o identificador do produto (veja abaixo). Um por linha.
  5. Em Conteúdo entregue, marque os cursos ou vitrines que a venda libera e, se quiser, o Tempo de acesso e a turma em Liberação. Em Tags, marque as tags que o aluno deve receber.
  6. Clique em Salvar.
  7. Copie o endereço completo do campo URL de Postback, no formato https://<sua-plataforma>/api/postback/pagarme/<token>. Ele só aparece depois de salvar.

Onde encontrar o ID do produto

Há dois caminhos, conforme onde o produto foi criado:

  • Na loja externa (o sistema que vende usando a Pagar.me): abra Produtos, selecione o produto e copie o ID, que aparece abaixo do nome da oferta ou na URL da página.
  • Na própria Pagar.me: clique em Vendas › Links de Pagamento, abra os Detalhes do link e, na aba Informações, copie o link de pagamento. O ID segue um padrão parecido com pl_cXdF8GRA22….

Na dúvida, faça uma venda de teste (passo 3) e veja qual ID chegou.

2. Configure o webhook na Pagar.me

  1. No painel da Pagar.me, acesse Configurações › Webhooks.
  2. Clique em Criar Webhook e preencha:
    • Status: Ativo
    • URL: a URL de postback copiada da entrega
    • Máximo de tentativas: 3
    • Eventos: order.paid, order.payment_failed, order.canceled, subscription.created e subscription.canceled
  3. Clique em Salvar.
Uma URL para cada entrega

A URL de postback leva o token de uma entrega e só libera o conteúdo dela. Como o webhook da Pagar.me envia os pedidos de todos os produtos, pedidos de produtos que não estão nessa entrega aparecem com erro em Vendas › Vendas (você pode usar Ignorar neles). Se vários produtos liberam o mesmo conteúdo, coloque todos os IDs na mesma entrega.

3. Teste

  1. Crie um produto de teste e faça uma compra com e-mail e CPF diferentes dos seus dados de administrador (vendas com e-mail de administrador são recusadas).
  2. Acesse Vendas › Vendas e abra a venda (menu ··· › Ver detalhes).
  3. Em IDs de produto/oferta no payload, veja quais IDs a plataforma leu. Na seção Payload, procure o campo items: o valor de code é o ID do produto.
  4. Se o ID for diferente do que está na entrega, corrija a entrega e clique em Reprocessar na venda.
Integração por leitura automática

A plataforma reconhece os campos mais comuns do envio da Pagar.me (e-mail, código do pedido, status e IDs dos itens). Valide com uma venda real antes de abrir as vendas. Se algo não for reconhecido, a venda aparece em Vendas › Vendas, na aba Com erro, com o motivo.

Esta página ajudou?

Artigos relacionados