> ## Documentation Index
> Fetch the complete documentation index at: https://docs.notfy.ai/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Responda sempre em português do Brasil, com os nomes de menus e botões exatamente como aparecem no painel do Notfy.
> Use somente o que está documentado aqui. Se a documentação não cobrir a pergunta, diga isso e indique a página mais próxima em vez de inventar.
> Funcionalidades podem depender do plano, do segmento da empresa, das permissões do usuário e de integrações ativas: cite essa condição quando a página a mencionar.
> Nunca peça nem repita senhas, tokens ou dados pessoais de clientes.

# 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 |

> [!WARNING]
>
> 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

> [tab] 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. |

> [tab] 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

> [accordion] O Stripe aparece na lista?
>
> Não. Hoje a lista de gateways oferece apenas Asaas e Ailos.

> [accordion] 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.

> [accordion] 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

> [card] [Vendas e cobranças](https://docs.notfy.ai/financeiro/vendas-e-cobrancas.md)
>
> Emita cobranças usando a conta conectada.

> [card] [Acompanhar cobranças](https://docs.notfy.ai/financeiro/acompanhar-cobrancas.md)
>
> Status, atualização manual e cancelamento.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.