Crie a chave com os escopos certos
A chave TEST começa com vk_test_; LIVE começa com vk_live_. O ambiente é definido pela credencial. Criar uma cobrança exige charges:write; consultar exige charges:read. As permissões padrão de uma nova chave são de leitura.
Faça as chamadas no servidor
Use Authorization: Bearer com a chave no backend. Não coloque segredo no JavaScript enviado ao navegador. O cliente da sua aplicação recebe apenas os dados necessários para apresentar a cobrança.
Guarde a operação
Emita com uma Idempotency-Key estável e guarde o id retornado junto do seu pedido. Valores são inteiros em centavos. Campos desconhecidos são recusados: confira o contrato antes de enviar um campo sugerido por uma IA.
Teste até o pedido ser confirmado
Em TEST, simule o pagamento usando a rota apropriada e confira o status PAID. Configure um webhook com assinatura válida, teste uma entrega duplicada e confirme que o pedido só é baixado uma vez.
A documentação pública e /llms.txt trazem os campos e regras detalhados. O OpenAPI da API precisa ser conferido com a implantação em uso.
Confira os campos e regras atuais antes de integrar. Seu cliente sempre paga a cobrança por Pix.
Abrir documentação ↗