Datas e fusos
Datas são strings ISO 8601 com hora e fuso explícitos, como2026-09-06T13:00:00Z. Para campos de data editáveis, envie Z (UTC) ou o deslocamento, como 2026-09-06T10:00:00-03:00. Esses exemplos representam o mesmo instante.
A API valida o calendário, exige segundos e normaliza as datas recebidas em campos editáveis para UTC. Não envie apenas a data nem um horário sem fuso. Exiba o instante no fuso adequado ao usuário; não altere o valor armazenado para simular outro fuso.
created_at indica criação; updated_at, a última alteração. Em pedidos, effective_order_at indica a data efetiva da compra e access_expires_at define a validade do acesso. Datas sem valor aparecem como null somente quando o campo permite.
Moedas e valores
Preços e pedidos usamBRL ou USD, em maiúsculas. Valores como unit_amount, setup_fee, min_price e suggested_price são inteiros em centavos da moeda indicada.
Não envie
49.90 para representar R$ 49,90 em um campo inteiro: envie 4990. A API não faz conversão cambial. Os indicadores total_revenue_cents e mrr_cents do cliente também são expressos em centavos.
Precisão decimal dos preços
unit_amount_decimal é uma string decimal em centavos, com ponto e até 12 casas decimais, usada quando é necessário representar frações de centavo. Por exemplo, "0.5" representa meio centavo. Não use vírgula, símbolo de moeda ou separador de milhar. Veja as regras do preço.
Intervalos
Períodos de renovação e teste usamday, week, month ou year, junto de uma quantidade. month com quantidade 3 descreve três meses. Esses campos descrevem as condições comerciais do preço, não uma data fixa em segundos.