> ## Documentation Index
> Fetch the complete documentation index at: https://docs.z2pay.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Vendas rápidas

> Cobrança individual sem template: crie e envie a URL direto pelo WhatsApp ou e-mail.

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](/pt-BR/checkout/links): um template que gera uma
compra a cada acesso.

<Info>
  Todas as rotas exigem o header `x-api-key`. Veja [Autenticação](/pt-BR/autenticacao). 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`.
</Info>

***

## Endpoints

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

| Método | Rota                            | Descrição                                                     |
| ------ | ------------------------------- | ------------------------------------------------------------- |
| `POST` | `/checkout/charges`             | [Cria uma venda rápida](/pt-BR/checkout/charges/create)       |
| `GET`  | `/checkout/charges`             | [Lista as vendas rápidas](/pt-BR/checkout/charges/list)       |
| `GET`  | `/checkout/charges/{id}`        | [Busca uma venda rápida pelo ID](/pt-BR/checkout/charges/get) |
| `POST` | `/checkout/charges/{id}/cancel` | [Cancela uma venda rápida](/pt-BR/checkout/charges/cancel)    |

***

## Não é um recurso novo

Uma venda rápida **é** uma [Session](/pt-BR/checkout/links#do-link-à-session) sem `linkId`. Os três
nomes que aparecem no Checkout se encaixam assim:

|                     | O que é                                      | Como nasce                                                 |
| ------------------- | -------------------------------------------- | ---------------------------------------------------------- |
| **Link** (`chk_`)   | Template reutilizável                        | Você cria e divulga a URL                                  |
| **Session** (`cs_`) | A compra concreta, com valor congelado       | De um Link (`linkId` preenchido) ou avulsa (`linkId` nulo) |
| **Venda rápida**    | A Session avulsa, vista por uma rota própria | Você cria com os itens no corpo                            |

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](/pt-BR/checkout/links#estados-da-session).

<Note>
  **Recorrência não nasce aqui.** `mode: "subscription"` é recusado com `400` na venda rápida —
  assinatura só por [Link](/pt-BR/checkout/links#assinaturas-via-checkout). Para cobrar todo mês sem
  recorrência de verdade, o caminho é criar uma venda rápida por mês, com o cliente já preenchido; se
  o que você quer é renovação automática com planos e faturas, veja
  [Assinaturas](/pt-BR/subscriptions/visao-geral).
</Note>

***

## Veja também

<CardGroup cols={2}>
  <Card title="Checkout Links" icon="link" href="/pt-BR/checkout/links">
    A Session, os estados e a reconciliação — o objeto por baixo das vendas rápidas.
  </Card>

  <Card title="Visão geral do Checkout" icon="layout-template" href="/pt-BR/checkout/visao-geral">
    Conceitos, casos de uso e mapa de endpoints.
  </Card>

  <Card title="Assinaturas" icon="repeat" href="/pt-BR/subscriptions/visao-geral">
    Cobrança recorrente de verdade: planos, ciclos e faturas.
  </Card>

  <Card title="Erros" icon="circle-alert" href="/pt-BR/erros">
    Formato dos erros e os códigos de domínio do Checkout.
  </Card>
</CardGroup>
