Skip to main content
A Vext é um gateway de pagamentos Pix, cartão e boleto, com split entre o vendedor e a plataforma. Você cria a cobrança, mostra o código ao comprador, e nós avisamos quando o dinheiro entra.

Primeira cobrança

Do sk_test_ ao QR na tela, com o webhook já ligado.

Referência da API

As nove operações e os nove eventos, com playground.

Webhooks

Como receber e conferir a assinatura.

​
Quatro convenções que valem para tudo

Conhecendo estas quatro, o resto da documentação fica previsível — e você evita os tropeços mais comuns de quem começa.

​
Escolha o método

Pix

Cai em segundos. O padrão quando você omite payment_method.

Cartão

Decide na hora, parcela, e o número nunca passa pelo seu servidor.

Boleto

Janela de dias. Disponível em contas de split.

​
Três coisas que vale saber de antemão

Para você não procurar o que não existe:
  • A imagem do QR você gera. Devolvemos o payload copia-e-cola em pix.qr_code, e qualquer biblioteca de QR o transforma em imagem. O mesmo vale para o boleto: devolvemos a linha digitável e o endereço do PDF, não o arquivo.
  • Um cartão entra no cofre vendendo, não cadastrando. Não há POST /v1/cards: o cartão é guardado como efeito de uma cobrança aprovada com save_card. Ver Cofre de cartões.
  • Cada chave enxerga só a própria conta. A lista devolve apenas as cobranças do vendedor dono da chave, e uma cobrança de outra conta responde o mesmo 404 de uma que não existe.

​
URL base

Toda chamada vai para:
Todo endpoint desta versão vive sob /v1. A URL completa de uma criação de cobrança é https://api.usevext.com/v1/charges.
Ficou algo de fora? Chame no WhatsApp. Se o assunto for uma chamada específica, informe o horário dela; se for uma entrega de webhook, informe o X-Vext-Delivery — é por ele que localizamos a tentativa, a resposta do seu servidor e o horário.