# Actualizar pago

`PATCH` `/payments/{id}`

Actualiza un pago existente a través del ID

## Parámetros

- **id** (`string`, required) — ID del pago previamente enviado o generado en la creación.

## Cuerpo de la solicitud

- **payment** (`object`, required)
  - **status** (`string enum`, required) — Estado final del pago. Consulte la [documentación para más detalles sobre los estados posibles](https://docs.glassdata.io/es/transactional/payment_modeling/status/).
    - Allowed: `succeeded`, `declined`, `failed`, `blocked`
  - **method** (`object`) — Método de pago. Utilizar este parámetro solo cuando sea necesario complementar datos que no pudieron ser transmitidos en la creación.
    - **type** (`string`) — Tipo del método de pago.
    - **card** (`object`)
      - **network** (`string enum`, required) — Red de tarjeta
        - Allowed: `visa`, `mastercard`, `american_express`, `diners_club`, `elo`, `hipercard`, `jcb`, `discover`, `other`
      - **presence** (`string enum`, required) — Indica si la transacción fue realizada con tarjeta presente (CP) o tarjeta no presente (CNP). Consulte la [documentación sobre presencia de tarjetas](https://docs.glassdata.io/es/api/methods/post_payments/) para más información.
        - Allowed: `card_present`, `card_not_present`
      - **bin** (`string | null`) — Primeros 8 números del PAN que identifican al emisor de la tarjeta (conocido también como IIN)
      - **last_four** (`string | null`) — Últimos 4 números del PAN
  - **transactions** (`array`) — Lista de intentos de transacción para este pago. Obligatorio si el `status` del pago es `succeeded` o `declined`. Recomendable para `failed` y `blocked` si hay intentos de transacción.
    - **id** (`string`) — Código identificador único de la transacción. Consulte la [documentación para más detalles sobre el código de la transacción](https://docs.glassdata.io/es/transactional/payment_modeling/identifiers/).
    - **status** (`string enum`, required) — Estado de retorno del intento de transacción. Consulte la [documentación para más detalles sobre los estados posibles](https://docs.glassdata.io/es/transactional/payment_modeling/status/).
      - Allowed: `succeeded`, `declined`, `failed`, `canceled`
    - **duration** (`integer`) — Tiempo de ejecución de la transacción en milisegundos (1 segundo = 1000 milisegundos).
    - **timestamp** (`date-time | null`) — Fecha y hora en que se inició la transacción en formato [ISO 8601](https://es.wikipedia.org/wiki/ISO_8601). Si no se envía, se usará la hora actual. El plazo máximo para envío retroactivo (backfill) es de 24 horas. No se permiten horarios futuros.
    - **connector** (`object`, required) — Información sobre el conector de pago utilizado en la transacción. El conector puede ser un adquirente, un subadquirente o un gateway.
      - **id** (`string`, required) — Código de la integración con el conector. Informe un código que represente un contrato de afiliación o una conexión de integración específica. Recomendamos prefijar el código con el tipo del conector para facilitar consultas en reportes.
      - **type** (`string`) — Tipo del conector (ej.: adquirente, subadquirente o gateway). Campo opcional y de texto libre; recomendamos un valor estandarizado para facilitar consultas en reportes.
      - **response_code** (`string | null`) — Código de respuesta alfanumérico del intento. Para tarjeta de crédito en Brasil, utilizar preferentemente el estándar determinado por la [normativa 21 de ABECS](https://api.abecs.org.br/wp-content/uploads/2019/09/Normativo-021.pdf). Obligatorio si `transaction.status` es `succeeded` o `declined`. Recomendable para `failed` y `canceled` cuando está 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"
        }
      }
    ]
  }
}
```

## Respuestas

### 200 — Pago actualizado con éxito

### 401 — Credenciales de acceso inválidas

- **errors** (`array`)
  - **field** (`string`) — Campo de la solicitud donde ocurrió el error
  - **type** (`string`) — Código del tipo del error
  - **message** (`string`) — Mensaje del error

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

### 422 — Parámetros inválidos

- **errors** (`array`)
  - **field** (`string`) — Campo de la solicitud donde ocurrió el error
  - **type** (`string`) — Código del tipo del error
  - **message** (`string`) — Mensaje del error

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

### 404 — Objeto no encontrado

- **errors** (`array`)
  - **field** (`string`) — Campo de la solicitud donde ocurrió el error
  - **type** (`string`) — Código del tipo del error
  - **message** (`string`) — Mensaje del error

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