Links de cobro

Crear link de cobro

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.

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

Request body

montonumber required

Monto a cobrar (bruto que ve el pagador)

monedastring

ISO-4217

conceptostring required
expira_horasinteger

TTL en horas (default 24h). Ignorado si envías expira_en.

expira_enstring date-time

Fecha/hora ISO-8601 de expiración (gana sobre expira_horas). Debe ser futura.

success_urlstring

https://. A dónde vuelve el pagador al pagar (con estado y referencia).

failure_urlstring

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

Link creado

idstring
urlstring

URL del hosted checkout para compartir con el pagador

montonumber
monedastring
conceptostring
estado'pendiente'
expires_atstring date-time
mode'test' | 'live'

Changes

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