Preset vertical
Preset Fintech — cliente completo em 1 chamada
Dev fintech tá testando checkout PIX, credit engine, KYC ou antifraude. Precisa CPF, PIX, conta bancária, cartão de crédito, score Serasa e renda mensal coerentes entre si. O preset fintech resolve com 1 request. Sem correlacionar campo por campo depois.
O que vem dentro
- ✅ Customer — nome, CPF, email, telefone, endereço
- ✅ Renda mensal — log-normal, mediana R$3.500
- ✅ Score Serasa — 300-1000, normal ponderada
- ✅ PIX keys — 3-4 chaves (CPF, email, phone, aleatória)
- ✅ Conta bancária — 15 bancos brasileiros com código COMPE real
- ✅ Cartão de crédito — Luhn válido, brand random, holder = customer
Como chamar
HTTP (curl)
curl -H "X-API-Key: sua_chave" \
"https://fakeforge.com.br/api/generate?preset=fintech&quantity=100"Node SDK
import { FakeForge } from "fakeforge-br";
const ff = new FakeForge({ apiKey: process.env.FAKEFORGE_API_KEY });
const clientes = await ff.preset("fintech", 100);Python SDK
import os
from fakeforge import FakeForge
ff = FakeForge(api_key=os.environ["FAKEFORGE_API_KEY"])
clientes = ff.preset("fintech", 100)Sem conta e no Free, o preset devolve uma amostra de 3 clientes por chamada. No passe de 7 dias e no Dev, até 2.000 por chamada. Pra gerar no navegador e baixar CSV, JSON ou SQL, use a página Dados relacionados.
Sample output
{
"preset": "fintech",
"quantity": 1,
"data": [
{
"customer": {
"nome": "Marina Souza Oliveira",
"cpf": "428.153.792-04",
"email": "marina.souza@gmail.com",
"telefone": "(11) 98432-7156",
"endereco": {
"cep": "04552-030",
"logradouro": "Rua Funchal, 375",
"bairro": "Vila Olímpia",
"cidade": "São Paulo",
"estado": "SP"
},
"renda_mensal": 6800,
"score_serasa": 742
},
"pix_keys": [
{ "type": "cpf", "value": "42815379204" },
{ "type": "email", "value": "marina.souza@gmail.com" },
{ "type": "phone", "value": "+5511984327156" },
{ "type": "aleatoria", "value": "8f4e2c91-a3b7-4d5e-9f2a-1c8b6d0e5a3f" }
],
"bank_account": {
"bank": "260 - Nu Pagamentos (Nubank)",
"agency": "0001",
"account": "6284591-3",
"type": "corrente"
},
"credit_card": {
"number": "5234 8891 2947 6103",
"brand": "mastercard",
"cvv": "428",
"expiry": "07/29",
"holder_name": "MARINA SOUZA OLIVEIRA"
}
}
]
}Casos de uso reais
Teste de checkout PIX
As chaves PIX são o CPF, o email e o celular do próprio cliente, e o cartão sai no nome dele. Antifraude não dispara falso positivo por dado que não bate.
Credit engine calibration
O score segue uma distribuição normal (300-1000, média 650) e a renda, uma log-normal com mediana de R$3.500. Rode alguns milhares de clientes e confira se as faixas de aprovação do seu motor fazem sentido.
KYC e onboarding automatizado
CPF válido pela Receita, endereço com UF real, renda dentro do range brasileiro. Ideal pra teste de decisões automáticas de account opening.
Load test de gateway de pagamento
No Dev, o preset vai até 2.000 clientes por chamada, ou um arquivo de 10.000 na página Dados relacionados. Cada um vem com cartão (Luhn), CPF e email próprios. Bom pra encher fila de checkout em teste de stress.
Fixture pra pytest / vitest
Gera 100 clientes uma vez, salva como JSON, reutiliza entre testes. Deterministic (se você seedar) ou fresh a cada run.
Detalhes técnicos que importam
- CPF passa mod-11 da Receita Federal (não é apenas 11 dígitos aleatórios).
- Cartão de crédito passa algoritmo de Luhn (aceito por qualquer gateway de teste).
- Conta bancária usa o código COMPE real de 15 bancos (Nubank, Itaú, Bradesco, Santander, BB, Caixa, Inter, C6, PicPay, PagSeguro e outros).
- Score Serasa segue distribuição normal (Box-Muller) com média 650 e stddev 150, clampado em [300, 1000] — reproduz curva real do brasileiro.
- Renda mensal segue distribuição log-normal com mediana R$3.500 e cauda até R$25k — reflete a realidade da população economicamente ativa.
- PIX keys incluem sempre CPF + email + phone; 60% dos clientes também têm chave aleatória.
💡 Combinação recomendada
Se sua stack é fintech BR, combine o preset fintech (gera clientes válidos) + validate-docbr ou python-brasilidades (valida input de user real no runtime). Uma popula seed, a outra protege a rota de produção.