Criar versão de preço
Publica um valor novo para um item do plano. Quem já assinou continua no preço que contratou.
POST /plans/:id/prices
Faz parte do recurso Planos e Preços — o item, o preço versionado e
os status estão lá.
É assim que se reajusta: a versão nova entra como vigente e a anterior, de mesma moeda e cadência,
deixa de ser — sem apagar nada. A resposta é a versão criada.
planItemId ou por planItemKey — um dos dois, não os dois. Sem nenhum, o
preço vai para o item de key default, que é o comportamento dos planos de item único.
Referência que não casa com nenhum item do plano responde 404.409.Exemplo
Authorizations
API Key da Credential (gerada no Backoffice)
Headers
Chave única para garantir idempotência da requisição
Path Parameters
ID do plano
Body
Valor da cobrança, em centavos (menor unidade da moeda).
x >= 0Item do plano que este preço versiona. Informe este OU planItemKey.
1 - 36Alternativa ao planItemId: a key do item dentro do plano.
1 - 100^[a-z0-9-_]+$Forma de cobrança. Hoje só fixed (valor fixo por ciclo).
fixed Código de moeda ISO 4217. Hoje o único valor aceito é 'BRL'.
BRL Response
Price criado e marcado como current
Identificador único do registro.
ID do componente (plan item) ao qual o preço se refere.
ID do plano ao qual o registro pertence.
Esquema de cobrança do preço: fixed, per_unit, tiered, package ou metered.
Valor do preço ou da linha, em centavos.
Moeda no padrão ISO 4217 (ex.: BRL).
Regra de recorrência (intervalo, unidade e âncora do ciclo).
Configuração do período de teste (trial) do preço; nula se sem trial.
Indica se esta é a versão de preço atualmente vigente.
Data e hora em que a versão de preço foi publicada (ISO 8601).
Data e hora em que a versão de preço foi arquivada; nula se ainda vigente (ISO 8601).
Data e hora de criação do registro (ISO 8601).
Data e hora da última atualização do registro (ISO 8601).