# Mobile - Verificar PIN 2FA no registro

`POST /instance/mobile/two-factor`

Pasta: **Instancia**

## Autenticação

```http
token: {{token}}
```

## Descrição

# Verificar PIN 2FA no registro

Conclui o registro mobile quando a conta exige o PIN de verificação em duas etapas.

Use o **mesmo** `code` do SMS/OTP original + o PIN de 6 dígitos da conta.

## Endpoint

```http
POST {{baseUrl}}/instance/mobile/two-factor
```

## Autenticação

Header da instância:

```http
token: {{token}}
```

## Corpo da requisição

| Campo | Tipo | Obrigatório | Descrição |
| --- | --- | --- | --- |
| `code` | string | Sim | Código original da verificação (SMS/call/otp). |
| `pin` | string | Sim | PIN 2FA de 6 dígitos da conta. |
| `phone` | string | Não | Número com DDI; padrão = `owner`. |

## Exemplo de Requisição

```bash
curl -X POST "{{baseUrl}}/instance/mobile/two-factor" \
  -H "token: {{token}}" \
  -H "Content-Type: application/json" \
  -d '{
  "code": "123456",
  "pin": "654321",
  "phone": "5511999999999"
}'
```

## Resposta de Sucesso

```json
{
  "success": true,
  "message": "Verificacao 2FA concluida. Conta vinculada e conectada.",
  "instance": {
    "status": "connected",
    "verification_state": "verified",
    "connection_mode": "mobile"
  },
  "runtime": {
    "present": true,
    "connected": true,
    "logged_in": true
  }
}
```

## Erros comuns

- `400` — `code`/`pin` ausente ou modo não-mobile
- `409` — PIN inválido / tentativas esgotadas / wipe necessário
- `503` — mobile bridge indisponível

## Observações

Resposta HTTP `202 Accepted`. Diferente de `POST /instance/account/2fa` (gerência do PIN na conta já logada).

## Corpo (exemplo)

```json
{
  "code": "123456",
  "pin": "654321",
  "phone": "5511999999999"
}
```

## cURL

```bash
curl -X POST "{{baseUrl}}/instance/mobile/two-factor" \
  -H "token: {{token}}" \
  -H "Content-Type: application/json" \
  -d '{
  "code": "123456",
  "pin": "654321",
  "phone": "5511999999999"
}'
```

---

[Índice da pasta](./index.md) · [Índice geral](../index.md) · [UI](https://gozap.dev/docs?op=instancia/mobile-verificar-pin-2fa-no-registro)