Referencia · Entornos y URLs
Docs · Referencia Descargar .md

Entornos y URLs

URLs

APIhttps://eplaza-qa-pay.pagaconquickpay.com/switch/v1
Página de pago de un cobrohttps://eplaza-qa-pay.pagaconquickpay.com/l/<id>
Referencia completa (OpenAPI)eplaza-qa-docs.pagaconquickpay.com/docs · openapi.json

Prueba y producción usan las mismas URLs: el modo lo decide la llave (sk_test_ o sk_live_). → Llaves y entornos

Endpoints para comercios

Todos con x-switch-key: <tu-comercio>:<llave>.

MétodoRutaPara
POST/linksCrear un enlace de pago
GET/linksListar tus enlaces
GET/links/:idConsultar un enlace
POST/links/:id/cancelarCancelar un enlace que sigue pendiente
POST/links/:id/simularForzar el resultado de un enlace de prueba (pagado, rechazado o expirado); sólo con llave sk_test_
POST/lotesCrear hasta 500 enlaces
GET/lotesListar tus lotes
GET/lotes/:idConsultar un lote y cada enlace
POST/lotes/:id/cancelarCancelar los enlaces pendientes de un lote
GET · POST/webhooksListar o registrar webhooks
GET · PATCH · DELETE/webhooks/:idVer, cambiar (url, eventos, estado) o borrar un webhook
GET/webhooks/:id/deliveriesÚltimas entregas de un webhook
GET · POST/api-keysListar o crear llaves
POST/api-keys/:id/revokeRevocar una llave
GET/estadisticasTus estadísticas de cobro por día (hora de Venezuela): cobros pagados, volumen, ticket promedio, comisión, neto y tasa de éxito. → Estadísticas

Las llaves y los webhooks también se manejan desde el portal, en Integraciones.

Estadísticas

GET /switch/v1/estadisticas?desde=AAAA-MM-DD&hasta=AAAA-MM-DD devuelve las cifras de tus cobros en ese rango de días, en hora de Venezuela y con los dos días incluidos. Son las mismas que ves en el portal › Estadísticas: cuentan los enlaces pagados por el día en que se pagaron. Sin desde ni hasta, son los últimos 30 días contando hoy. El rango máximo es de 366 días. Con una llave de prueba sólo cuentan tus cobros de prueba; con una de producción, sólo los reales.

bash
curl "https://eplaza-qa-pay.pagaconquickpay.com/switch/v1/estadisticas?desde=2026-10-13&hasta=2026-10-14" \
  -H "x-switch-key: tu-comercio:sk_test_..."
json
{
  "desde": "2026-10-13",
  "hasta": "2026-10-14",
  "mode": "test",
  "moneda": "VES",
  "cobros_pagados": 20,
  "volumen": 20,
  "propinas": 0,
  "ticket_promedio": 1,
  "comision": 0.2,
  "neto": 19.8,
  "intentos_aprobados": 20,
  "intentos_rechazados": 0,
  "tasa_exito": 100,
  "por_dia": [
    { "dia": "2026-10-13", "cobros_pagados": 9, "volumen": 9 },
    { "dia": "2026-10-14", "cobros_pagados": 11, "volumen": 11 }
  ]
}
CampoQué es
cobros_pagadosCuántos enlaces se pagaron en el rango.
volumenLo que sumaron esos cobros, en bolívares (el monto de cada enlace, sin la propina).
propinasLas propinas de esos cobros, en bolívares.
ticket_promediovolumen ÷ cobros_pagados.
comision · netoLa comisión de ePlaza y lo que te queda de esos cobros, en bolívares. Incluye los pagos con tarjeta.
intentos_aprobados · intentos_rechazadosIntentos de cobro con la clave del banco que el banco aprobó o rechazó en el rango. Los que siguen en proceso todavía no cuentan; los pagos con tarjeta no entran.
tasa_exitointentos_aprobados ÷ (intentos_aprobados + intentos_rechazados), en %. null si no hubo intentos. Si tu cliente escribe mal la clave y el cobro nunca llega al banco, no cuenta aquí.
por_diaCada día del rango (también los días sin cobros, con 0): dia, cobros_pagados y volumen.

Una fecha mal escrita, desde posterior a hasta o más de 366 días responden 400 validation con parametro.

Endpoint público (sin llave)

MétodoRutaPara
GET/verificar/:codigoComprobar que un comprobante es auténtico a partir de su código de verificación (QP-XXXXX-XXXXX). Límite: 20 consultas por minuto por IP. → Verificar un comprobante