Entornos y URLs
URLs
| API | https://eplaza-qa-pay.pagaconquickpay.com/switch/v1 |
| Página de pago de un cobro | https://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étodo | Ruta | Para |
|---|---|---|
| POST | /links | Crear un enlace de pago |
| GET | /links | Listar tus enlaces |
| GET | /links/:id | Consultar un enlace |
| POST | /links/:id/cancelar | Cancelar un enlace que sigue pendiente |
| POST | /links/:id/simular | Forzar el resultado de un enlace de prueba (pagado, rechazado o expirado); sólo con llave sk_test_ |
| POST | /lotes | Crear hasta 500 enlaces |
| GET | /lotes | Listar tus lotes |
| GET | /lotes/:id | Consultar un lote y cada enlace |
| POST | /lotes/:id/cancelar | Cancelar los enlaces pendientes de un lote |
| GET · POST | /webhooks | Listar o registrar webhooks |
| GET · PATCH · DELETE | /webhooks/:id | Ver, cambiar (url, eventos, estado) o borrar un webhook |
| GET | /webhooks/:id/deliveries | Últimas entregas de un webhook |
| GET · POST | /api-keys | Listar o crear llaves |
| POST | /api-keys/:id/revoke | Revocar una llave |
| GET | /estadisticas | Tus 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.
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_..."{
"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 }
]
}| Campo | Qué es |
|---|---|
cobros_pagados | Cuántos enlaces se pagaron en el rango. |
volumen | Lo que sumaron esos cobros, en bolívares (el monto de cada enlace, sin la propina). |
propinas | Las propinas de esos cobros, en bolívares. |
ticket_promedio | volumen ÷ cobros_pagados. |
comision · neto | La comisión de ePlaza y lo que te queda de esos cobros, en bolívares. Incluye los pagos con tarjeta. |
intentos_aprobados · intentos_rechazados | Intentos 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_exito | intentos_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_dia | Cada 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étodo | Ruta | Para |
|---|---|---|
| GET | /verificar/:codigo | Comprobar 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 |