Skip to main content
Uma venda rápida é uma cobrança montada por você para uma pessoa, uma vez — um pedido específico, uma fatura avulsa. Você define os itens na própria requisição e recebe a URL de pagamento pronta para enviar pelo seu canal. Para divulgação em massa, o formato é o Link: um template que gera uma compra a cada acesso.
Todas as rotas exigem o header x-api-key. Veja Autenticação. Os exemplos usam a base URL de sandbox https://api.sandbox.z2pay.com/v1, e a página hospedada de sandbox é https://pay.sandbox.z2pay.com.

Endpoints

Cada endpoint tem sua própria página, com os campos aceitos, exemplos e o playground para testar.

Não é um recurso novo

Uma venda rápida é uma Session sem linkId. Os três nomes que aparecem no Checkout se encaixam assim: O que essas rotas acrescentam à Session é conveniência: a listagem já filtrada (só as sem linkId, para o painel não misturar) e o endpoint de cancelamento. Estado, valor congelado, webhooks e reconciliação são os mesmos — estão descritos em Links.
A venda rápida também vende assinatura, com mode: "subscription" e subscriptionConfig — veja Criar venda rápida. O que ela não faz é vender um plano publicado: planId é recusado, porque o plano é materializado na publicação do Link. Aqui você informa a cadência e os itens na própria requisição.

Veja também

Checkout Links

A Session, os estados e a reconciliação — o objeto por baixo das vendas rápidas.

Visão geral do Checkout

Conceitos, casos de uso e mapa de endpoints.

Assinaturas

Cobrança recorrente de verdade: planos, ciclos e faturas.

Erros

Formato dos erros e os códigos de domínio do Checkout.