---
title: "Eliminar Payments desde un proceso interno"
method: PUT
path: "/delete-payments"
tags: ["Payments"]
deprecated: true
---

# Eliminar Payments desde un proceso interno

`PUT /delete-payments`

## Request

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

> **Deprecated.**

Elimina pagos registrados sobre Invoices desde un proceso interno de Toku.

Aplica exactamente la misma lógica que la eliminación de Payments; existe como ruta aparte para que los procesos internos que la ejecutan en segundo plano tengan un destino propio. Los integradores externos deben usar `DELETE /payments`.

Que algunos elementos del lote fallen no convierte la respuesta en un error: se devuelve `200` con el recuento por resultado. Revisa esos contadores para saber qué pasó con cada Payment enviado.

## Headers

- `x-account-key` string

## Request body

- DeletePaymentsPayload: Lote de Payments a eliminar.
  - `id_account` string: Account bajo la cual se eliminan los Payments.
  - `payments` PaymentBase[], required: Payments a procesar, identificados por el Invoice que saldan.
    - `due_date` string: Identificador del periodo adeudado. Es texto libre, no necesariamente una fecha, y es obligatorio cuando no envías `invoice_external_id`.
    - `invoice_external_id` string: Identificador del Invoice que salda el Payment. Si lo omites, se construye como `{product_id}-{due_date}`.
    - `product_id` string: Identificador con el que reconoces el producto o servicio adeudado. Es obligatorio cuando no envías `invoice_external_id`.
  - `set_invoices_as_unpaid` boolean: Si es `true`, los Invoices de los Payments eliminados vuelven a quedar impagos. Si es `false`, se elimina el Payment y el Invoice mantiene su estado.

## Response `200`

Recuento por resultado del lote.

- DeletePaymentsResponse: Resultado de un lote de eliminación de Payments.
  - `duplicates` integer: Payments repetidos dentro del mismo lote. Se procesa la primera aparición y las siguientes se descartan.
  - `error` integer: Payments que no pudieron procesarse por un error de negocio.
  - `format_error` integer: Payments rechazados por el formato de los datos enviados.
  - `not_found` integer: Payments cuyo Invoice no existe o no está disponible.
  - `success` integer: Payments procesados correctamente.

## Other responses

- `401`: Faltan las credenciales o son inválidas.
- `403`: Las credenciales no tienen acceso a este recurso.
- `404`: El recurso solicitado no existe.
- `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.

## Changes

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

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