Skip to main content

​
O que é

O V4 Pay emite cobranças Pix em nome do seu negócio — pelo painel, sem escrever código, ou pela API. O cliente paga pelo QR code ou pelo copia-e-cola, a confirmação chega sozinha, e o seu sistema pode ser avisado por webhook.

Sou lojista

Quero criar cobranças, links de pagamento e acompanhar recebimentos pelo painel. Sem código.

Sou desenvolvedor

Quero gerar cobranças pelo meu sistema e ser avisado quando o cliente pagar.

​
Para onde vai o dinheiro

O V4 Pay opera em um de dois modos de recebimento — qual está ativo é configuração do servidor, e Modo de recebimento explica cada um em detalhe: Em qualquer modo, operar em produção exige a aprovação de produção: conta nova começa em modo teste, e a equipe libera depois de analisar os dados da empresa e os documentos.

​
O que dá para fazer

Cobranças Pix

QR code e copia-e-cola, com confirmação automática.

Links de pagamento

Uma URL pública que abre o checkout com o valor já definido.

Assinaturas

Cobrança recorrente, gerada por um cron diário.

Cupons e produtos

Catálogo e descontos aplicados no checkout.

Webhooks

Seu servidor é avisado quando algo acontece, com assinatura HMAC.

Chaves de API

Uma chave por integração, revogável a qualquer momento.

​
Como a API responde

Toda resposta é JSON. Sucesso vem dentro de data:
Erro vem dentro de error, com uma mensagem em português — e, nos erros de negócio, um codigo estável para o seu código tratar (a lista completa está em Erros e códigos):
Há uma exceção, herdada do middleware de autenticação: quando o token está ausente, inválido ou a chave foi revogada, error é uma string, não um objeto: { "error": "Token JWT ou chave de API ausente" }. Trate os dois formatos.

​
Ambientes

Existe também um modo de teste por requisição, completo e sem dinheiro de verdade — é onde toda conta nova começa. Veja Ambiente de testes.