Skip to main content
Assim que o motor de pagamentos registra o Pix, ele avisa o V4 Pay e a cobrança vira paid. Na prática, segundos. Se você cadastrou um webhook, o seu servidor é avisado logo depois.
Toda conta nova opera só em modo teste até a equipe do V4 Pay aprovar o cadastro — dados da empresa e três documentos. É o 409 com codigo: PRODUCAO_NAO_LIBERADA que você está vendo. O passo a passo está em Aprovação de produção.
Existe, e completo: crie uma chave com environment: "test" (v4pay_test_…), emita cobranças, simule o pagamento com POST /pix/simulate-payment e receba os webhooks — tudo sem mover dinheiro. É onde toda conta nova começa. Veja Ambiente de testes.
Depende do modo de recebimento em operação. Hoje, no modo conta única, passa: a cobrança entra na conta do V4 Pay e o repasse ao lojista é manual. No modo subconta (o desenho de destino), não: a taxa é separada na origem e o restante cai direto na conta do lojista.
Leia o codigo da resposta: PRODUCAO_NAO_LIBERADA é a aprovação de produção pendente (o caso mais comum); SUBCONTA_INEXISTENTE e SUBCONTA_NAO_APROVADA são do modo subconta, quando o cadastro da conta de recebimento falta ou está em análise. A lista completa, com o que fazer em cada um, está em Erros e códigos.
As rotas POST /pix/cancel e POST /pix/refund existem, mas ainda não executam o cancelamento nem a devolução na origem. Hoje elas respondem 502 explicando isso. Está documentado na Referência da API para ninguém ser pego de surpresa.
Cada chamada leva o header X-V4Pay-Signature, que é o HMAC-SHA256 do corpo calculado com o segredo do seu endpoint. Compare antes de confiar — o passo a passo está em Webhooks.
Não. A chave aparece uma única vez, na resposta de POST /api-keys. Depois só o prefixo fica visível. Crie outra e revogue a antiga com DELETE /api-keys/{id}.
As rotas públicas e as de login/cadastro têm limite por IP; as demais não têm limite próprio hoje. A tabela completa está em Limites.