price representa quanto e como um produto é cobrado. Ele sempre pertence a um produto e fixa o valor (unit_amount), a moeda (currency) e a forma de cobrança — uma compra única (one_time) ou uma cobrança recorrente (recurring) com intervalo e frequência definidos. Um mesmo produto pode ter vários preços ao mesmo tempo: mensal, anual, promocional ou em moedas diferentes.
É o price que checkouts e assinaturas referenciam na hora de cobrar — ele guarda os termos da cobrança para que o valor seja sempre o mesmo, independentemente de quantas vendas ele origina. Por isso campos como unit_amount, currency, type e recurring são imutáveis: para mudar o valor de um produto, você cria um preço novo e desativa o antigo com is_active=false, preservando o histórico das cobranças que já usaram o preço anterior.
Data Object
Este é o formato completo retornado emcreate, get, update, itens de
list e em data.object dos webhooks price.*.
Preço de referência na menor unidade da moeda (centavos em
brl), maior que unit_amount, ou null para remover.
Exemplo: 149700 com unit_amount=29700 permite exibir “De R$ 1.497 por R$ 297”.
Só aparece quando checkout_experience.show_compare_at_amount=true. Não altera
a cobrança. Pode ser editado; sessões já criadas conservam a referência original.true enquanto o preço pode ser usado em novos checkouts e assinaturas.
false desativa o preço sem afetar cobranças que já o utilizaram.Valor cobrado, na menor unidade da moeda (centavos em
brl) da moeda. 9990 equivale a R$ 99,90.Data da última atualização em ISO 8601. Vem
null enquanto o preço nunca foi
atualizado.Operações
Eventos
Mudanças nesse objeto disparam os seguintes eventos: O payload sempre carrega o objetoprice completo em data.object; eventos de update também incluem data.previous_attributes com os valores anteriores dos campos alterados.
