Skip to main content
A PlugToPay é uma camada de orquestração de pagamentos que roteia transações entre múltiplos gateways (Pagarme, Safe2Pay, Asaas, PagBank e outros) com fallback automático, cofre de cartões agnóstico e entrega de webhooks com retenção.

​
Para quem é esta documentação

Esta referência é voltada para desenvolvedores que integram diretamente com a API da PlugToPay via X-API-Key. Para o painel de gestão acesse plugtopay.com/login.

​
Base URLs

Todos os exemplos nesta documentação usam a URL de sandbox diretamente. O BFF é exclusivo para o painel administrativo e não deve ser usado em integrações externas.

​
Esquemas de autenticação

A API expõe três esquemas distintos:

​
Próximos passos

  • Autenticação — obtenha e gerencie suas credenciais.
  • Pagamentos — crie transações com cartão ou PIX.
  • Checkout — sessão de checkout unificada com cartões salvos.
  • Links de pagamento — cobre por uma URL compartilhável, sem escrever frontend.
  • Assinaturas — planos recorrentes, ciclos e cupons.
  • Idempotência — processe pagamentos com segurança em redes instáveis.
  • Webhooks — receba notificações de eventos em tempo real.
  • Orquestração — roteamento inteligente entre gateways.
  • Status — interprete os estados de cada transação.
  • Gateways — gateways suportados e lógica de roteamento.