Pagar.me
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.
Criando um fluxo
- Acesse a seção Fluxos na plataforma Fluid.
- Clique em Criar novo fluxo.
- Adicione uma ou mais conexões Pagar.me.
- No canvas, arraste o conector Pagar.me.
- Configure o módulo, recurso e operação conforme descrito abaixo.
Criando conexão
- Acesse Conexões no menu lateral da Fluid.
- Clique em Nova Conexão.
- Selecione Pagar.me como tipo de conexão.
- 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.
- Clique em Testar conexão.
- Se estiver tudo certo, clique em Salvar conexão.
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
- Selecione o conector Pagar.me no canvas do fluxo.
- Acesse a aba Parametrizações.
- Escolha um módulo:
- Financeiro
- Pagamentos
- Escolha um recurso:
- Financeiro
- Recebível
- Operações de saldo
- Pagamentos
- Pedidos
- Item do pedido
- Cobranças
- 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.
Corpo da requisição: Todas as operações exigem um corpo JSON conforme especificado na documentação da API Pagar.me.
- 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.
- Passo 'lista-recebiveis'
Assim ficará a Parametrização do nosso primeiro e único passo:
Na aba Propriedades informamos o nome do passo e a conexão criada para o Pagar.me:
Disparando o fluxo
- Clique em Salvar.
- Execute o fluxo.
- Visualize o resultado em tempo real no canvas.
- Clique em Detalhes para acessar a requisição e resposta.
5. Ao clicar em detalhes, temos a requisição e a resposta retornada pela Pagar.me:
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.