Documentação da API

Gere cobranças PIX da VERON PAY direto do seu sistema. Todas as respostas são em JSON.

Autenticação Criar cobrança Consultar cobrança Listar cobranças Saldo Webhooks Erros

Autenticação

Crie uma chave em Integração API e envie em todas as requisições:

Authorization: Bearer vp_live_SUA_CHAVE
Content-Type: application/json

Endpoint base:

https://veronpay.online/api/public/v1

Nunca exponha sua chave no navegador ou app — use apenas no seu servidor.

Criar cobrança PIX

POST https://veronpay.online/api/public/v1/charges
{
  "amount": 97.00,
  "description": "Produto X",
  "expiresIn": 1800,
  "callbackUrl": "https://seusite.com/webhook",
  "customer": { "name": "João", "email": "joao@email.com" }
}

amount (obrigatório): valor em reais.
description: texto da cobrança.
expiresIn: validade do PIX em segundos.
callbackUrl: endereço que recebe o aviso de pagamento.
customer: dados do comprador (opcional).

Resposta:

{
  "id": "uuid",
  "status": "pending",
  "amount": 97, "fee": 1.4, "net": 95.6,
  "pix": { "brCode": "000201...", "qrCodeImage": "data:image/png;base64,..." },
  "expiresAt": "..."
}

Exemplo com cURL:

curl -X POST https://veronpay.online/api/public/v1/charges \
  -H "Authorization: Bearer vp_live_SUA_CHAVE" \
  -H "Content-Type: application/json" \
  -d '{"amount": 10, "description": "Teste"}'

Consultar cobrança

GET https://veronpay.online/api/public/v1/charges/{id}

Retorna a cobrança com status: pending, paid ou expired.

Listar cobranças

GET https://veronpay.online/api/public/v1/charges

Retorna suas cobranças mais recentes.

Saldo

GET https://veronpay.online/api/public/v1/balance

{ "balance": 250.75, "currency": "BRL" }

Webhooks

Quando o cliente paga, o valor (já descontada a taxa) entra no seu saldo da VERON PAY. Se você enviou callbackUrl, enviamos um POST para ele:

{ "event": "charge.paid", "id": "uuid", "status": "paid",
  "amount": 97, "fee": 1.4, "net": 95.6, "paidAt": "..." }

Dica: ao receber o aviso, confirme consultando GET /charges/{id} antes de liberar o produto.

Erros

401  Chave inválida ou ausente
400  Dados inválidos
404  Cobrança não encontrada
502  Erro ao gerar o PIX

{ "error": "mensagem do erro" }