Iugu - pagamentos.dev

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.

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.

pagamentos.ts

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'
    })
  ]
})

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.

Veja também clientes, checkout e webhooks.