Pular para o conteúdo principal
POST
Adicionar preço à versão

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.

Parâmetros de caminho

productID
string
obrigatório

ID do produto.

Pattern: ^prod_[0-9A-Za-z]{22}$
Exemplo:

"prod_1d4YogBuw00jAySh5mbUpk"

versionID
string<uuid>
obrigatório

ID da versão do produto.

Corpo

application/json
meterId
string<uuid>
obrigatório

O medidor que este preço cobra, do mesmo produto. Obrigatório: um valor fixo recorrente não é um preço, é o basePrice da versão.

model
enum<string>
obrigatório

flat, per_unit, tiered, volume ou package.

Opções disponíveis:
flat,
per_unit,
tiered,
volume,
package
unitAmount
string | null

Valor por unidade em texto decimal.

tiers
object[]

Faixas de preço para tiered, volume e package.

currency
string

Opcional; padrão é a moeda do produto.

Exemplo:

"BRL"

Resposta

Preço criado.

O preço de um medidor numa versão.

id
string<uuid>
obrigatório
productVersionId
string<uuid>
obrigatório
model
enum<string>
obrigatório

flat, per_unit, tiered (faixas progressivas), volume ou package.

Opções disponíveis:
flat,
per_unit,
tiered,
volume,
package
tiers
object[]
obrigatório

Faixas de preço para tiered, volume e package.

currency
string
obrigatório
meterId
string<uuid> | null

O medidor que este preço cobra.

unitAmount
string | null

Valor por unidade em texto decimal; aceita frações de centavo.