Skip to content

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.

CampoTipoObrigatórioRegras
scopestringSimaccount (dados da conta) ou user (seu usuário)
fieldstringSimemail ou phone
valuestringSime-mail válido; celular com DDD (com ou sem +55 e máscara)
pinstringSe scope=accountPIN da conta
passwordstringSe scope=usersenha 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": { ... } }