Skip to main content
POST
Criar produto

Autorizações

Authorization
string
header
obrigatório

Chave secreta da conta: Authorization: Bearer sk_test_… ou sk_live_…. Use só no servidor.

Cabeçalhos

Idempotency-Key
string

Chave única por operação (um UUID serve). Repetir com a mesma chave devolve a resposta original.

Corpo

application/json
name
string
obrigatório
pricingModel
enum<string>
obrigatório

subscription, one_time, usage ou prepaid.

Opções disponíveis:
subscription,
one_time,
usage,
prepaid
key
string | null

Chave estável do produto, única na sua conta. Criar duas vezes com a mesma chave devolve o mesmo produto; um preço diferente do da versão atual é recusado com 422 pricing_immutable.

type
enum<string>

item (padrão) ou agent.

Opções disponíveis:
agent,
item
description
string | null
currency
string

Código ISO 4217 de 3 letras. Padrão: BRL.

Exemplo:

"BRL"

billingCycle
enum<string> | null

weekly, monthly ou annual. Obrigatório para subscription e prepaid; não envie nos outros modelos.

Opções disponíveis:
weekly,
monthly,
annual,
null
basePrice
string | null

Preço base da versão 1, em texto decimal ("49.90").

Resposta

Produto criado (ou o produto existente com a mesma key).

product
object

Um item do catálogo. O preço fica nas versões do produto.

version
object

Uma versão do produto: o retrato do preço. Uma versão publicada nunca muda; para mudar o preço, crie outra.