---
title: "Eliminar Payment Method"
method: DELETE
path: "/payment-methods"
tags: ["Payment Methods"]
---

# Eliminar Payment Method

`DELETE /payment-methods`

## Request

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

Elimina un Payment Method para que deje de usarse en cobros.

La eliminación es lógica: el Payment Method queda con estado `deleted` y con su fecha de eliminación, y se conserva para el historial. Si ya estaba eliminado, la petición no tiene efecto.

## Query parameters

- `id_payment_method` string, required: Id del Payment Method a eliminar.
- `force_status_change` boolean: Si es `true`, se fuerza el paso a estado eliminado incluso cuando la transición no está permitida desde el estado actual.

## Response `200`

Successful Response

- ApiPaymentMethodBaseResponse: Confirmación genérica de una operación sobre un Payment Method.
  - `detail` union: Detalle de la operación. Trae los identificadores generados cuando la operación creó algo, un mensaje cuando quedó agendada para procesarse de forma asíncrona, y el motivo del rechazo cuando `success` es `false`.
    - object
    - string
  - `success` boolean, required: Es `true` cuando la operación se ejecutó sin errores.

## Other responses

- `400`: El Payment Method no puede pasar a eliminado desde su estado actual. Se puede forzar con `force_status_change`.
- `401`: Faltan las credenciales o son inválidas.
- `403`: No tienes 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.

## Changes

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

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