# Atualiza pagamento

`PATCH` `/payments/{id}`

Atualiza um pagamento existente através do ID

## Parâmetros

- **id** (`string`, obrigatório) — ID do pagamento previamente enviado ou gerado na criação.

## Corpo da requisição

- **payment** (`object`, obrigatório)
  - **status** (`string enum`, obrigatório) — Status final do pagamento. Consulte a [documentação para mais detalhes sobre os status possíveis](https://docs.glassdata.io/pt/transactional/payment_modeling/status/).
    - Allowed: `succeeded`, `declined`, `failed`, `blocked`
  - **method** (`object`) — Método de pagamento. Utilizar este parâmetro apenas quando for necessário complementar dados que não puderam ser transmitidos na criação.
    - **type** (`string`) — Tipo do método de pagamento.
    - **card** (`object`)
      - **network** (`string enum`, obrigatório) — Bandeira
        - Allowed: `visa`, `mastercard`, `american_express`, `diners_club`, `elo`, `hipercard`, `jcb`, `discover`, `other`
      - **presence** (`string enum`, obrigatório) — Indica se a transação foi realizada com cartão presente (CP) ou cartão não presente (CNP). Consulte a [documentação sobre presença de cartões](https://docs.glassdata.io/pt/api/methods/post_payments/) para mais informações.
        - Allowed: `card_present`, `card_not_present`
      - **bin** (`string | null`) — Primeiros 8 números do PAN que identificam o emissor do cartão (conhecido também como IIN)
      - **last_four** (`string | null`) — Últimos 4 números do PAN
  - **transactions** (`array`) — Lista com as tentativas de transação para este pagamento. Obrigatório se o `status` do pagamento for `succeeded` ou `declined`. Recomendável para `failed` e `blocked` se houverem tentativas de transação.
    - **id** (`string`) — Código identificador único da transação. Consulte a [documentação para mais detalhes sobre o código da transação](https://docs.glassdata.io/pt/transactional/payment_modeling/identifiers/).
    - **status** (`string enum`, obrigatório) — Status de retorno da tentativa de transação. Consulte a [documentação para mais detalhes sobre os status possíveis](https://docs.glassdata.io/pt/transactional/payment_modeling/status/).
      - Allowed: `succeeded`, `declined`, `failed`, `canceled`
    - **duration** (`integer`) — Tempo de execução da transação em milissegundos (1 segundo = 1000 milissegundos).
    - **timestamp** (`date-time | null`) — Data e hora em que a transação foi iniciada no formato [ISO 8601](https://pt.wikipedia.org/wiki/ISO_8601). Se não for enviado, o horário atual será usado. O prazo máximo para envio retroativo (backfill) é 24 horas. Horários no futuro não são permitidos.
    - **connector** (`object`, obrigatório) — Informações sobre o conector de pagamento utilizado na transação. O conector pode ser uma adquirente, um subadquirente ou um gateway.
      - **id** (`string`, obrigatório) — Código da integração com o conector. Informe um código que represente um contrato de filiação ou uma conexão de integração específica. Recomendamos prefixar o código com o tipo do conector para facilitar consultas em relatórios.
      - **type** (`string`) — Tipo do conector (ex.: adquirente, subadquirente ou gateway). Campo opcional e de texto livre; recomendamos um valor padronizado para facilitar consultas em relatórios.
      - **response_code** (`string | null`) — Código de resposta alfanumérico da tentativa. Para cartão de crédito no Brasil, utilizar preferencialmente o padrão determinado pela [normativa 21 da ABECS](https://api.abecs.org.br/wp-content/uploads/2019/09/Normativo-021.pdf). Obrigatório se `transaction.status` for `succeeded` ou `declined`. Recomendável para `failed` e `canceled` quando presente.

```json
{
  "payment": {
    "status": "succeeded",
    "method": {
      "type": "string",
      "card": {
        "network": "visa",
        "presence": "card_present",
        "bin": "40000000",
        "last_four": "1234"
      }
    },
    "transactions": [
      {
        "id": "string",
        "status": "succeeded",
        "duration": 0,
        "timestamp": "2024-01-01T00:00:00Z",
        "connector": {
          "id": "cielo-39123747819782",
          "type": "cielo",
          "response_code": "00"
        }
      }
    ]
  }
}
```

## Respostas

### 200 — Pagamento atualizado com sucesso

### 401 — Credenciais de acesso inválidas

- **errors** (`array`)
  - **field** (`string`) — Campo da requisição onde ocorreu o erro
  - **type** (`string`) — Código do tipo do erro
  - **message** (`string`) — Mensagem do erro

```json
{
  "errors": [
    {
      "field": "string",
      "type": "string",
      "message": "string"
    }
  ]
}
```

### 422 — Parâmetros inválidos

- **errors** (`array`)
  - **field** (`string`) — Campo da requisição onde ocorreu o erro
  - **type** (`string`) — Código do tipo do erro
  - **message** (`string`) — Mensagem do erro

```json
{
  "errors": [
    {
      "field": "string",
      "type": "string",
      "message": "string"
    }
  ]
}
```

### 404 — Objeto não encontrado

- **errors** (`array`)
  - **field** (`string`) — Campo da requisição onde ocorreu o erro
  - **type** (`string`) — Código do tipo do erro
  - **message** (`string`) — Mensagem do erro

```json
{
  "errors": [
    {
      "field": "string",
      "type": "string",
      "message": "string"
    }
  ]
}
```