[Pagar.me] Como habilitar a integração

1. Acesse sua conta na Pagar.me 1.0.
2. No menu à esquerda, clique em Configurações > Dados da API.
3. Clique em "Criar Chave", insira um nome para identificar a chave e a senha do dashboard. Você poderá definir a chave criada como a de assinatura dos postbacks marcando o checkbox disponível.

É possível criar até 10 chaves — uma para cada integração desejada.

1. Copie e armazene a chave em local seguro — ela só poderá ser visualizada uma única vez.
2. Copie o código da Chave API.
3. Faça login na sua conta eNotas.
4. Vá em Gerenciar > Apps.
5. Localize a integração com a Pagar.me 1.0 e clique em "Ativar".
6. Cole a Chave Secreta copiada da Pagar.me 1.0 e clique em Confirmar.
7. Informe se deseja configurar uma garantia em suas vendas. Se sim, preencha o número de dias.
8. Informe se deseja que as notas sejam emitidas automaticamente.
9. Informe quando a emissão deve ocorrer:

• Venda em aberto — no momento da criação da venda na eNotas
• Na venda — após a confirmação do pagamento
• Após a garantia — após o período de garantia informado

1. Informe se deseja que as notas sejam encaminhadas automaticamente para o e-mail dos clientes.
2. Clique em Confirmar.
3. Informe se vendas canceladas na Pagar.me 1.0 com notas emitidas devem acionar o cancelamento automático das notas junto ao órgão emissor.

⚠️ IMPORTANTE! Toda venda cancelada na plataforma de vendas será cancelada automaticamente no seu painel. Esta configuração tem relação apenas com os casos em que a venda já possui nota fiscal emitida.

1. Clique em Confirmar.
2. Informe um produto padrão para vendas sem produto atribuído na Pagar.me. Busque o produto existente ou crie um novo:

• Preencha o nome do produto, a garantia (em dias) e o tipo de nota fiscal.
• Clique no ícone de engrenagem para configurar o tipo de nota (NFS-e ou NF-e) e preencha os campos necessários.
• Clique em Confirmar.

1. Clique em Confirmar.
2. Clique em Visualizar meus dados para verificar como ficou a configuração.

⚠️ IMPORTANTE! A não configuração do produto padrão poderá impedir a importação de vendas para o seu painel, pois não será possível importar as vendas que não possuem um produto associado.

O processo de habilitação da integração 2.0 é semelhante ao da 1.0. Obtenha sua Chave API (Secret Key) no painel da Pagar.me 2.0 e siga os passos abaixo na eNotas:

1. Faça login na sua conta eNotas.
2. Vá em Gerenciar > Apps.
3. Localize a integração com a Pagar.me 2.0 e clique em "Ativar".
4. Cole a Chave Secreta copiada da Pagar.me 2.0 e clique em Confirmar.
5. Configure as preferências de emissão (garantia, emissão automática, quando emitir, envio por e-mail) e clique em Confirmar.
6. Configure o cancelamento automático de notas em vendas canceladas e clique em Confirmar.
7. Informe o produto padrão para vendas sem produto atribuído e clique em Confirmar.
8. Clique em Visualizar meus dados para confirmar a configuração.

As configurações de produto padrão e metadados após a habilitação seguem o mesmo padrão — veja as seções abaixo.

1. Faça login na sua conta eNotas.
2. Vá em Gerenciar > Apps.
3. Localize a integração com a Pagar.me 1.0 e clique em Editar.
4. Localize a configuração de produto padrão:

• Se não possui produto padrão: clique em "Alterar" em "Vendas sem produto estão sendo ignoradas".
• Se já possui e deseja alterar: clique em "Alterar" em "Vendas sem produto estão sendo criadas com o produto...".

1. Busque o produto existente ou crie um novo:

• Preencha o nome do produto, a garantia (em dias) e o tipo de nota fiscal.
• Clique no ícone de engrenagem para configurar o tipo de nota (NFS-e ou NF-e) e preencha os campos necessários.
• Clique em Confirmar.

1. Clique em Confirmar.
2. Clique em Visualizar meus dados para conferir a configuração.

Ao finalizar, todas as vendas sem produto atribuído na Pagar.me 1.0 terão as notas emitidas com o produto padrão selecionado.

A configuração de metadados é opcional e permite personalizar informações usadas na emissão das notas fiscais. Caso já tenha definido um produto padrão ou suas vendas já venham com os dados do produto, essa configuração não interfere na importação das vendas.

Passo 1 — Configurar os metadados na Pagar.me (via API)

Configure os metadados desejados nas transações usando a API da Pagar.me, enviando as informações adicionais no campo metadata de cada transação (ex.: valorNFe).

Passo 2 — Verificar se o metadado está chegando na eNotas

1. Dentro de suas vendas na eNotas, clique na venda desejada e vá ao ícone de Relógio.
2. Clique no ícone de correntes referente ao status "Venda realizada automaticamente" para visualizar o registro de integração e confirmar os metadados recebidos.

Passo 3 — Adicionar os metadados nas configurações do App na eNotas

1. Faça login na plataforma do eNotas.
2. Vá em Gerenciar > Apps.
3. Clique em "Editar" no app da Pagar.me.
4. Na opção de Metadados, clique em "Alterar".
5. Configure os dados conforme as variáveis informadas no JSON da Pagar.me, usando "+" para adicionar e "–" para remover um metadado.
6. Clique em Confirmar.

Com a incorporação da Mundipagg pela Pagar.me, surgiu um novo painel chamado Pagar.me 2.0. Clientes que adquiriram a Pagar.me antes da incorporação continuam com acesso à versão 1.0. Novos clientes credenciados após a incorporação utilizam a versão 2.0. Ambas possuem integração com a eNotas, por Apps distintos.

Acesse o painel da Pagar.me e verifique o visual da plataforma. Caso tenha acesso ao painel legado, sua integração é com a Pagar.me 1.0 e deve usar o App correspondente na eNotas. Caso o painel seja o novo, use o App da Pagar.me 2.0. Em caso de dúvida, entre em contato com a Pagar.me para confirmar.

O produto padrão é utilizado pela eNotas para emitir a nota fiscal quando nenhum produto vem vinculado à venda importada da Pagar.me. Sem essa configuração, vendas sem produto associado serão ignoradas e as notas não serão emitidas.

Vendas realizadas antes da ativação da integração não são importadas automaticamente. Será necessário exportar o relatório de vendas da Pagar.me e importá-lo manualmente na eNotas. Consulte o artigo sobre importação de vendas retroativas.

Não. Na integração com a Pagar.me, a própria plataforma de vendas é responsável por gerenciar e distribuir os valores entre os participantes. A eNotas importa todas as vendas presentes na conta integrada sem diferenciação entre vendas com e sem coprodução.