Documentação › Checkout › Visão Geral

Checkout

Monte o carrinho com as variantes escolhidas e gere o link de checkout da loja, pronto para redirecionar o cliente ao pagamento.

Base URL 
https://api.aproveicheckout.com.br/v1

Autenticação: token Bearer com a ability checkout:create e o header X-Store-Slug. Ver autenticação →

Como Funciona

  1. Obtenha os variantId dos produtos em Listar produtos ou Buscar produtos.
  2. Envie os itens para POST /cart/create-checkout com um header Idempotency-Key único.
  3. Redirecione o cliente para a checkoutUrl (ou checkout_direct_url) retornada.

Idempotência

O header Idempotency-Key é obrigatório e protege contra checkouts duplicados por reenvio de rede. A mesma chave com o mesmo payload retorna o mesmo checkout por 24 horas; a mesma chave com um payload diferente retorna 409 IDEMPOTENCY_KEY_CONFLICT. Gere uma chave nova a cada checkout distinto (ex.: um UUID por carrinho).

Criar checkout
POST /cart/create-checkout — referência completa
Erros e Limites
Códigos de erro e rate limits

Rate limit: 60 requisições/min por token + loja na criação de checkout.