---
title: "Crear link de cobro"
method: POST
path: "/switch/v1/links"
tags: ["Links de cobro"]
---

# Crear link de cobro

`POST /switch/v1/links`

## Request

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

Genera un enlace de pago alojado (hosted checkout) para que una persona pague el monto indicado. No mueve dinero al crearse. El pagador abre la `url`, ingresa su instrumento (banco, teléfono/cuenta, cédula) y paga con OTP en una página servida por QuickPay — **sin exponer tu API key**. Expira a las 24h por defecto (configurable con `expira_horas` o `expira_en`). El cobro es **money-safe: el link se paga EXACTAMENTE UNA VEZ** (reintentos no doble-debitan). Suscríbete al evento `link.pagado` para enterarte al instante.

## Request body

- LinkCobroRequest
  - `monto` number, required: Monto a cobrar (bruto que ve el pagador)
  - `moneda` string: ISO-4217
  - `concepto` string, required
  - `expira_horas` integer: TTL en horas (default 24h). Ignorado si envías `expira_en`.
  - `expira_en` string, date-time: Fecha/hora ISO-8601 de expiración (gana sobre `expira_horas`). Debe ser futura.
  - `success_url` string: https://. A dónde vuelve el pagador al pagar (con `estado` y `referencia`).
  - `failure_url` string: https://. A dónde vuelve el pagador si el pago no puede continuar: el link venció (`estado=expirado`), lo cancelaste (`cancelado`) o el pagador elige "Cancelar y volver" tras un rechazo (`rechazado`).

## Response `201`

Link creado

- LinkCreado
  - `id` string
  - `url` string: URL del hosted checkout para compartir con el pagador
  - `monto` number
  - `moneda` string
  - `concepto` string
  - `estado` 'pendiente'
  - `expires_at` string, date-time
  - `mode` 'test' | 'live'

## Other responses

- `400`: Validación
- `401`: No autorizado
- `403`: Comercio suspendido (`comercio_suspendido`)

---

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