Presells
Criar presell
Cria uma promoção de presell (simple, custom ou iframe) em uma ação
POST
Cria um presell na ação — uma promoção exibida na página de seleção do pedido, antes do pagamento. Máximo de 10 presells por ação.
Presell não suporta o tipo
redirect. Redirecionar o comprador enquanto ele monta o pedido interromperia a compra. Tipos válidos: simple, custom e iframe — com o mesmo contrato dos upsells.Path params
ID da ação (UUID).
Body — campos comuns
simple, custom ou iframe. Omitido = simple.Título (1–255 caracteres).
Descrição (máx. 1000).
Ordem de exibição (menor = primeiro).
Se o presell é exibido.
Body — por tipo
simple
custom
iframe
Erros
| HTTP | Código | Quando ocorre |
|---|---|---|
404 | RAFFLE_NOT_FOUND | Ação inexistente ou de outra conta |
400 | PRESELL_LIMIT_REACHED | Já existem 10 presells na ação |
400 | PRESELL_SIMPLE_FIELDS_REQUIRED | tipo simple sem o objeto simple completo |
400 | PRESELL_CUSTOM_CONFIG_REQUIRED | custom sem o objeto custom |
400 | PRESELL_IFRAME_CONFIG_REQUIRED | iframe sem o objeto iframe |
400 | PRESELL_CONFIG_TYPE_MISMATCH | Objeto de configuração não corresponde ao type |
400 | PRESELL_CUSTOM_CONTENT_EMPTY | HTML vazio após sanitização |
400 | PRESELL_PLACEHOLDER_NOT_FOUND | Placeholder não aparece no content |
422 | VALIDATION | Formato inválido — inclusive type: "redirect", que não existe em presells |