Skip to main content
Um preço define quanto e como um produto é cobrado: uma vez ou de forma recorrente. Todo preço pertence a um produto e as rotas ficam em /products/{productId}/prices.

Estrutura

Atributos

Valor em centavos (inteiro, mínimo 100).
brl ou usd.
one_time (cobrança única) ou recurring (assinatura).
Só em preços recorrentes: interval é day, week, month ou year, e intervalCount é a quantidade de intervalos entre cobranças (inteiro ≥ 1). Em one_time ambos são null.
Mapa de chaves e valores seus: até 10 chaves, chave com até 20 caracteres, valor string (até 255 caracteres) ou booleano.

Endpoints

Todos exigem chave secreta (sk_). Não há endpoint para excluir preços. Preços são referenciados por UUID em itens de links de pagamento, sessões de checkout e assinaturas (campo price).