PagBank - pagamentos.dev

Sobre o PagBank

O PagBank é o ecossistema financeiro do PagSeguro. O provedor unificado usa as APIs Orders e Checkout para criar cobranças Pix, páginas de pagamento e receber notificações. Consulte a documentação oficial do PagBank.

Métodos e recursos

pix — pedido com QR Code
Consulta e cancelamento de pedidos
Checkout hospedado e webhooks

Credenciais e sandbox

Gere um token no Portal do Desenvolvedor. O SDK troca automaticamente entre os hosts de sandbox e produção conforme mode.

pagamentos.ts

import { Pagamentos, pagbank } from 'pagamentos'

export const pg = new Pagamentos({
  providers: [
    pagbank({
      token: process.env.PAGBANK_TOKEN!,
      mode: 'sandbox',
      notificationUrl: 'https://example.com/webhooks/pagbank'
    })
  ]
})

A interface comum expõe Pix porque o fluxo cabe integralmente no contrato do SDK. Boleto e cartão continuam disponíveis no cliente versionado PagBank, pois exigem endereço completo ou cartão criptografado.

Use sempre HTTPS em notificationUrl. O token também valida a autenticidade das notificações recebidas pelo handler. Veja também Pix, checkout e webhooks.