---
title: "Modificar Payment"
method: PUT
path: "/payments"
tags: ["Payments"]
deprecated: true
---

# Modificar Payment

`PUT /payments`

## Request

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

> **Deprecated.**

Modifica los datos de un pago ya registrado sobre un Invoice.

Se usa para corregir el monto, la fecha o el medio de pago de un Payment informado antes. El Payment se identifica por el Invoice que salda, y ese Invoice debe tener un pago registrado: si no lo tiene, la llamada responde `404`.

El monto no se puede modificar cuando el Invoice ya tiene un comprobante emitido; en ese caso la llamada responde `400`. Los demás campos sí se pueden corregir.

## Headers

- `x-account-key` string

## Request body

- Payment: Pago ya realizado sobre un Invoice: cuánto se pagó, cuándo y por qué medio. Un Payment puede ser un cobro procesado por Toku o un pago que el deudor hizo por fuera (transferencia, caja, efectivo) y que se registra para dejar el Invoice como pagado. Un Payment no se referencia por un identificador propio, sino por el Invoice que salda: con `invoice_external_id`, o con `product_id` y `due_date`, que juntos lo componen. Los campos enviados como texto vacío se tratan como ausentes.
  - `buy_order` string: Identificador del documento que respalda el pago en tu sistema, por ejemplo el número de la orden o del comprobante.
  - `due_date` string: Identificador del periodo adeudado. Es texto libre, no necesariamente una fecha, y es obligatorio cuando no envías `invoice_external_id`.
  - `id_payment_intent` string: Identificador del cobro de Toku que originó el pago. Si lo envías, el Invoice se determina a partir de ese cobro y no de `product_id` / `due_date`, y debe corresponder a un cobro autorizado.
  - `id_receipt` integer: Identificador del comprobante asociado al pago, cuando corresponde.
  - `invoice_external_id` string: Identificador del Invoice que salda el Payment. Si lo omites, se construye como `{product_id}-{due_date}`.
  - `payment_amount` number: Monto pagado del Invoice. No puede ser negativo.
  - `payment_date` union: Fecha en que se realizó el pago, en formato [ISO 8601](https://www.w3.org/TR/NOTE-datetime). Acepta solo la fecha (`2020-08-26`) o fecha y hora (`2020-08-26T12:06:34Z`); si envías solo la fecha, se toma a las 00:00. Si lo omites al registrar el pago, se usa el momento en que Toku recibe la solicitud.
    - string, date
    - string, date-time
  - `payment_method` string: Medio de pago con el que se pagó, como texto libre.
  - `product_id` string: Identificador con el que reconoces el producto o servicio adeudado. Es obligatorio cuando no envías `invoice_external_id`.

## Response `200`

El Payment fue modificado.

- ApiPaymentMessage: Respuesta predeterminada que entrega feedback al respecto de cómo resultó la request.
  - `message` string, required

## Other responses

- `400`: El `id_payment_intent` enviado no corresponde a un cobro autorizado, o se intentó modificar el monto de un Payment cuyo Invoice ya tiene un comprobante emitido.
- `401`: Faltan las credenciales o son inválidas.
- `403`: Las credenciales no tienen acceso a este recurso.
- `404`: No existe un Invoice que coincida con los identificadores enviados, o ese Invoice no tiene un pago registrado.
- `422`: El cuerpo de la petición no pasó la validación.
- `429`: Se superó el límite de peticiones permitidas. Reintenta más tarde.
- `500`: La modificación no pudo completarse.

## Changes

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

[Operation history](https://skmtc.dev/trytoku/apis/toku-api/changes/payments/put.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)