> ## 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 una pasarela de pago

> Cree la integración Notfy Financiero con Asaas o Ailos, indique las credenciales, elija sandbox o producción y configure el aviso automático de pago.

Para emitir cobros necesita una integración **Notfy Financiero** vinculada a su cuenta en Asaas o en Ailos.

## Cuándo usar

La primera vez que vaya a cobrar a clientes, o cuando quiera cobrar por otra cuenta (por ejemplo, una cuenta por empresa emisora).

## Antes de comenzar

* El plan de la empresa debe incluir el módulo financiero. El número de cuentas de pasarela que puede activar también depende del plan.
* Tenga a mano las credenciales de su cuenta en la pasarela.
* Necesita permiso para gestionar integraciones.

## Pasarelas disponibles

| Pasarela | Cómo se autentica | Aviso automático de pago |
| :- | :- | :- |
| **Asaas** | Clave de API y token de webhook | Sí |
| **Ailos** | Credenciales de la cooperativa (Client ID, Client Secret, URL del token, convenio) | No: actualice el estado manualmente |

> [!WARNING]
>
> La pasarela **no se puede cambiar** después de crear la integración. Para cambiar de pasarela, cree otra integración.

## Crear la integración

**1. Abra las integraciones**

Acceda a **Ajustes → Integraciones** y haga clic para crear una nueva integración.

**2. Elija el servicio**

En el campo de servicio, seleccione **Notfy Financiero**. En **Pasarela de Pago**, elija Asaas o Ailos.

**3. Póngale un nombre y guarde**

Complete **Nombre de la integración** (por ejemplo, "Asaas casa matriz") y guarde. Solo después de guardar aparece la pestaña **Notfy Financiero**, donde van las credenciales.

**4. Indique las credenciales**

En la pestaña **Notfy Financiero**, sección **Pasarela de Pago**, complete los campos de su pasarela. Los datos se guardan cifrados.

**5. Elija el entorno**

En la sección **Entorno**, elija **Sandbox — pruebas** o **Producción**. Use el sandbox para probar sin mover dinero y cambie a Producción solo cuando vaya a cobrar de verdad.

**6. Configure el aviso de pago (Asaas)**

En la sección **Webhook**, copie la **URL de webhook** y regístrela en las notificaciones de su cuenta Asaas, usando el mismo **Token de webhook** que indicó en Notfy.

## Campos por pasarela

> [tab] Asaas
>
> | Campo | Qué indicar |
> | :- | :- |
> | **Clave de API** | Clave de su cuenta Asaas (obligatoria). |
> | **Token de webhook** | Token que usted define en las notificaciones de Asaas, para validar los avisos recibidos. |

> [tab] Ailos
>
> | Campo | Qué indicar |
> | :- | :- |
> | **Client ID** y **Client Secret** | Credenciales OAuth2 proporcionadas por la cooperativa. |
> | **URL del token** | Dirección de emisión del token, informada por la cooperativa. |
> | **Convenio de cobranza** | Número del convenio, solicitado a la cooperativa. |
> | **Cartera** | Cartera de cobranza (estándar 1). |
> | **URL base de la API** | Obligatoria en producción; en el sandbox, puede quedar en blanco. |

## Empresa emisora vinculada

Si su empresa tiene más de una cuenta y también usa la integración fiscal, el campo opcional **Empresa emisora vinculada** enlaza la cuenta financiera con el CNPJ que emite las notas. Al dividir el cobro de una venta por empresa, cada parte sale por la cuenta vinculada.

## Preguntas frecuentes

> [accordion] ¿Aparece Stripe en la lista?
>
> No. Actualmente la lista de pasarelas ofrece solo Asaas y Ailos.

> [accordion] El cobro fue pagado, pero el estado no cambió. ¿Y ahora?
>
> Con Asaas, el estado cambia solo cuando el aviso de pago está configurado. Si no cambió, verifique el registro de la URL y del token en Asaas y use **Actualizar Estado** en el cobro. Con Ailos no hay aviso automático: use **Actualizar Estado** siempre que lo necesite.

> [accordion] ¿Puedo tener dos cuentas de la misma pasarela?
>
> Sí, dentro del límite de cuentas de su plan. Al generar cobros usted elige qué **Cuenta financiera** usar.

## Páginas relacionadas

> [card] [Ventas y cobros](https://docs.notfy.ai/es/financeiro/vendas-e-cobrancas.md)
>
> Emita cobros usando la cuenta conectada.

> [card] [Dar seguimiento a los cobros](https://docs.notfy.ai/es/financeiro/acompanhar-cobrancas.md)
>
> Estado, actualización manual y cancelación.


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