# Código de Autorização e Código NSU

A partir de 29 de outubro de 2025, os endpoints relacionados a orders, **charges** e subscriptions passam a incluir dois novos campos no payload de resposta em ambiente de Sandbox. Esses mesmos campos entrarão em vigor em ambiente de produção no dia 03 de novembro de 2025:

* **`acquirerAuthorizationCode`**
* **`acquirerAuthorizationNsu`**

Esses campos estarão presentes nas **charges** retornadas pelos seguintes endpoints:

* `/orders`
* `/subscriptions`
* `/charges`

***

### <i class="fa-gear-code">:gear-code:</i> Novos campos adicionados

| Campo                       | Tipo     | Descrição                                                                                                               |
| --------------------------- | -------- | ----------------------------------------------------------------------------------------------------------------------- |
| `acquirerAuthorizationCode` | `string` | Código de autorização **emitido pela adquirente** ou instituição financeira responsável pela transação.                 |
| `acquirerAuthorizationNsu`  | `string` | NSU (**Número Sequencial Único**) **gerado pela adquirente** ou banco, utilizado para rastrear a operação externamente. |

Esses campos permitem **rastreabilidade avançada das transações financeiras**, facilitando processos de conciliação, auditoria e integração com adquirentes e bancos.

***

### <i class="fa-scale-balanced">:scale-balanced:</i> Diferença entre códigos internos e externos

A Barte já disponibiliza os campos `authorizationCode` e `authorizationNsu`, que são **códigos internos de gerenciamento**, utilizados dentro dos sistemas Barte para identificar e vincular transações.

Os novos campos `acquirerAuthorizationCode` e `acquirerAuthorizationNsu` são **códigos externos**, emitidos diretamente pelas **adquirentes** ou **instituições financeiras**, e servem para rastrear as transações em sistemas externos.

| Tipo de código | Campo                                                    | Origem             | Utilização                      |
| -------------- | -------------------------------------------------------- | ------------------ | ------------------------------- |
| Interno        | `authorizationCode` / `authorizationNsu`                 | Barte              | Controle e rastreamento interno |
| Externo        | `acquirerAuthorizationCode` / `acquirerAuthorizationNsu` | Adquirente / Banco | Consulta e conciliação externa  |

***

### <i class="fa-code">:code:</i> Exemplo de payload atualizado

O payload abaixo é o objeto da charge.

```json
{
  "uuid": "f337e5a4-62a3-41af-8449-c9898f1de66b",
  "title": "Teste",
  "expirationDate": "2025-10-14",
  "value": 100,
  "paymentMethod": "CREDIT_CARD_EARLY_SELLER",
  "status": "PAID",
  "customer": {
    "document": "001052647",
    "type": "SSN",
    "name": "Joshua Henry",
    "email": "Heyj5wohn4445@gmail.com",
    "phone": "9409822523"
  },
  "authorizationCode": "7021748",
  "authorizationNsu": "5737396",
  "acquirerAuthorizationCode": "A1B2C3D4",
  "acquirerAuthorizationNsu": "99887766",
  "refunds": [],
  "createdAt": "2025-10-14 22:35:30",
  "paidDate": "2025-10-14",
  "originalValue": 100,
  "installments": 5,
  "brand": "mastercard"
}
```

***

### <i class="fa-thumbtack">:thumbtack:</i> Observação

> A partir de 29 de outubro de 2025, todas as respostas dos endpoints que retornam um ou vários objetos da charge (orders, charges, subscriptions) passarão a conter os campos `acquirerAuthorizationCode` e `acquirerAuthorizationNsu`. Esses dois campos entrarão em vigor em ambiente de produção no dia 03 de novembro de 2025.
>
> Essa atualização não altera os campos internos `authorizationCode` e `authorizationNsu`, que continuarão sendo utilizados para rastreamento dentro dos sistemas Barte.
>
> Nada muda no contrato existente, são apenas campos adicionais (sem breaking change).
>
> Melhora a conciliação, agiliza auditoria/suporte e aumenta a rastreabilidade em interações — especialmente com bancos.
>
> Dica (para quem faz parsing estrito de payloads): se sua aplicação rejeita atributos desconhecidos, ajuste para permitir/ignorar esses dois novos campos.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.barte.com/guias/alteracoes/codigo-de-autorizacao-e-codigo-nsu.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.