Links de cobro

Listar links de cobro

Lista los links del comercio (más recientes primero). Los filtros se combinan (todos deben cumplirse); pagina con limit/offset. Fechas sobre la del pago o, si no se pagó, la de creación: [desde, hasta). Un valor inválido en desde, hasta, min, max, con_propina, mode u origen responde 400 con parametro; un estado desconocido se ignora.

get/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

Query parameters

estadostring
Example:pagado,procesando

Uno o varios separados por coma: pendiente, cobrando, procesando, revision, pagado, expirado, cancelado. Un enlace pendiente cuyo expires_at ya pasó cuenta como expirado.

desdestring
Example:2026-10-08T04:00:00Z

ISO 8601 o epoch en milisegundos (incluido).

hastastring
Example:2026-10-09T04:00:00Z

ISO 8601 o epoch en milisegundos (excluido).

qstring

Busca en concepto, nombre de quien pagó, referencia bancaria del pago, id y codigo_verificacion. Cada palabra debe aparecer.

minnumber

Monto mínimo del enlace en Bs (incluido, sin propina).

maxnumber

Monto máximo del enlace en Bs (incluido, sin propina).

con_propinaboolean
mode'test' | 'live'
origen'api' | 'panel' | 'mi_pagina' | 'boton' | 'whatsapp'
limitinteger
offsetinteger

Response

Links del comercio

idstring
urlstring
comerciostring
montonumber
monedastring
conceptostring nullable
estado'pendiente' | 'cobrando' | 'procesando' | 'revision' | 'pagado' | 'expirado' | 'cancelado'
expires_atstring date-time nullable
txn_idstring nullable

id de la transacción que pagó el link (si estado=pagado)

created_atstring date-time
paid_atstring date-time nullable
propinanumber

Propina que agregó quien pagó (Bs; 0 si no agregó). monto no la incluye.

totalnumber

Lo debitado: monto + propina.

codigo_verificacionstring nullable

Código del comprobante (sólo si estado=pagado). Se verifica en /verificar.

Example response

[
  {
    "total": 450,
    "codigo_verificacion": "QP-7K3M9-XQ4TA"
  }
]

Changes

No recorded changes to this operation across all 1 revision of this API.