API REST
Uma chamada cria a cobrança e devolve o que o cliente precisa ver.
- Formato
- JSON sobre HTTPS
- Idempotência
- clientReference
- Documentação
- docs.payzu.com.br
Duas APIs, webhooks e sandboxConecte seu sistema.
Conecte seu sistema.
Mova dinheiro em tempo real.
Conta e Pix em uma API, cartões em outra. Webhooks assinados, sandbox aberto e SDKs oficiais nas duas.
Pix, QR Code e Copia e Cola
Receba por Pix direto do seu sistema.
Crie a cobrança pela API e receba na resposta o QR Code e o Copia e Cola, prontos para mostrar ao seu cliente.
- Valores em reais, sem conversão para centavos
- QR Code dinâmico em cada cobrança
- Expiração configurável por cobrança
- Referência própria para conciliar sem duplicidade
SDKs e ferramentas para começar mais rápido
- Node.js
- Python
- Go
- PHP
- OpenAPI
- Postman
Cada produto,
uma API.
São duas integrações independentes, cada uma com a sua base, a sua autenticação e o seu formato de valores. Você integra só a que precisa.
Conta e PixConta, cobranças, envios e avisos na mesma base.
- Base
- api.payzu.processamento.com/v1
- Autenticação
- Token Bearer
- Valores
- Em reais
- CobrançasPOST /pix
- EnviosPOST /withdraw
- Chaves e QR CodeGET /pix/key
- DevoluçõesPOST /refund/{id}
- Extrato e relatóriosGET /user/transactions
- AvisosPOST /user/webhooks
CartõesCobrança no crédito, da autorização ao estorno.
- Base
- api.payzu.io/v1
- Autenticação
- mTLS e token Bearer
- Valores
- Em centavos
- Token da sessãoPOST /token
- CobrançasPOST /charges
- ConsultaGET /charges/{id}
- EstornoPUT /charges/{id}/reverse
- RecorrênciaPUT /charges/recurrences/{id}
- CâmbioGET /currency/rate
Webhooks
Avisos no instante em que o pagamento cai.
- Envio
- Por evento
- Conciliação
- Automática
- Extrato
- PDF, CSV e OFX
Sandbox
Teste tudo antes de ir para produção.
- Valores
- Sem dinheiro real
- Homologação
- Acompanhada
- Status
- status.payzu.com.br
criar-cobranca.mjs
const url = "https://api.payzu.processamento.com/v1/pix"; const response = await fetch(url, { method: "POST", headers: { Authorization: `Bearer ${process.env.PAYZU_TOKEN}`, "Content-Type": "application/json", }, body: JSON.stringify({ amount: 480.0, clientReference: "pedido-4821", expiresIn: 600, callbackUrl: "https://seu-sistema.com/webhooks", }),}); const { id, status, qrCodeText } = await response.json();Simples de integrar.
Pronta para crescer.
Uma requisição cria a cobrança e devolve o QR Code.
Ver a referência completaDocumentação pronta para IA
O seu assistente lê a doc
e escreve a integração.
Conecte o servidor MCP oficial ao Claude, ao ChatGPT ou ao Cursor e ele consulta a referência, gera o código e cria cobranças direto na conversa. A mesma documentação também sai em Markdown, OpenAPI e coleção Postman.
Conectar o seu assistente