> ## Documentation Index
> Fetch the complete documentation index at: https://docs.hubfy.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Datas, fusos e moedas

> Represente horários e valores sem ambiguidades.

## Datas e fusos

Datas são strings ISO 8601 com hora e fuso explícitos, como `2026-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 usam `BRL` ou `USD`, em maiúsculas. Valores como `unit_amount`, `setup_fee`, `min_price` e `suggested_price` são inteiros em centavos da moeda indicada.

| Valor | Moeda | Exibição |
| - | - | - |
| `4990` | `BRL` | R\$ 49,90 |
| `4990` | `USD` | US\$ 49,90 |
| `0` | `BRL` | R\$ 0,00 |

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](https://docs.hubfy.io/api-reference/prices/object.md#criação-e-alterações).

## Intervalos

Períodos de renovação e teste usam `day`, `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.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.