# Pagar.me

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

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**.

:::aviso 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.

:::info 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.
:::