19 de novembro de 2026

PagBank tem API? O que dá para integrar hoje e o que exige homologação

Veja as APIs do PagBank (Pedidos, Pix, Checkout, Link e Recorrência), como funcionam sandbox e homologação e quando uma API Pix basta.

Sim, o PagBank tem API, e ela é ampla. Segundo a documentação oficial (consultada em 19/11/2026), há APIs de Pedidos, Pix, Checkout e Link de Pagamento, Pagamentos Recorrentes, Cadastro, Connect, Notificação e Chargeback, com sandbox e uma etapa de homologação antes da produção. Comparando com a Getnet? Veja o que a API da Getnet faz.

Este guia mostra o mapa das APIs do PagBank, o caminho do sandbox até a produção e quando uma API Pix mais enxuta resolve. A comparação comercial lado a lado está em AbacatePay vs PagBank.


PagBank tem API? A resposta curta

Tem, com APIs para quase todas as etapas do pagamento online.


Mapa das APIs do PagBank

Cada API do PagBank cobre uma parte do pagamento, e dá para usar uma sozinha ou várias juntas. Pela documentação das APIs (19/11/2026):

API Para que serve Quem usa
Pedidos e pagamentos (Order) Criar pedidos e cobrar com cartão de crédito, débito, boleto ou Pix Loja ou sistema com checkout próprio
Checkout e Link de Pagamento Mandar o cliente para uma página de pagamento do PagBank Quem quer checkout pronto ou vender por link
Pagamentos Recorrentes Cobrar assinaturas a partir de planos SaaS, clubes e serviços com mensalidade
Cadastro Criar contas PagBank em nome de terceiros Parceiros e plataformas
Connect Conectar a sua aplicação a contas de outros usuários PagBank para agir em nome deles Plataformas e marketplaces
Notificação Receber eventos por webhook e configurar as preferências de aviso Quem precisa reagir a mudanças de status
Chargeback Consultar, acompanhar e contestar disputas Lojas que vendem com cartão

Entre as funcionalidades listadas estão autorizar o pagamento com captura posterior, cancelar e estornar, salvar o cartão para cobranças futuras, indicar pagamentos recorrentes e dividir pagamentos.


Checkout hospedado ou checkout transparente no PagBank?

No Checkout do PagBank o cliente paga numa página do PagBank; no checkout transparente você usa a API de Pedidos e as chaves públicas para criptografar o cartão no seu site. A documentação do Checkout (19/11/2026) lista como meios cartão de crédito, cartão de débito, Pix, boleto, Pagar com PagBank, Apple Pay e Google Pay.

Um detalhe do checkout hospedado: você escolhe quais meios ficam disponíveis, mas, segundo a documentação, “a opção de Pagar com PagBank sempre ficará disponível no checkout, independente da configuração”.

Para entender as duas formas de cobrar, veja link de pagamento ou checkout transparente. Na AbacatePay, o checkout hospedado e o link de pagamento seguem a mesma ideia de página pronta.


Sandbox, homologação e produção

Você desenvolve no sandbox, pede a homologação para validar os testes e só depois recebe acesso à produção. Nas palavras da documentação: “O processo de homologação é realizado para validar os testes feitos no ambiente sandbox. Após a homologação, você terá acesso ao ambiente de produção.”

Os endereços, segundo a página de ambientes disponíveis (19/11/2026):

Ambiente URL base URL base das APIs de Transferência e Pix Bacen
Sandbox https://sandbox.api.pagseguro.com/ https://secure.sandbox.api.pagseguro.com
Produção https://api.pagseguro.com https://secure.api.pagseguro.com

As APIs de Transferência e Pix Bacen usam um host separado. O menu da documentação também tem uma seção de certificado digital (mTLS), que o PagBank descreve como um fator adicional de segurança na integração.

Fale com o time e teste a API Pix no seu sistema.


Webhooks e conciliação no PagBank

O PagBank avisa mudanças de status por webhooks e tem preferências de notificação para eventos como cobranças, cancelamentos e chargebacks. Na prática, o seu sistema recebe o aviso, confere o status do pedido e só então libera a venda e lança o pagamento na conciliação.

