---
title: "Cancelar un link de cobro"
method: POST
path: "/switch/v1/links/{id}/cancelar"
tags: ["Links de cobro"]
---

# Cancelar un link de cobro

`POST /switch/v1/links/{id}/cancelar`

## Request

- Base URL: `https://pay.pagaconquickpay.com`
- URL: `https://pay.pagaconquickpay.com/switch/v1/links/{id}/cancelar`
- Auth: API key in header `x-switch-key`

Cancela el link SOLO si sigue `pendiente` (atómico). Si alguien ya está pagando (`cobrando`/`procesando`/`revision`) o ya pagó, responde 409 `no_cancelable` y no toca nada. Tenant-scoped.

## Path parameters

- `id` string, required

## Response `200`

`{ id, estado: "cancelado" }`

- Cancelado (unresolved $ref)

## Other responses

- `401`: No autorizado
- `404`: No encontrado
- `409`: `no_cancelable`: el link ya no está pendiente (incluye su `estado`)

---

[API](https://skmtc.dev/pagaconquickpay/apis/quickpay-api.md) · [All operations](https://skmtc.dev/pagaconquickpay/apis/quickpay-api/llms.txt) · [OpenAPI document](https://skmtc.dev/pagaconquickpay/apis/quickpay-api/revisions/999597fa67f3?raw)