Como funciona a venda de produtos via API
1. Como a API identifica um produto
Na API, cada item enviado em uma cobrança possui um ID de produto (products[].id).
Esse ID é o identificador único que o sistema usa para saber se o produto já existe ou se precisa criar um novo.
Regra de funcionamento
Situação | Comportamento do sistema |
O ID do produto já existe | O produto é reutilizado |
O ID do produto não existe | Um novo produto é criado automaticamente |
Boa prática recomendada
Se você possui planos ou variações fixas, defina IDs permanentes para cada um.
Mesmo que o valor mude (promoções, descontos, condições especiais), mantenha o mesmo ID e altere apenas o preço enviado na requisição.
2. O produto é criado manualmente via API?
Não existe um endpoint específico para “criar produto”.
O produto surge automaticamente quando você envia uma requisição de cobrança (PIX, boleto ou cartão) contendo itens na lista de products.
Exemplo:
Se o id informado ainda não existir, o sistema cria o produto automaticamente no painel.
3. Por que os produtos criados via API ficam com status “Pendente”
Produtos originados por requisições da API são criados inicialmente como pendentes.
Isso faz parte do fluxo normal da plataforma.
Esse status não impede vendas via API. Ele apenas indica que o produto ainda não foi aprovado para uso no checkout interno do gateway mas pode ser vendido normalmente via api.
Se o produtor quiser vender pelo checkout interno, tem 2 opções:
ou ele cria um novo produto pelo painel, e vende esse novo produto
ou o admin aprova esse produto criado via API (mas talvez não seja a melhor opção, já que esse produto pode ser alterado via API
4. Configuração de aprovação automática de produtos
No painel administrativo existe a opção:
Configurações → Gerais → Extras → Aprovar novos produtos automaticamente
Essa configuração só se aplica a produtos criados pelo checkout interno.
5. Resumo técnico
A API não trabalha com planos ou ofertas, apenas com pedidos
Produtos são identificados exclusivamente pelo
products[].idIDs novos geram novos produtos
IDs repetidos reutilizam o mesmo produto
Produtos criados via API nascem como pendentes
Mesmo pendente, o produto pode ser vendido normalmente via API