---
title: Payfy
slug: payfy
docTags: 
createdAt: 2026-06-15T19:50:37.218Z
---

## Objetivo/Resumo

O conector Payfy permite executar operações administrativas e financeiras na plataforma Payfy diretamente através da Fluid.

Para utilizar o conector do Payfy, é necessário [Criar Conexão](docId:1pCVN0mJbFKUjHMhj86K-) válida e, em seguida, configurar os recursos desejados no canvas.

## Criando conexão Payfy

Para [Criar Conexão](docId:1pCVN0mJbFKUjHMhj86K-) estes são os parâmetros de configuração requisitados:

- **Ambiente**: Ambiente no qual será feita a integração. 
- **Tipo de Conexão:** Tipo da conexão a ser realizada, há dois tipos possíveis.
  - A conexão do tipo **Basic** pede o Usuário e a Senha de integração.
  - A conexão do tipo **API Key** pede apenas a chave.

## Criando um fluxo com o conector Payfy

[Crie um fluxo](https://docs.fluidapi.io/criar-fluxo) e arraste o conector Payfy para o canvas. Selecione o conector e na aba de `Parametrização` preencha os seguintes parâmetros de configuração:

- **Recurso**: Entidade para qual será realizada a ação. 
- **Operação**: Ação específica que será realizada para o recurso selecionado.

### Operações disponíveis por Recurso:

- **Dispositivos:**
  -  Criar Dispositivo
  - Listar Dispositivos
  - Buscar detalhes do Dispositivo
  - Atualizar status do Dispositivo
  - Remover Dispositivo
- **Cartões:**
  - Criar Cartão
  - Consultar Cartões
  - Bloquear Cartão
  - Recarregar Cartão
  - Desbloquear Cartão
  - Resetar senha do Cartão
  - Descarregar Cartão
  - Vincular Cartão ao Usuário
- **• Categorias:**
  - Listar Categorias
  - Criar Categorias
  - Deletar Categoria
  - Ativar Categoria
  - Desativar Categoria
- **Empresas**:
  - Buscar Saldo da Empresa
  - Projetos
  - Relatórios
  - Buscar Relatório pelo ID
- **• Centro de Custo:**
  - Listar Centros de Custo
  - Criar Centro de Custo
  - Buscar Informações de um Centro de Custo
  - Atualizar Informações do Centro de Custo
  - Desativar ou Deletar um Centro de Custo
- **• Grupos:**
  - Listar Grupos
  - Criar Grupo
  - Buscar Informações de um Grupo
  - Atualizar Informações de um Grupo
  - Desativar ou Deletar um Grupo
- **• Perfis de Permissões:**
  - Listar Perfis de Permissão
  - Criar Perfil de Permissões
- **• Comprovantes de Despesas:**
  - Adicionar Comprovante a Transação
  - Buscar Url do Comprovante da Despesa
  - Aprovar Comprovantes em Lote
  - Reprovar Comprovantes em Lote
- **• Redefinir Senha:**
  - Solicitar Redefinição de Senha
- **• Controles de Gastos de Reembolso:**
  - Listar Controles de Gastos de Reembolso
  - Criar Controle de Gastos de Reembolso
  - Atualizar Controle de Gastos de Reembolso
  - Deletar Controle de Gastos de Reembolso
- **• Informações de Campos Obrigatórios:**
  - Listar Campos Obrigatórios nas Transações
  - Atualizar Campo Obrigatório
- **• Solicitações:**
  - Listar Solicitações
  - Criar Solicitações
  - Aprovar Solicitações em Lote
  - Buscar previsões de locais
  - Buscar detalhes do local pelo ID
  - Gerar um recibo de reembolso de KM
  - Buscar a URL de um anexo de reembolso
  - Aprovar Solicitação
  - Cancelar Solicitação
  - Recusar Solicitação
- **• Rotas Paginadas:**
  - Listar Cartões
  - Listar Usuários
  - Listar Transações
- **• Transações:**
  - Listar Transações
  - Consultar Detalhes da Transação
  - Atualizar Transação
  - Rejeitar Transação
- **• Redefinir Webhooks:**
  - Retornar Status da Integração

## Na prática

Neste tópico criaremos um exemplo de fluxo utilizando o conector do Payfy.

### Consultar Empresa

O fluxo terá apenas um passo que será responsável pela consulta dos dados da empresa que o usuário que fez a solicitação pertence dentro da Payfy.

::Image[]{size="40" isUploading="false" position="center" darkSrc="https://archbee-image-uploads.s3.amazonaws.com/G1NTw6yAi4RDUYbsU8csp/lDgMnwx3FuaUpBlUhM-uK-20260615-203542.png" darkWidth="303" darkHeight="186" showCaption="false"}

### Passo 'consultar-empresa'

Este primeiro e único passo irá consultar os dados da empresa. Assim ficará a Parametrização do passo consultar-empresa:

::Image[]{size="50" isUploading="false" position="center" darkSrc="https://archbee-image-uploads.s3.amazonaws.com/G1NTw6yAi4RDUYbsU8csp/4EY96Q_bk6s0JPT1wIcZf-20260615-203542.png" darkWidth="328" darkHeight="336" showCaption="false"}

## Conclusão

Com o passo configurado basta disparar o fluxo:

::Image[]{src="https://api.archbee.com/api/optimize/G1NTw6yAi4RDUYbsU8csp/tW9AdBisNKpHMi1vXwgeJ_.blob" size="40" width="525" height="404" isUploading="false" position="center" darkSrc="https://archbee-image-uploads.s3.amazonaws.com/G1NTw6yAi4RDUYbsU8csp/MhNQw821jByIxt-m1J_l9-20260615-203542.png" darkWidth="331" darkHeight="222" showCaption="false"}

Após o disparo, o resultado do fluxo aparecerá em realtime no canvas:

::Image[]{size="90" isUploading="false" position="center" darkSrc="https://archbee-image-uploads.s3.amazonaws.com/G1NTw6yAi4RDUYbsU8csp/0nu2aUAQmatM5wLmyFWhQ-20260615-203541.png" darkWidth="591" darkHeight="304" showCaption="false"}

Ao clicar em detalhes, temos a requisição e a resposta retornada pelo conector:

::Image[]{size="90" isUploading="false" position="center" darkSrc="https://archbee-image-uploads.s3.amazonaws.com/G1NTw6yAi4RDUYbsU8csp/MzTjEQ7abGYitWbw6UJ_X_payfy-5.png" darkWidth="599" darkHeight="360" showCaption="false"}