Conectar um gateway de pagamento

Crie a integração Notfy Financeiro com Asaas ou Ailos, informe as credenciais, escolha sandbox ou produção e configure o aviso automático de pagamento.

Para emitir cobranças você precisa de uma integração Notfy Financeiro ligada à sua conta no Asaas ou no Ailos.

​

Quando usar

Na primeira vez que for cobrar clientes, ou quando quiser cobrar por outra conta (por exemplo, uma conta por empresa emissora).

​

Antes de começar

• O plano da empresa deve incluir o módulo financeiro. O número de contas de gateway que você pode ativar também depende do plano.
• Tenha em mãos as credenciais da sua conta no gateway.
• Você precisa de permissão para gerenciar integrações.

​

Gateways disponíveis

Gateway	Como se autentica	Aviso automático de pagamento
Asaas	Chave de API e token de webhook	Sim
Ailos	Credenciais da cooperativa (Client ID, Client Secret, URL do token, convênio)	Não: atualize o status manualmente

O gateway não pode ser alterado depois que a integração é criada. Para trocar de gateway, crie outra integração.

​

Criar a integração

1. Abra as integrações

   Acesse Ajustes → Integrações e clique para criar uma nova integração.

2. Escolha o serviço

   No campo de serviço, selecione Notfy Financeiro. Em Gateway de Pagamento, escolha Asaas ou Ailos.

3. Dê um nome e salve

   Preencha Nome da integração (por exemplo, “Asaas matriz”) e salve. Só depois de salvar aparece a aba Notfy Financeiro, onde ficam as credenciais.

4. Informe as credenciais

   Na aba Notfy Financeiro, seção Gateway de Pagamento, preencha os campos do seu gateway. Os dados são guardados de forma criptografada.

5. Escolha o ambiente

   Na seção Ambiente, escolha Sandbox — testes ou Produção. Use o sandbox para testar sem movimentar dinheiro e troque para Produção só quando for cobrar de verdade.

6. Configure o aviso de pagamento (Asaas)

   Na seção Webhook, copie a URL de Webhook e cadastre-a nas notificações da sua conta Asaas, usando o mesmo Token de Webhook que você informou no Notfy.

​

Campos por gateway

Asaas

Campo	O que informar
Chave de API	Chave da sua conta Asaas (obrigatória).
Token de Webhook	Token que você define nas notificações do Asaas, para validar os avisos recebidos.

Ailos

Campo	O que informar
Client ID e Client Secret	Credenciais OAuth2 fornecidas pela cooperativa.
URL do token	Endereço de emissão do token, informado pela cooperativa.
Convênio de cobrança	Número do convênio, solicitado à cooperativa.
Carteira	Carteira de cobrança (padrão 1).
URL base da API	Obrigatória em produção; no sandbox, pode ficar em branco.

​

Empresa emissora vinculada

Se a sua empresa tem mais de uma conta e também usa a integração fiscal, o campo opcional Empresa emissora vinculada liga a conta financeira ao CNPJ que emite as notas. Ao dividir a cobrança de uma venda por empresa, cada parte sai pela conta vinculada.

​

Perguntas frequentes

O Stripe aparece na lista?

Não. Hoje a lista de gateways oferece apenas Asaas e Ailos.

A cobrança foi paga, mas o status não mudou. E agora?

Com o Asaas, o status muda sozinho quando o aviso de pagamento está configurado. Se não mudou, confira o cadastro da URL e do token no Asaas e use Atualizar Status na cobrança. Com o Ailos não há aviso automático: use Atualizar Status sempre que precisar.

Posso ter duas contas do mesmo gateway?

Sim, dentro do limite de contas do seu plano. Ao gerar cobranças você escolhe qual Conta financeira usar.

​

Páginas relacionadas

Vendas e cobranças

Emita cobranças usando a conta conectada.

Acompanhar cobranças

Status, atualização manual e cancelamento.