---
title: Pagar.me
slug: pagarme
docTags: 
createdAt: 2025-07-10T13:38:32.588Z
---

## Objetivo

O conector **Pagar.me** facilita a integração entre a plataforma Fluid e o sistema Pagar.me, permitindo a automação de processos relacionados a **Recebíveis**, **Operações de saldo**, **Pedidos** e **Cobranças**. Essa integração promove uma comunicação fluida e segura entre sistemas, ideal para micro e pequenas empresas que buscam eficiência operacional em seus processos financeiros.

[Documentação oficial Pagar.me](https://docs.pagar.me/)

## Criando um fluxo

1. Acesse a seção **Fluxos** na plataforma Fluid.
2. Clique em **Criar novo fluxo**.
3. Adicione uma ou mais conexões Pagar.me.
4. No canvas, arraste o conector **Pagar.me**.
5. Configure o módulo, recurso e operação conforme descrito abaixo.

## Criando conexão

1. Acesse **Conexões** no menu lateral da Fluid.
2. Clique em **Nova Conexão**.
3. Selecione **Pagar.me** como tipo de conexão.
4. Preencha os campos:
   - **Nome**: Nome descritivo da conexão.
   - **Descrição**: Breve descrição da finalidade da conexão.
   - **Chave secreta (API Key)**: Chave de autenticação fornecida pelo Pagar.me.
5. Clique em **Testar conexão**.
6. Se estiver tudo certo, clique em **Salvar conexão**.

:::hint{type="info"}
Para obter sua chave de API, acesse sua conta no painel do Pagar.me e copie a chave do ambiente desejado (Teste ou Produção).
:::

## Configurando fluxo

1. Selecione o conector **Pagar.me** no canvas do fluxo.
2. Acesse a aba **Parametrizações**.
3. Escolha um **módulo**:
   - Financeiro
   - Pagamentos
4. Escolha um **recurso**:
   - **Financeiro**
     - Recebível
     - Operações de saldo
   - **Pagamentos**
     - Pedidos
     - Item do pedido
     - Cobranças
5. Defina a **operação** para o recurso selecionado.

### Recursos e operações

### Recurso: Recebível

- **Listar recebíveis**
  Retorna todos os recebíveis da conta.
- **Obter recebível**
  Retorna detalhes de um recebível específico.

### Recurso: Operações de saldo

- **Listar histórico das operações**
  Lista todas as movimentações de saldo.
- **Obter histórico específico de uma operação**
  Recupera os detalhes de uma operação específica.

### Recurso: Pedidos

- **Listar pedidos**
  Lista todos os pedidos da conta.
- **Obter pedido**
  Retorna detalhes de um pedido específico.

### Recurso: Item do pedido

- **Obter item do pedido**
  Retorna detalhes de um item específico de um pedido.

### Recurso: Cobranças

- **Listar cobranças**
  Lista todas as cobranças realizadas.
- **Obter cobrança**
  Recupera os dados de uma cobrança específica.

:::hint{type="info"}
Corpo da requisição: Todas as operações exigem um corpo JSON conforme especificado na documentação da API Pagar.me.
:::

1. Acesse a aba **Propriedades**:
   - Selecione a conexão.
   - Nomeie o passo.
   - Adicione uma descrição, se necessário.

## Na prática

Neste tópico criaremos um exemplo de um fluxo utilizando o conector da Pagar.me. O fluxo terá apenas um passo que será responsável pela Listagem de recebíveis da API Pagar.me. Selecionamos o Modulo Financeiro e no Recurso Recebível selecionamos a operação Listar Recebíveis. 

::Image[]{src="https://api.archbee.com/api/optimize/G1NTw6yAi4RDUYbsU8csp/0ir60DN1sQRFTvDEkoMQ9_image.png" size="60" width="781" height="431" position="center" darkWidth="781" darkHeight="431" showCaption="false"}

- **Passo 'lista-recebiveis'**

Assim ficará a Parametrização do nosso primeiro e único passo:

::Image[]{src="https://api.archbee.com/api/optimize/G1NTw6yAi4RDUYbsU8csp/-r4a279IFZtlKxJuwtYBy_image.png" size="60" width="644" height="1129" position="center" darkWidth="644" darkHeight="1129" showCaption="false"}

Na aba Propriedades informamos o nome do passo e a conexão criada para o Pagar.me: 

::Image[]{src="https://api.archbee.com/api/optimize/G1NTw6yAi4RDUYbsU8csp/GOLirnd-WcMo-UUwfYO2__image.png" size="60" width="645" height="1125" position="center" darkWidth="645" darkHeight="1125" showCaption="false"}

## Disparando o fluxo

1. Clique em **Salvar**.
2. Execute o fluxo.
3. Visualize o resultado em tempo real no canvas.
4. Clique em **Detalhes** para acessar a requisição e resposta.

::Image[]{src="https://api.archbee.com/api/optimize/G1NTw6yAi4RDUYbsU8csp/7GIkSUHWCbDCjfakEyis8_image.png" size="60" width="828" height="323" position="center" showCaption="false"}

5\. Ao clicar em detalhes, temos a requisição e a resposta retornada pela Pagar.me: 

::Image[]{src="https://api.archbee.com/api/optimize/G1NTw6yAi4RDUYbsU8csp/UgwOpD0vU34hpyaknAZ6v_image.png" size="62" width="1143" height="791" position="center" showCaption="false"}

::Image[]{src="https://api.archbee.com/api/optimize/G1NTw6yAi4RDUYbsU8csp/LOwjBJGaGiBz7ZH256Ymz_image.png" size="60" width="1143" height="787" position="center" showCaption="false"}

## Conclusão

O conector Pagar.me oferece uma integração robusta para automação de operações financeiras dentro da plataforma Fluid. Ao combinar módulos financeiros e de pagamento, permite gerenciar com precisão recebíveis, pedidos e cobranças, com total controle dos dados trafegados entre os sistemas.