Usar produtos e preços

Um produto descreve o que você vende. Seus planos definem como você cobra e seus preços especificam o valor em cada moeda. Escolha um preço do catálogo para vender essa oferta pelo checkout hospedado.

Por exemplo, um curso online é um produto. Você pode oferecer uma compra única ou uma assinatura mensal, cada uma com seus próprios preços.

Antes de começar

Configure o produto, seus planos e seus preços no Painel do Pharos. Use uma chave de API da conta e do ambiente onde a oferta está configurada. Seu backend precisa de permissão de leitura para consultar o catálogo e de escrita para criar uma sessão de checkout. Mantenha a chave no servidor.

Entender produtos, planos e preços

Produto: o que você vende

O produto identifica o bem ou serviço: o nome do curso, sua descrição e se está ativo. O mesmo curso pode ter várias opções de pagamento sem se tornar vários produtos.

Plano: como você cobra

Escolha a opção que corresponde à oferta. Um plano de pagamento único cobra uma vez. Um plano de assinatura define cobranças recorrentes e qualquer período de teste configurado. Um plano gratuito representa uma oferta sem cobrança.

Para o curso, escolha o plano de pagamento único para uma compra ou o plano de assinatura mensal para acesso contínuo. Essas opções dependem dos planos que você configurou.

Preço: quanto e em qual moeda

Cada plano pode ter preços em diferentes moedas. Um preço em USD e outro em ARS são valores configurados separadamente para a mesma opção de pagamento. Solicitar uma moeda não converte o valor da outra.

Escolher uma oferta disponível

Comece consultando seus produtos. Depois, escolha o plano da compra e um preço na moeda do cliente.

Use um produto ativo com plano e preço não arquivados. Uma referência de produto salva pode retornar itens inativos ou arquivados. Encontrá-la no catálogo não confirma disponibilidade para uma nova compra.

Verifique planos e preços padrão antes de usá-los. Pode não haver um padrão configurado ou ele pode ser excluído pelos filtros de moeda ou arquivo. Escolha uma opção disponível que corresponda à oferta, sem selecionar automaticamente o primeiro resultado.

Se o plano não tiver preço na moeda solicitada, ofereça outra moeda configurada ou mostre a oferta como indisponível. O valor do catálogo não é uma cotação final: descontos configurados e promoções aplicáveis ao cliente ou cartão afetam o valor no checkout.

Levar o cliente ao checkout

Para uma oferta reutilizável, use um link de pagamento. Configure a oferta uma vez e compartilhe sua URL de checkout.

Para um carrinho construído pela aplicação, use Cart Checkout. Seu backend envia o preço escolhido ao criar uma sessão de checkout e leva o cliente à URL retornada. Esse fluxo também aceita preços inline para valores contextuais fora do catálogo.

Mantenha uma relação entre a oferta na sua aplicação e seu produto, plano e preço no Pharos. Verifique o webhook de compra assinado antes da entrega; um redirecionamento bem-sucedido sozinho não confirma o pagamento.

Detalhes de implementação

Consulte requisições, respostas JSON, campos, consultas em lote, paginação e tratamento de erros na referência de Produtos.