Catálogo de produtos¶

Um produto é o item reutilizável por trás de tudo o que você vende: um plano SaaS, um bem físico, um serviço ou uma oferta pontual. Defina uma vez e conecte a links de pagamento, planos de assinatura ou sessões de checkout em vez de repetir os mesmos dados em cada cobrança.

Em resumo

Para quem: equipes que vendem um ou vários produtos ou serviços.
Tempo: 5 minutos.
Resultado: um produto reutilizável pronto para planos e links de pagamento.

Para quem
Founders, operações e desenvolvimento

Tempo
5 minutos

Nível
Iniciante

Resultado
Catálogo reutilizável

O que é um produto?¶

Um produto guarda o nome, a descrição e o status de algo que você vende. Planos e links de pagamento referenciam o produto em vez de duplicar suas informações.

Uma única fonte de verdade — atualize o produto uma vez e reutilize.
Relatórios mais claros — agrupe receita por produto em vez de por cobrança.
Configuração mais rápida — crie um plano ou link sem redigitar a oferta.

Disponibilidade no console

O catálogo está disponível hoje pela API. A visualização no console está sendo liberada por workspace. Se ainda não vê Payments → Products, use a API ou fale com o suporte para habilitar.

Criar um produto¶

APIConsole

curl -X POST 'https://api.4geeks.io/v1/products' \
  -H 'X-Api-Key: sk_test_your_api_key_here' \
  -H 'Content-Type: application/json' \
  -d '{
    "name": "Plano Premium",
    "description": "Assinatura mensal com todos os recursos",
    "active": true
  }'

A resposta retorna o id do produto, que você pode usar ao criar um plano ou link de pagamento.

Abra o Console da 4Geeks.
Vá para Payments → Products.
Selecione New product.
Informe um nome e uma descrição opcional.
Salve o produto e copie o ID.

Campos do produto¶

Campo	Tipo	Obrigatório	Observações
`name`	string	Sim	Nome visível para o cliente
`description`	string	Não	Explicação breve do que o cliente recebe
`active`	boolean	Não	Padrão `true`; um produto inativo não pode ser vendido

Produtos, planos e links de pagamento¶

Se você precisa…	Use…	Por quê
Uma cobrança única com descrição reutilizável	Produto + link de pagamento	Compartilhe uma URL sem reconstruir a oferta
Uma assinatura recorrente	Produto + plano	O plano adiciona valor, moeda e intervalo
Um checkout totalmente personalizado	Produto + sessão de checkout	Você controla a experiência no seu app

Gerencie seu catálogo¶

Liste produtos com GET /v1/products e pagine com limit e offset.
Desative um produto em vez de excluí-lo para preservar o histórico.
Mantenha nomes estáveis — eles aparecem no checkout, recibos e relatórios.

Perguntas frequentes¶

Posso alterar um produto depois de criar um plano?

Sim. Você pode atualizar o nome e a descrição. O preço fica no plano, então alterar o valor não exige criar outro produto.

Links de pagamento exigem um produto?

Não. Links de pagamento podem ser criados apenas com descrição e valor. Produtos são recomendados quando você quer um catálogo reutilizável e relatórios consistentes.

O que acontece se eu desativar um produto?

Planos e links existentes mantêm o histórico, mas novos checkouts devem usar um produto ativo.

Relacionado¶

Criar meu primeiro produto

Ainda tem dúvidas? Pergunte no Discord ou explore os tutoriais.