Skip to main content
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<uuid>
obrigatório

ID do produto.

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
any
padrão:[]

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>
productVersionId
string<uuid>
meterId
string<uuid> | null

O medidor que este preço cobra.

model
enum<string>

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

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

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

tiers
object[]

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

currency
string