Aparência
Troca de e-mail e telefone
O e-mail e o telefone da conta (accounts.email / accounts.phone, que também são valores de chave Pix) e do usuário (users.email, usado no login, e users.phone) só mudam depois de um código de 6 dígitos enviado ao novo contato: por e-mail ou por SMS. Até a confirmação, o contato antigo continua valendo.
PUT /access/account e PUT /access/auth/edit recusam (422) um e-mail ou telefone diferente do atual; aceitam o mesmo valor (com outra máscara ou maiúsculas) e vazio (remover).
Todas as rotas exigem Authorization: Bearer {token} e o header account.
POST /access/contact-changes
Envia o código para o novo contato. Um novo pedido para o mesmo campo substitui o anterior.
Limite: 5 por minuto.
| Campo | Tipo | Obrigatório | Regras |
|---|---|---|---|
scope | string | Sim | account (dados da conta) ou user (seu usuário) |
field | string | Sim | email ou phone |
value | string | Sim | e-mail válido; celular com DDD (com ou sem +55 e máscara) |
pin | string | Se scope=account | PIN da conta |
password | string | Se scope=user | senha atual |
Response 201:
json
{
"message": "Enviamos um código para o novo e-mail.",
"data": {
"id": "9d40a1c2-6b1e-4f7a-8c2d-3e5f6a7b8c9d",
"scope": "account",
"field": "email",
"destination": "no***@exemplo.com",
"expires_at": "2026-10-15T15:10:00-03:00"
}
}Erros (422): PIN ou senha incorretos (errors.pin / errors.password); valor inválido, igual ao atual, e-mail de usuário já em uso ou falha no envio (errors.value).
POST /access/contact-changes/{id}/confirm
Confere o código e grava o novo valor. O código vale 10 minutos: no e-mail tem 4 números, no SMS tem 6. Depois de 3 erros seguidos, cada erro aumenta a espera até a próxima tentativa: 30 s, 1 min, 2 min, 4 min, 8 min e, a partir daí, 15 min. A espera nunca bloqueia de vez e zera quando o código é confirmado. O pedido não é cancelado por erros.
Limite: 10 por minuto.
Body: { "code": "4821" } (e-mail) ou { "code": "123456" } (SMS)
Response 200: { "message": "E-mail atualizado.", "account": { ... } } (conta) ou { "message": "E-mail atualizado.", "user": { "id": 1, "name": "...", "email": "...", "phone": "...", "email_verified_at": "...", "phone_verified_at": "..." } } (usuário). No usuário, o contato confirmado fica marcado como verificado.
Erros: 422 código inválido, expirado ou em período de espera (errors.code, com o tempo restante na mensagem); 404 pedido de outra pessoa ou de outra conta.
POST /access/contact-changes/{id}/resend
Gera e envia um novo código para o mesmo contato, renovando os 10 minutos.
Limite: 3 por minuto.
Response 200: { "message": "Código reenviado.", "data": { ... } }