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

# Asaas

> Integre Pix, boleto, clientes e checkout do Asaas

## Sobre o Asaas

O Asaas é uma conta digital para empresas com APIs de cobrança e automação
financeira. A integração do **pagamentos.dev** cobre clientes, cobranças,
checkout hospedado e webhooks.

Consulte a [documentação oficial do Asaas](https://docs.asaas.com/).

## Métodos e recursos

* `pix` — cobrança com QR Code
* `boleto` — cobrança com linha digitável
* Clientes — criar, consultar, atualizar, listar e excluir
* Cobranças — criar, consultar, atualizar, listar e cancelar
* Checkout e webhooks autenticados

## Credenciais e sandbox

Crie uma chave no ambiente correspondente. Chaves de homologação começam com
`$aact_hmlg_`; chaves de produção começam com `$aact_prod_`. O SDK impede a
mistura acidental entre a chave e o ambiente.

## Configuração

```ts pagamentos.ts theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
import { Pagamentos, asaas } from 'pagamentos'

export const pg = new Pagamentos({
  providers: [
    asaas({
      apiKey: process.env.ASAAS_API_KEY!,
      mode: 'sandbox',
      userAgent: 'minha-aplicacao/1.0',
      signingSecret: process.env.ASAAS_WEBHOOK_TOKEN
    })
  ]
})
```

O `signingSecret` é o `authToken` de 32 a 255 caracteres configurado no webhook
do Asaas. Use o mesmo valor no painel e no servidor.

<Note>
  Cartão e parcelamento continuam acessíveis pelo cliente versionado `Asaas`
  quando o fluxo exige campos específicos que não cabem na interface comum.
</Note>

Veja também [clientes](/features/clientes), [cobranças](/features/cobrancas) e
[webhooks](/features/webhooks).