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

# Estado de un link de cobro

`GET /switch/v1/links/{id}`

## Request

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

Devuelve el estado actual de un link (`pendiente`/`pagado`/`expirado`/`cancelado`) y, si fue pagado, el `txn_id` de la transacción que lo liquidó. Tenant-scoped: solo devuelve links del comercio autenticado.

## Path parameters

- `id` string, required

## Response `200`

Estado del link

- Link
  - `id` string
  - `url` string
  - `comercio` string
  - `monto` number
  - `moneda` string
  - `concepto` string, nullable
  - `estado` 'pendiente' | 'cobrando' | 'procesando' | 'revision' | 'pagado' | 'expirado' | 'cancelado'
  - `expires_at` string, date-time, nullable
  - `txn_id` string, nullable: id de la transacción que pagó el link (si estado=pagado)
  - `created_at` string, date-time
  - `paid_at` string, date-time, nullable
  - `propina` number: Propina que agregó quien pagó (Bs; 0 si no agregó). `monto` no la incluye.
  - `total` number: Lo debitado: monto + propina.
  - `codigo_verificacion` string, nullable: Código del comprobante (sólo si estado=pagado). Se verifica en /verificar.
  - `pagador` object: Lo que se sabe de quien pagó. No trae cédula, teléfono ni nombre.
    - `alta_cliente` boolean: true si quien paga marcó "Quiero ser cliente de <comercio> y recibir sus novedades" en la página de pago.

## Other responses

- `401`: No autorizado
- `404`: No encontrado

---

[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)