# Definir chave padrão (/docs/conta-digital/endpoints/pix-keys/put_pix_key_default)

## PUT /transactions/pix-keys/{pixKeyId}/default

`PUT https://api.hub.payzu.com.br/api/v1/transactions/pix-keys/{pixKeyId}/default`

Escopo: `PIX_KEY_WRITE`. Troca a chave padrão da conta pela chave indicada. A chave padrão é a que recebe cobrança e a que identifica a sua conta nas transferências que você envia. Para receber transferência, vale qualquer chave `ACTIVE`. Só chave `ACTIVE` pode virar padrão.

### Path params

| Field | Type | Required | Details |
| --- | --- | --- | --- |
| `pixKeyId` | string | yes | Identificador da chave (`id`), não o valor dela. |

### Responses

**200** A chave, agora padrão.

| Field | Type | Required | Details |
| --- | --- | --- | --- |
| `id` | string | yes | Identificador da chave. É o que vai nas rotas de apagar e de definir a padrão. |
| `key` | string | yes | Valor da chave, inteiro. |
| `type` | string | yes | Tipo da chave. — `EVP`, `CNPJ`, `CPF`, `EMAIL`, `PHONE` |
| `status` | string | yes | Estado da chave. — `PENDING`, `ACTIVE`, `REMOVED` |
| `isDefault` | boolean | yes | Se é a chave padrão da conta. |
| `createdAt` | string | yes | Data e hora em ISO 8601, UTC. — format: date-time |
| `updatedAt` | string | yes | Data e hora em ISO 8601, UTC. — format: date-time |

**401** Credencial ausente, inválida ou expirada.

| Field | Type | Required | Details |
| --- | --- | --- | --- |
| `message` | string | yes | Descrição em português, pronta para exibir. Pode mudar a qualquer momento. |
| `code` | string | yes | Código estável do erro. É por ele que o seu sistema decide o que fazer. |
| `details` | object | no | Contexto estruturado do erro, quando existe. |

**403** Sem permissão: escopo, IP ou operação desabilitada.

| Field | Type | Required | Details |
| --- | --- | --- | --- |
| `message` | string | yes | Descrição em português, pronta para exibir. Pode mudar a qualquer momento. |
| `code` | string | yes | Código estável do erro. É por ele que o seu sistema decide o que fazer. |
| `details` | object | no | Contexto estruturado do erro, quando existe. |

**404** Não encontrado, ou de outra conta.

| Field | Type | Required | Details |
| --- | --- | --- | --- |
| `message` | string | yes | Descrição em português, pronta para exibir. Pode mudar a qualquer momento. |
| `code` | string | yes | Código estável do erro. É por ele que o seu sistema decide o que fazer. |
| `details` | object | no | Contexto estruturado do erro, quando existe. |

**412** Falta um passo antes desta operação.

| Field | Type | Required | Details |
| --- | --- | --- | --- |
| `message` | string | yes | Descrição em português, pronta para exibir. Pode mudar a qualquer momento. |
| `code` | string | yes | Código estável do erro. É por ele que o seu sistema decide o que fazer. |
| `details` | object | no | Contexto estruturado do erro, quando existe. |

**422** Recusa de regra de negócio.

| Field | Type | Required | Details |
| --- | --- | --- | --- |
| `message` | string | yes | Descrição em português, pronta para exibir. Pode mudar a qualquer momento. |
| `code` | string | yes | Código estável do erro. É por ele que o seu sistema decide o que fazer. |
| `details` | object | no | Contexto estruturado do erro, quando existe. |

**502** O banco não respondeu ou recusou.

| Field | Type | Required | Details |
| --- | --- | --- | --- |
| `message` | string | yes | Descrição em português, pronta para exibir. Pode mudar a qualquer momento. |
| `code` | string | yes | Código estável do erro. É por ele que o seu sistema decide o que fazer. |
| `details` | object | no | Contexto estruturado do erro, quando existe. |