# Asaas

**1º Chave API**

Para gerar uma chave API, é necessário acessar a área **"Integrações"** no site da Asaas e clicar em **Gerar chave de API.**

**2º Preenchendo os Campos na Plataforma**

Ao ir no **Admin Console > App Store > Checkouts externos** e escolher o Asaas, você deve começar preenchendo os seguintes campos:

* **Nome da Entrega** - Esse é um nome interno, de identificação do Produto;
* **Código do produto na plataforma** - Esse é o nome da Oferta criada lá no Asaas e precisa ser adicionado exatamente igual, se não, não conseguiremos encontrar;
* **Tokens de autenticação** - É o token criado no Webhook (veremos essa parte agora);

 Após isso, role a barra e adicione a chave API gerada no campo **"Chave da API"**

<div data-full-width="true"><figure><img src="/files/irT0L3Bdq2qgg2lLlDsk" alt=""><figcaption></figcaption></figure></div>

**3º Criando o Webhook**

Para que possamos saber quando uma cobrança é feita, quando é criada uma nova assinatura e etc, precisamos de receber essas informações da Asaas.

Por isso, é necessário que se siga as instruções da **Central de Ajuda deles**, na criação do Webhook, criando os seguintes eventos:

* **Eventos para cobranças** - Cobrança recebida, Cobrança estornada e Recebido chargeback
* **Evento para assinaturas** - Geração de nova assinatura, Alteração na assinatura, Assinatura inativada e Assinatura removida

Para ver o artigo, basta clicar no link: [Criar novo Webhook pela aplicação web](https://docs.asaas.com/docs/criar-novo-webhook-pela-aplicacao-web)

**4º Terminando a Configuração**

Os últimos passos são:

* Preencher o "**Tokens de autenticação**" com a informação criada na hora da configuração do Webhook;
* Selecionar o grupo correspondente a Oferta.

Pronto. A sua primeira integração foi criada!

🚨Não se esqueça de fazer **testes de compra**, para verificar se o acesso será criado na Plataforma corretamente.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://ajuda.ensinio.com/vendas/checkout-externo/asaas.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.