TRtrytoku
Transactions

Actualizar Transaction externa

Changed on

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.

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

Query parameters

id_transactionstring required

Identificador de la Transaction externa sobre la que se aplica la operación.

Headers

x-account-keystring

Llave de API de una Account, para operar sobre esa Account en lugar de la principal.

Request body

external_idstring

Nueva referencia externa que la Organization asigna a la Transaction.

payment_method_detailstring

Nuevo detalle del medio con que se pagó.

provider_external_idstring

Nueva referencia que el proveedor del pago asigna a la Transaction.

reported_amountnumber

Monto que la Organization reporta para el pago.

transaction_datestring date-time

Nueva fecha del pago registrado.

Example request

{
  "external_id": "pago-caja-4821",
  "payment_method_detail": "transferencia",
  "reported_amount": 15990,
  "transaction_date": "2026-07-21T09:10:00"
}

Response

La Transaction externa quedó actualizada.

detailstring

Mensaje complementario de la operación; null cuando no hay mensaje.

successboolean required

Indica si la operación se completó.

Example response

{
  "success": true
}

Changes