Catálogo de Formatação (Datas, Moeda e Documentos)

📅 Datas

UsoFormatoExemplo
Data (nascimento, constituição, liquidação)YYYY-MM-DD1990-01-15
Timestamp (erros, eventos)ISO-8601 com offset2026-10-02T12:00:00Z

💰 Moeda e valores

ContextoFormato
Renda/faturamento (revenue)Inteiro em centavos (ex.: 1500000)
amount.value em webhook (fixed)Inteiro em centavos (ex.: 2000 = R$ 20,00)
amount.value em webhook (percent)Ponto flutuante (ex.: 0.15 = 15%)
MoedaBRL

📄 Documentos

CampoFormato
national_registration (CPF/CNPJ)Apenas dígitos, sem máscara
cnae, cbo, mccApenas dígitos

📞 Telefone e endereço

CampoFormato
phone.country_code55
phone.area_code2 dígitos (ex.: 11)
phone.numberApenas dígitos (ex.: 987654321)
address.postal_code8 dígitos
address.countryBR

⚠️ CPF/CNPJ sem máscara (só dígitos). Enviar com pontos/hífen pode gerar 400 ou divergência de validação.


Did this page help you?