---
title: "Actualizar Transaction externa"
method: PATCH
path: "/transactions/external"
tags: ["Transactions"]
---

# Actualizar Transaction externa

`PATCH /transactions/external`

## Request

- Base URL: `https://api.trytoku.com`
- URL: `https://api.trytoku.com/transactions/external`
- Auth: API key in header `x-api-key`

Actualiza los datos de una Transaction externa ya registrada.

Se usa para corregir la fecha del pago, el monto informado o las referencias externas de un registro. El identificador va en el parámetro de consulta `id_transaction` y solo se aplican los campos enviados en el cuerpo.

Responde `404` cuando la Transaction no existe o no es una Transaction externa.

**Límite de tasa:** 20 solicitudes por segundo. Al superarlo, la API responde `429`. Ver [Límites de tasa](/reference/limites-de-tasa).

## Query parameters

- `id_transaction` string, required: Identificador de la Transaction externa sobre la que se aplica la operación.

## Headers

- `x-account-key` string

## Request body

- UpdateExternalTransactionRequest: Campos editables de una Transaction externa ya registrada.
  - `external_id` string: Nueva referencia externa que la Organization asigna a la Transaction.
  - `payment_method_detail` string: Nuevo detalle del medio con que se pagó.
  - `provider_external_id` string: Nueva referencia que el proveedor del pago asigna a la Transaction.
  - `reported_amount` number: Monto que la Organization reporta para el pago.
  - `transaction_date` string, date-time: Nueva fecha del pago registrado.

## Response `200`

La Transaction externa quedó actualizada.

- AcknowledgeResponse: Confirmación sin datos adicionales de que la operación se ejecutó.
  - `detail` string: Mensaje complementario de la operación; `null` cuando no hay mensaje.
  - `success` boolean, required: Indica si la operación se completó.

## Other responses

- `401`: Faltan las credenciales o son inválidas.
- `403`: No tienes acceso a este recurso.
- `404`: La Transaction no existe o no es una Transaction externa.
- `422`: El cuerpo de la petición no pasó la validación.
- `429`: Se superó el límite de peticiones permitidas.

## Changes

- **2026-11-03** `a6ef070075b1`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/trytoku/apis/toku-api/changes/transactions/external/patch.md)

---

[API](https://skmtc.dev/trytoku/apis/toku-api.md) - [All operations](https://skmtc.dev/trytoku/apis/toku-api/llms.txt) - [OpenAPI document](https://skmtc.dev/trytoku/apis/toku-api/revisions/a6ef070075b1?raw)