# Ler Pix copia e cola (/docs/conta-digital/endpoints/pix/post_pix_decode)

## POST /transactions/pix/decode

`POST https://api.hub.payzu.com.br/api/v1/transactions/pix/decode`

Escopo: `PIX_DICT_READ`. Extrai os dados de um Pix copia e cola, como chave e valor, sem consultar o banco. Não conta no limite de requisições, não diz quem é o titular e não paga nada. No código dinâmico, `pixKey` vem `null` e só `url` é preenchida.

### Body params

| Field | Type | Required | Details |
| --- | --- | --- | --- |
| `brCode` | string | yes | Pix copia e cola. — minLength: 8; maxLength: 1024 |

### Responses

**200** Código lido.

| Field | Type | Required | Details |
| --- | --- | --- | --- |
| `pixKey` | string | null | yes | Chave Pix que o código carrega, inteira. `null` em código dinâmico. |
| `url` | string | null | yes | Endereço com os dados do código dinâmico. `null` no estático. |
| `amount` | integer | null | yes | Valor fixado no código. `null` quando o pagador escolhe. Em centavos. |
| `merchantName` | string | null | yes | Nome escrito por quem gerou o código. Não é verificado. |
| `merchantCity` | string | null | yes | Cidade escrita por quem gerou o código. Não é verificada. |
| `txid` | string | null | yes | Identificador que o destinatário pôs no código. |
| `isDynamic` | boolean | yes | `true` quando o código é de uso único. |
| `isAmountFixed` | boolean | yes | `true` quando `amount` não é `null`. |

**400** Requisição inválida.

| 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. |

**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. |