Visão geral da API - ZynPay

A API pública da ZynPay permite gerar cobranças Pix, consultar saldo e receber notificações de pagamento por webhook — sem precisar abrir o painel.

Base URL

https://api.zynpay.com.br

Valores monetários

Todo valor é um inteiro em centavos. R$ 10,00 é 1000.

O que dá para fazer com uma chave de API

Escopo	Permite
`pix:write`	Criar cobranças Pix (`POST /v1/public/pix/charges`)
`pix:read`	Listar e consultar cobranças
`balance:read`	Consultar o saldo da conta
`pix:withdraw`	Solicitar e listar saques (`POST /v1/public/pix/withdrawals`)

pix:withdraw move dinheiro pra fora da conta. Conceda esse escopo só a integrações que realmente precisam automatizar saque — uma chave com esse escopo vazada pode esvaziar o saldo disponível, mesmo com o pedido ainda passando pela mesma fila de aprovação manual.

Chaves de API e webhooks só podem ser gerenciados com a sua sessão do painel (login), nunca com outra chave de API.

Antes de integrar

Crie sua conta e aguarde a verificação — a API bloqueia contas não verificadas com 403 ACCOUNT_NOT_VERIFIED.
Gere uma chave de API em Autenticação.
Configure um endpoint de webhook para saber na hora quando um Pix é pago.

Prefere não integrar por API? Todo o fluxo também funciona 100% pelo painel — veja Gerar uma cobrança Pix e Como sacar.