Para quem vende · API e webhooks

API: criar e editar produtos e ofertas

Com uma credencial de acesso total você lista, cria, edita e oculta produtos e cria, edita, pausa e exclui ofertas, com as mesmas regras do painel (página de vendas, WhatsApp de suporte, limites de preço e análise do produto). Preço em reais; cada oferta volta com o checkoutUrl. Envie o supportEmail: sem ele (e sem o e-mail de suporte padrão da conta), o produto é criado do mesmo jeito e a resposta traz warnings com SUPPORT_EMAIL_MISSING.

Passo a passo

1. Gere uma credencial de acesso total em Integrações › API (escopo parcial recebe 403; a chave de teste recebe 501).
2. Liste com GET /gateway/products (includeHidden=true mostra os ocultos).
3. Crie com POST /gateway/products (nome, tipo, página de vendas, supportEmail e WhatsApp quando a plataforma exige). Sem supportEmail, a resposta traz warnings; trate como pendência.
4. Edite ou oculte com PUT /gateway/products/{id} e "hidden": true; o tipo não muda depois de criado.
5. Crie ofertas com POST /gateway/products/{id}/offers (preço e, na assinatura, a recorrência) e use o checkoutUrl devolvido.
6. Pause com PUT …/offers/{offerId} e "active": false, ou exclua com DELETE (o código nunca é reaproveitado).

Já tem conta? Este passo a passo fica em Abrir API, no painel.