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

# Iugu

> Integre cobranças, clientes e checkout da Iugu

## Sobre a Iugu

A Iugu oferece automação de cobrança e infraestrutura financeira para negócios
digitais. A integração cobre clientes, faturas, checkout hospedado, cartão
tokenizado e webhooks.

Consulte a [documentação oficial da Iugu](https://dev.iugu.com/).

## Métodos e recursos

* `pix` — fatura com QR Code
* `boleto` — fatura com linha digitável
* `cartaoCredito` — cobrança com token
* Clientes, cobranças, checkout e webhooks

## Credenciais e modo de teste

O `apiToken` identifica a conta e o ambiente. Use o token de teste durante o
desenvolvimento e nunca envie esse valor para o navegador.

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

export const pg = new Pagamentos({
  providers: [
    iugu({
      apiToken: process.env.IUGU_API_TOKEN!,
      signingSecret: process.env.IUGU_WEBHOOK_SECRET,
      notificationUrl: 'https://example.com/webhooks/iugu',
      returnUrl: 'https://example.com/pagamento/concluido'
    })
  ]
})
```

<Note>
  Para cartão, tokenize os dados com o fluxo aprovado pela Iugu e envie apenas
  o token. Não exponha o `apiToken` nem manipule dados brutos de cartão no
  backend da aplicação.
</Note>

Veja também [clientes](/features/clientes), [checkout](/features/checkout) e
[webhooks](/features/webhooks).