# 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](/docs) · [openapi.json](/openapi.json) |

Prueba y producción usan las mismas URLs: el modo lo decide la llave (`sk_test_` o `sk_live_`). → [Llaves y entornos](/developers/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](#estadisticas) |

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 }
  ]
}
```

| 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](/developers/enlaces-de-pago#verificar-un-comprobante) |
