API RESTful Pronta para Produção

A infraestrutura de Pix definitiva para o seu SaaS.

Uma única chave de API para cobrar por Pix (QR Code e Copia e Cola) e Cartão (Checkout Pro). Conciliação anti-fraude em tempo real, sem OAuth e sem polling.

Começar a Integrar Ler a Documentação

criar-pix.sh

curl -X POST https://<seu-projeto>.supabase.co/functions/v1/create-pix \
  -H "Authorization: Bearer ppx_sua_chave_aqui" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": 99.90,
    "description": "Assinatura Mensal",
    "payment_type": "pix",
    "email": "cliente@email.com"
  }'

Construído sobre uma base sólida e segura

Pix · QR e Copia e Cola

Checkout Pro · Cartão

Conciliação anti-fraude

API REST + Webhooks

Realtime via WebSocket

Projetado para Desenvolvedores

Tudo que você precisa para cobrar por Pix e Cartão sem lidar com OAuth, renovação de token ou PCI Compliance.

Pix Transparente

Gere o QR Code e o código Copia e Cola em uma chamada e mostre direto no seu front-end. O pagamento cai na hora na sua conta.

Checkout Pro (Cartão)

Gere um link de pagamento seguro e redirecione seu cliente. Seu servidor nunca toca em dados de cartão — PCI fica por conta do provedor.

Conciliação Anti-Fraude

Ao receber a notificação, o PagPix consulta o pagamento direto na fonte antes de aprovar. Não confiamos no payload bruto do webhook.

Tempo Real, sem Polling

Receba a mudança de status via WebSocket (Supabase Realtime) e libere o acesso ao produto no instante em que o pagamento é aprovado.

Uma Chave, Sem OAuth

Gere uma chave estática ppx_... no painel e use em todas as chamadas. Sem renovação de token, sem fluxo OAuth.

Painel de Controle

Acompanhe transações, gere cobranças, gerencie chaves de API e leia a documentação — tudo em um dashboard simples e direto.

Como Funciona

Três passos simples para colocar seu sistema no ar recebendo Pix hoje mesmo.

Gere sua Chave

Crie sua conta e gere uma chave de API ppx_... no painel. É ela que autentica todas as suas chamadas.

Crie a Cobrança

Chame POST /create-pix e receba o QR Code, o Copia e Cola ou o link de Checkout Pro para exibir ao cliente.

Receba em Tempo Real

Assim que o cliente paga, o status vira approved e o seu sistema é avisado na hora via WebSocket.

Uma resposta, tudo o que você precisa

A chamada retorna QR Code, Copia e Cola e referências em JSON limpo. O status é conciliado automaticamente.

200 OK · response.json

{
  "id": "e30f14fa-...-ef0123456789",
  "status": "pending",
  "amount": 99.90,
  "payment_type": "pix",
  "qr_code": "00020101021126930014br.gov.bcb.pix...",
  "qr_code_base64": "iVBORw0KGgoAAAANSUhEUgAA...",
  "external_reference": "8a7d3b-uuid-interno",
  "created_at": "2026-06-01T20:00:00.000Z"
}

Estados de uma transação

pending Cobrança criada, aguardando pagamento.

approved Pagamento confirmado. Libere o acesso ao produto.

rejected Pagamento recusado pelo processador.

cancelled Cobrança expirada ou cancelada.

Ver a documentação completa

Por dentro do produto

Conheça a plataforma por dentro

Telas reais do PagPix. Do primeiro acesso à referência técnica que seu time de desenvolvimento vai usar no dia a dia.

Acesso seguro

Plataforma multi-tenant, dados isolados

Cada empresa entra no seu próprio painel e enxerga apenas os próprios dados. O isolamento é garantido no banco por Row Level Security — não é uma regra de front-end que dá para burlar.

Login e recuperação de senha integrados ao Supabase Auth.
Perfis de plataforma (superadmin) e cliente (tenant).

Painel de gestão

Suas vendas em um só lugar

Volume de vendas, transações aprovadas e um guia de primeiros passos que acompanha o seu progresso. O painel é agregado no servidor — rápido mesmo com muitos registros.

Indicadores dos últimos 7 dias.
Onboarding que reflete o estado real da conta.

Sem código

Cobre por Pix em segundos, sem integrar nada

Precisa cobrar antes de terminar a integração? Preencha valor e descrição no painel e gere a cobrança Pix na hora. Ideal para começar a receber enquanto o time de dev conecta a API.

QR Code e Copia e Cola gerados na hora.
Dados do cliente opcionais para melhorar a conciliação.

Tela de nova cobrança Pix no painel PagPix

Gestão de chaves de API no painel PagPix

Integração

Chaves de API sob seu controle

Gere e revogue chaves ppx_... quando quiser. Nomeie cada chave por ambiente ou aplicação e mantenha a rastreabilidade das suas integrações.

Uma chave estática por integração — sem OAuth.
Revogação imediata em caso de comprometimento.

Transações

Histórico completo com status e taxas

Acompanhe cada cobrança: tipo (Pix ou Cartão), valor, taxa da plataforma, status e a referência para conciliar com o seu sistema. Tudo atualizado conforme os pagamentos são confirmados.

Estados claros: pendente, aprovado, recusado, cancelado.
Referência externa para casar com o seu banco de dados.

Histórico de transações no painel PagPix

Documentação

Referência técnica pronta para o seu time

Endpoints, headers, corpo da requisição e exemplos de resposta prontos para copiar. Tudo o que o desenvolvedor precisa para integrar Pix e Cartão em minutos — incluindo o guia de conciliação em tempo real.

Abrir a documentação completa

Perguntas Frequentes

Como recebo a confirmação do pagamento?

Você não precisa fazer polling. O PagPix concilia o pagamento automaticamente e atualiza o status da transação. Você escuta essa mudança em tempo real via WebSocket (Supabase Realtime) ou consulta a transação via REST quando preferir.

Preciso lidar com PCI para aceitar cartão?

Não. No modo Checkout Pro, geramos um link seguro e o cliente paga fora do seu servidor. Dados de cartão nunca transitam pelo seu backend, então o peso do PCI Compliance fica com o provedor.

Como funciona a autenticação da API?

Você gera uma chave estática com prefixo ppx_ no painel e a envia no header Authorization: Bearer. Sem OAuth, sem renovação de token.

O webhook é confiável contra fraude?

Sim. Ao receber uma notificação, o PagPix consulta o pagamento diretamente na fonte antes de mudar o status. Não confiamos apenas no payload recebido, o que evita aprovações forjadas.