Para desenvolvedores

API de pagamentos para o seu software

Pix, cartão e boleto via REST com idempotência, webhooks assinados e ambiente de testes. Integre cobrança no seu SaaS, app ou marketplace sem virar adquirente.

REST com chaves de API e escopo por ambienteIdempotência nativa contra cobrança duplaWebhooks assinados com HMACSandbox com cartões de teste

Sem mensalidade · Sem fidelidade · Cancele quando quiser

V

Checkout Voren

Pagamento 100% seguro

Nome completo
E-mail
CPF
PixAprovação instantânea
Pagar agora

Liquidação D+0 · Split automático · Antifraude

REST

Padrão JSON + HTTPS

HMAC

Assinatura dos webhooks

D+0

Liquidação do Pix

100%

Eventos rastreáveis em log

O que quebra integrações de pagamento em produção

Os mesmos três vilões derrubam operação após operação.

Cobrança duplicada em retry

Timeout no cliente + retentativa sem idempotência = cliente cobrado duas vezes e chargeback garantido.

Webhook sem validação

Aceitar notificação sem verificar assinatura abre porta para liberar pedido sem pagamento real.

Estado inconsistente

Confiar só no retorno síncrono da criação, sem processar eventos assíncronos, dessincroniza pedido e pagamento.

O que a Voren API entrega

Os fundamentos que uma integração séria exige, já prontos.

01

Cobranças idempotentes

Chave de idempotência por requisição: retry seguro sem risco de duplicar cobrança no cliente.

02

Webhooks assinados

Eventos de aprovação, recusa, reembolso e estorno com assinatura HMAC e reenvio automático em falha.

03

Cartão tokenizado

Os dados do cartão nunca tocam seu servidor: tokenização no cliente e processamento em ambiente certificado.

04

Logs e rastreio

Cada requisição e evento fica registrado com payload e status — depurar integração não é arqueologia.

Integre em 4 passos

Do zero à primeira cobrança de teste.

  1. 1

    Gere suas chaves de API

    No painel da Voren, em Integrações, você cria chaves de teste e de produção com escopos separados.

  2. 2

    Crie a primeira cobrança

    POST com valor, meio de pagamento e chave de idempotência. Em sandbox, use os cartões de teste da documentação.

  3. 3

    Valide os webhooks

    Aponte seu endpoint, verifique a assinatura HMAC e processe os eventos de forma idempotente também no seu lado.

  4. 4

    Suba para produção

    Troque as chaves, rode uma venda real de baixo valor e acompanhe os logs das primeiras horas.

Quem integra pela API

SaaS com cobrança embutida

Assinaturas e cobranças dentro do próprio produto, com retry de falha e gestão de status por webhook.

Marketplaces e plataformas

Split de pagamento entre vendedores, com regras de comissão aplicadas automaticamente na liquidação.

Agências e devs independentes

Pagamento nos projetos dos clientes sem construir adquirência própria: semanas de integração viram dias.

Arquitetura da integração

Boas práticas que a documentação da Voren detalha endpoint a endpoint.

Fluxo recomendado

Crie a cobrança com chave de idempotência, responda ao seu usuário com o estado inicial e confirme o pedido somente quando o webhook de aprovação chegar e a assinatura validar. Nunca libere entrega com base no retorno síncrono da criação.

  • Criação: POST /charges com Idempotency-Key.
  • Confirmação: webhook charge.paid com assinatura HMAC válida.
  • Estado final: aprovado, recusado, reembolsado ou estornado — sempre via evento.

Segurança das credenciais

Chaves de produção vivem apenas no servidor, nunca no frontend ou no repositório. Rotacione em caso de suspeita e use chaves de teste em ambientes de desenvolvimento e CI. A Voren nunca pede sua chave por suporte ou e-mail.

Onde ver a referência completa

A documentação pública da Voren API lista endpoints, parâmetros, códigos de erro e exemplos de payload para cada evento de webhook. Ela está disponível em /api-docs e dentro do painel, em Integrações.

Perguntas frequentes

O que é uma API de pagamentos?

É a interface que permite ao seu sistema criar cobranças, consultar status e receber confirmações de pagamento programaticamente — Pix, cartão e boleto — sem construir integração direta com cada adquirente e banco. Você chama endpoints REST e recebe eventos por webhook.

Preciso de uma API ou um checkout pronto resolve?

Se você vende produtos digitais sem desenvolvimento próprio, o checkout pronto resolve e converte melhor. A API faz sentido quando existe software próprio: SaaS com cobrança embutida, app com pagamento interno, marketplace com regras de split customizadas.

O que uma boa API de pagamentos precisa ter?

Endpoints idempotentes (retentativa segura), webhooks assinados, ambiente de sandbox, documentação com exemplos, chaves com escopo e logs de requisição. Sem esses itens, a operação vira frágil em escala.

Como funciona a idempotência na Voren API?

Toda criação de cobrança aceita uma chave de idempotência: se a mesma requisição chegar duas vezes (timeout, retry do cliente), a segunda chamada retorna a cobrança original em vez de duplicar a cobrança. É a proteção padrão contra cobrança dupla.

Os webhooks da Voren são assinados?

Sim. Cada evento carrega assinatura HMAC que o seu endpoint valida antes de processar, garantindo que a notificação veio da Voren e não foi adulterada. Eventos incluem pagamento aprovado, recusado, reembolso e estorno.

Posso testar sem movimentar dinheiro real?

Sim. A Voren oferece ambiente de testes com chaves separadas e cartões de teste para simular aprovação e recusa. Você desenvolve e valida o fluxo inteiro antes de apontar para produção.

Integre pagamentos hoje

Crie sua conta, gere as chaves de teste e faça a primeira cobrança em sandbox ainda hoje. Documentação completa em /api-docs.

Ver a documentação

Leva menos de 2 minutos · Não pedimos cartão

Continue explorando