Um POST. Um PIX. Um webhook.
A rota principal gera uma cobrança PIX e devolve o copia-e-cola na hora. Quando o cliente paga, o evento chega na sua URL — sem polling e sem montar checkout.
# Gera o PIX e devolve o QR na hora
curl -X POST \
https://api.venturepay.com.br/v1/orders/charge/pix/ \
-H "Content-Type: application/json" \
-H "venture-signature: SEU_SECRET" \
-d '{
"public_key": "vp_prod_…",
"amount": 15000,
"order_id": "PEDIDO-1042",
"customer": {
"name": "Maria de Souza",
"document": "52998224725",
"email": "maria@exemplo.com",
"phone": "11987654321"
}
}'Espaço do print · resposta PIX no seu app
Coloque api-pix.png ou api-pix.gif na pasta desta página.
Você não precisa montar tela de pagamento para PIX. A API devolve o código e o QR. O cliente paga no banco dele.
O webhook payment_paid chega quando o dinheiro entra. Confirme a assinatura e libere o pedido.
O order_id é a chave de idempotência. A mesma referência não cria um segundo PIX.
Da chave ao primeiro PIX
Crie a conta de desenvolvedor, copie as chaves e faça um POST. O restante é webhook.
Espaço do GIF · criar chave e gerar PIX
Substitua api-console.gif nesta pasta. Proporção recomendada: 16:9 (1280×720).
Conta, token com permissão sales e a primeira chamada — o painel mostra o mesmo fluxo.
Criar conta agoraCrie a conta developer
Em developer.venturepay.com.br você gera a public_key e o secret. O token precisa da permissão sales.
Faça o POST do PIX
Envie valor em centavos, dados do pagador e o header venture-signature. A resposta já traz pix.code e o QR.
Espere o webhook
Cadastre a URL no painel. payment_created sai na criação; payment_paid quando o PIX é confirmado.
Gerar cobrança PIX
Cobrança avulsa, sem página de checkout. Você mostra o QR no seu produto; a VenturePay processa e avisa o pagamento.
POST com public_key + assinatura
Header venture-signature é o secret do token.
Resposta 200 com copia-e-cola
transaction_id, pix.code, qr_code_url e validade.
Cliente paga no banco
Webhook payment_paid fecha o pedido no seu sistema.
-
amount em centavos:
15000= R$ 150,00. Entre R$ 1,00 e R$ 100.000,00. - customer exige nome, CPF/CNPJ, e-mail e telefone.
- order_id evita cobrança duplicada. fee_payer escolhe se a taxa fica com a empresa ou com o cliente.
- Taxa do PIX: R$ 1,99 por transação recebida. Sem mensalidade da API.
{
"success": true,
"data": {
"transaction_id": "VEN9C6FA1E7",
"order_id": "PEDIDO-1042",
"status": "pending",
"amount_cents": 15000,
"pix": {
"code": "00020101021226…",
"qr_code_url": "https://…",
"expires_at": "2026-09-03 19:22:48"
}
}
}Espaço do print · PIX no seu produto
Anexe api-qr.png ou um GIF do QR sendo exibido no seu app.
As outras rotas, em resumo
O PIX é o caminho principal. O restante existe para checkout hospedado, conciliação e saldo — o contrato completo está na documentação.
Abrir todos os endpoints/orders/charge/payment-link/
Cria um link de pagamento hospedado: PIX, cartão em até 12x, desconto e personalização. Útil quando você quer mandar um URL, não um QR.
Ver na documentação/orders/?public_key=&transaction_id=
Consulta o status atual de uma cobrança. Use quando o webhook atrasar ou para conciliar sob demanda.
Ver na documentação/balance/
Devolve saldo disponível, pendente e total da conta. Bom para dashboard interno e regras de saque.
Ver na documentaçãoEspaço do print · tokens e endpoints
Anexe api-tokens.png com a tela de chaves ou da documentação.
Webhooks que fecham o ciclo
Cadastre a URL em Desenvolvedor → Webhooks. Cada POST leva o header venture-signature: HMAC-SHA256 do corpo que enviamos, com o secret do webhook — não é o mesmo secret da chamada de cobrança.
Disparado depois que a cobrança PIX é criada. Serve para gravar o transaction_id no seu pedido.
Disparado quando o PIX é confirmado. Valide a assinatura, responda 2xx e libere o produto. Sem 2xx, repetimos a entrega.
Link de pagamento com webhook_url própria continua recebendo o evento daquele link. O canal da conta cobre as cobranças da API.
Espaço do print · entregas de webhook
Anexe api-webhooks.png ou api-webhooks.gif com o log do painel.
HMAC-SHA256(corpo do POST, secret do webhook)
→ header venture-signature (hex, sem prefixo)
# Compare antes de processar qualquer dadoConta de desenvolvedor e docs no mesmo lugar
A conta libera chaves, webhooks e sandbox. A documentação tem o contrato de cada rota, exemplos e códigos de erro.
Perguntas frequentes
POST https://api.venturepay.com.br/v1/orders/charge/pix/ gera a cobrança PIX e devolve o copia-e-cola. O pagamento é confirmado depois, pelo webhook payment_paid. Detalhe em Gerar cobrança PIX.
Envie a public_key no JSON e o secret do token no header venture-signature. O token precisa da permissão sales. As chaves saem da conta em developer.venturepay.com.br.
Na requisição, amount é sempre em centavos. A resposta devolve também o valor em reais e o líquido depois da taxa.
Link de pagamento hospedado, consulta de cobrança, consulta de saldo e os webhooks da conta. Não detalhamos cada campo aqui — isso fica na documentação.
Calcule o HMAC-SHA256 do corpo recebido com o secret cadastrado no webhook. Compare com o header venture-signature (hexadecimal, sem prefixo). Exemplos em PHP e Node estão em docs → Webhooks.
Ainda não. Fatura única, recorrência, cartão salvo e protesto ficam no painel — veja a página de Faturas. A API cobre PIX, link, consulta e saldo.
Precisa de um endpoint que ainda não existe? Fale com a equipe
Gere o primeiro PIX
ainda hoje
Crie a conta de desenvolvedor, copie as chaves e siga o exemplo da documentação. Você só paga quando o PIX entra.