Para entender o conceito, leia o que é webhook de pagamento. Os eventos da AbacatePay estão em webhooks da API.


Recorrência pela API do PagBank

Dá para cobrar assinatura pela API de Pagamentos Recorrentes ou pelo Checkout e Link de Pagamento Recorrente. Na API, você cria planos e assinantes; no checkout recorrente, a primeira cobrança acontece na conclusão do pagamento e uma assinatura é criada para as próximas, segundo a documentação (19/11/2026).

Para cobrar mensalidades na AbacatePay, veja assinaturas.


Quando faz sentido outra API

Se o que você precisa é cobrar Pix com QR Code na sua tela e testar sem etapa de homologação, uma API Pix mais enxuta resolve. Na AbacatePay, a API Pix cria a cobrança e devolve o brCode (o Copia e Cola) e a imagem do QR Code na resposta, conforme a documentação da API.

O Modo Teste funciona assim:

O Pix custa R$ 0,80 por cobrança paga. Veja o passo a passo em como testar pagamentos no sandbox e a documentação para desenvolvedores.


PagBank, Getnet ou AbacatePay para integrar via API?

A escolha depende do caminho até a produção e de onde o pagamento acontece. Resumo pela documentação oficial de cada um (19/11/2026); a Getnet está detalhada em Getnet tem API?.

Ponto PagBank Getnet AbacatePay
Autenticação Token de autenticação da conta OAuth 2.0 (client_id e client_secret) Chave de API
Ambiente de testes documentado Sandbox Não detalhado na doc pública lida Modo Teste
Etapa antes da produção Homologação Confirme com a Getnet Verificação da conta
Checkout hospedado Sim Web Checkout (iFrame, lightbox ou redirect) Sim
Pix pela API Na API de Pedidos No link e no checkout Sim, com o QR Code devolvido pela API
Recorrência Pagamentos Recorrentes e Checkout Recorrente Confira na documentação da Getnet Assinaturas

Outras comparações: PagBank ou Mercado Pago, PagBank ou InfinitePay e as APIs de pagamento no Brasil.


Perguntas frequentes

O PagBank tem API Pix?

Sim. A documentação lista o Pix entre os meios da API de Pedidos e do Checkout, e há APIs de Transferência e Pix Bacen, com URL base própria (19/11/2026).

Como funciona o sandbox do PagBank? Precisa de homologação?

Você integra no sandbox (https://sandbox.api.pagseguro.com/), pede a homologação para validar os testes e, depois dela, recebe acesso à produção (https://api.pagseguro.com). A documentação não informa o prazo da homologação.

A API do PagSeguro e a do PagBank são a mesma coisa?

Na prática, sim: a documentação do PagBank fica em developer.pagbank.com.br e as URLs base das APIs continuam nos hosts api.pagseguro.com, no sandbox e na produção.

O PagBank tem checkout transparente?

Sim. A documentação diz que as chaves públicas servem para acessar o checkout transparente, em que você usa a API de Pedidos e o cartão é criptografado no seu site.

Dá para fazer assinatura pela API do PagBank?

Sim, pela API de Pagamentos Recorrentes, com planos e assinantes, ou pelo Checkout e Link de Pagamento Recorrente.

Por que “Pagar com PagBank” aparece sempre no checkout?

Porque é uma regra do checkout hospedado: a documentação diz que essa opção “sempre ficará disponível no checkout, independente da configuração”, mesmo que você desligue outros meios.


Checklist de decisão

  1. Defina onde o pagamento acontece: página do PagBank, checkout no seu site ou Pix na sua própria tela.
  2. Planeje o caminho até a produção: sandbox e homologação no PagBank, Modo Teste e verificação da conta na AbacatePay.
  3. Valide como o pagamento é confirmado: webhook, consulta de status ou os dois.
  4. Compare o custo no seu ticket: simular taxas.

Fale com o time e teste a API Pix no seu sistema.

Leia também: Getnet tem API? · InfinitePay tem API? · AbacatePay vs PagBank · alternativas ao PagBank · PagBank ou Mercado Pago · PagBank ou InfinitePay

Você pode se interessar por