# El portal de comercios

Todo lo que necesitas para cobrar, sin programar. Entras con tu usuario o correo y tu contraseña.

## Cómo se abre la cuenta

1. Eliges **Para mí** (con tu cédula) o **Para mi negocio** (con el RIF de tu empresa).
2. Confirmas tu correo con un código.
3. Subes la foto o el PDF de tu cédula o tu RIF: llenamos tus datos por ti y tú los confirmas.
4. Si abres la cuenta **para tu negocio**, nos dices a qué se dedica: colegios y universidades, condominios, gimnasios y clubes, proveedores de internet, restaurantes y comida, sector salud, tiendas y emprendimientos, veterinarias y mascotas, u otro. Este paso no aparece en las cuentas **para ti**.
5. Registras la cuenta donde quieres recibir el dinero. La verificamos enviándote **Bs 1**: así comprobamos que está a tu nombre.
6. Creas tu usuario y tu contraseña.

Al terminar, tu cuenta queda **aprobada para cobrar dinero real**: la verificación con Bs 1 es la que la habilita. El equipo de QuickPay revisa cada alta después; si algo no cuadra, te escribimos.

> **De 11:45 p. m. a 1:30 a. m. (hora de Venezuela)** los bancos hacen su mantenimiento diario: la verificación con Bs 1 espera a la 1:30 a. m. y no gastas intentos. En esa franja tampoco se pueden hacer pagos: tu portal, tu página de pago y tus enlaces lo avisan desde las 11:30 p. m. Puedes crear y enviar cobros a cualquier hora; tu cliente los paga a partir de la 1:30 a. m.

> **La cuenta debe estar a tu nombre.** Si la cédula o el RIF no coinciden con el titular, el banco rechaza la verificación.

## Qué haces en el portal

| Sección | Para qué |
|---|---|
| Inicio | Lo cobrado hoy y en el mes, lo que ya llegó a tu banco y tus últimos movimientos, en la [divisa de tu panel](#divisa-del-panel) |
| Cobrar | Crear un cobro con monto, tu página de pago o dividir una cuenta |
| Transacciones | Todos tus cobros: filtrar por fecha, estado y más, buscar, ver detalle, cancelar o reenviar uno pendiente, y descargarlos en Excel o CSV → [Filtrar tus transacciones](#filtrar-tus-transacciones) |
| Clientes | Tu base de clientes, a mano o desde Excel, con búsqueda y filtros, segmentos automáticos, etiquetas, estado de pago y acciones en grupo → [Clientes y cobranza](/developers/clientes-y-cobranza). En condominios se llama **Propietarios e inquilinos** |
| Cobranza masiva | Enviar el cobro a muchos clientes, ahora o programado |
| Suscripciones | Planes de cobro recurrente y sus suscriptores, en tres pestañas: **Suscriptores**, **Planes** y **Métricas**, con un resumen arriba (activas, al día, atrasadas, cobrado este mes) → [Suscripciones](/developers/suscripciones). No aparece en restaurantes, que no tienen cobros recurrentes |
| Productos | Tu catálogo: cobras eligiendo el producto (en restaurantes se llama **Menú y productos**; gimnasios, condominios y colegios no lo usan) |
| Sucursales | Restaurantes, gimnasios, sector salud, veterinarias y tiendas: tus locales, para etiquetar cada cobro, elegir a qué cuenta caen sus pagos y filtrar Transacciones |
| Propinas | Restaurantes: activar la pregunta de propina al pagar, sus botones y ver las propinas recibidas → [Propinas](/developers/propinas) |
| Urbanizaciones y complejos | Condominios: cada urbanización o complejo con sus propietarios e inquilinos |
| Integraciones | Botón para tu web, llaves de API y webhooks |
| Ajustes | Tus datos, tu plan, tus cuentas de cobro, tu equipo, la divisa del panel y tus avisos |

**Nombre comercial.** Si tu negocio se conoce con un nombre distinto a su razón social (p. ej. razón social *Inversiones Ejemplo 2023, C.A.* y nombre comercial *Pizzería Ejemplo*), escríbelo al registrarte o en **Ajustes › Tu cuenta** (opcional, hasta 100 caracteres). Quien te paga ve ese nombre en la página de pago ("Estás pagando a…") y en el comprobante del pago. Tu razón social no cambia: es la que usan el banco y la verificación de tu cuenta. Si lo borras, vuelve a mostrarse la razón social.

El portal se adapta al **tipo de negocio** que elegiste al registrarte: el menú y los filtros cambian, pero los cobros, la cobranza masiva y las notificaciones funcionan igual para todos. Si elegiste "Otro", ves el menú estándar.

Cuando entra un pago, el portal te lo muestra al momento: "Recibiste US$ X (Bs Y) de Z", en la divisa de tu panel. Además te enviamos un correo por cada pago.

## Cuentas personales

Si abriste la cuenta con **Para mí**, el portal es más corto, porque una persona recibe pagos pero no administra un negocio. El menú tiene cinco secciones:

| Sección | Para qué |
|---|---|
| Inicio | Lo cobrado hoy y en el mes, lo que ya llegó a tu banco y tus últimos movimientos |
| Cobrar | **Pedir un monto** (enlace o QR para un pago puntual), **Mi enlace** (quien te paga escribe el monto) y **Dividir una cuenta** |
| Movimientos | Cada pago con su referencia del banco: filtrar, buscar, ver detalle y descargarlo. Es la misma pantalla que **Transacciones** en un negocio |
| Contactos | Las personas que te han pagado y eligieron guardar sus datos, y las que agregas tú. Es la misma pantalla que **Clientes** en un negocio, sin carga masiva |
| Ajustes | Tus datos, tu plan, tus cuentas de cobro, la divisa del panel y tus avisos |

Una cuenta personal no tiene Cobranza masiva, Suscripciones, Productos, Sucursales, Integraciones ni Equipo: esas pantallas no aparecen, si abres su dirección vuelves a Inicio y las funciones equivalentes de la API responden `403`. La página de pago de una persona muestra sus iniciales en lugar del ícono de tienda, y en ella quien te paga ve la casilla **"Guardar mis datos para pagarle más rápido a *tu nombre*."** (sin nombre obligatorio). Quien la marca aparece en **Contactos** cuando el pago queda confirmado; esa casilla no es permiso para enviarle novedades.

El estado de tu cuenta se dice igual en Inicio, Cobrar y Ajustes: **cuenta de demostración** (los pagos son simulados), **en revisión** (tus cobros son de prueba hasta que te aprobemos; pasa sólo si la aprobación automática no se pudo completar) o, cuando puedes cobrar, sin aviso. En Inicio, lo cobrado hoy y en el mes suma sólo pagos reales y debajo dice cuántos de prueba quedaron fuera; en una **cuenta de demostración** (todos sus pagos son simulados) los suma, para que se vea cómo luce un negocio cobrando.

## Divisa del panel

En **Ajustes › Divisa del panel** eliges en qué moneda ves tus montos: **dólares (US$)**, que es la que viene por omisión, **euros (€)** o **bolívares (Bs)**. Sólo el Propietario y los Administradores la cambian; el Cobrador ve los montos en esa divisa.

Con dólares o euros, cada monto sale **grande en esa divisa** y, **debajo y pequeño, lo que fue en bolívares**; al lado sigue la cantidad de pagos. Aplica en Inicio (cobrado hoy, este mes, ya en tu banco y lo que está llegando), Últimos movimientos, Transacciones (la lista, el detalle y los totales de lo filtrado), Propinas, el total de cada lote de Cobranza masiva y el aviso de pago recibido. Los planes y productos siguen en la moneda en que fijaste su precio, y el monto que escribes al cobrar (Cobrar, Dividir cuenta, Nueva cobranza) arranca siempre en bolívares (puedes cambiarlo en cada cobro); al crear un producto o un plan, el precio arranca en tu divisa.

**Con qué tasa se convierte.** Cada pago usa la tasa BCV del **día en que se pagó** (día de Venezuela), no la de hoy:

- Si el cobro se creó en esa misma divisa, se usa el monto y la tasa exactos con que se creó.
- Dólares: la última tasa BCV publicada hasta el día del pago (un sábado usa la del viernes).
- Euros: la tasa oficial del euro que guardamos cada día. Si no tenemos la de ese día (pagos anteriores a que empezáramos a guardarla), se usa la más cercana anterior o, en su defecto, la de hoy, y el monto aparece con **≈**.

Los totales suman cada pago ya convertido y se redondean al final; los bolívares de abajo son la suma real en bolívares. Es sólo cómo se muestra: los cobros y lo que llega a tu banco siguen siendo en bolívares.

## Avisos por correo

Cada vez que te pagan, te llega un correo "Recibiste un pago" con el monto, el concepto, la fecha y un enlace a la transacción. Les llega al Propietario y a los Administradores, una sola vez por cobro. Viene encendido; lo apagas en **Ajustes › Avisos**.

## Tu plan

En **Ajustes › Tu plan** ves tu plan, hasta cuándo está pagado, cuántos cobros por WhatsApp enviaste en los últimos 30 días y cuántos te quedan, y los planes disponibles con sus límites. Los cobros por correo no tienen límite. Esta sección la ven el Propietario y los Administradores.

| Plan | Precio | Cobros por WhatsApp |
|---|---|---|
| Gratis | US$ 0 | 20 al mes, hasta 5 por día uno a uno |
| Emprendedor | US$ 3 cada 30 días | 150 al mes, hasta 30 por día uno a uno |
| Negocio | US$ 12 cada 30 días | 600 al mes, hasta 100 por día uno a uno |

**Cambiar de plan:** tocas **Cambiar a …**, ves el monto en US$ y su equivalente en bolívares a la tasa BCV de ese momento, y al continuar se abre el pago de QuickPay en otra pestaña. La tarjeta queda en **Esperando tu pago…** y, cuando el pago se confirma, el plan se activa solo y te llega un correo. Si el pago en línea no está disponible en ese momento, el botón abre el WhatsApp de QuickPay con el mensaje listo.

- Cada pago te da **30 días** del plan y se paga en bolívares a la tasa BCV del momento en que se crea el enlace.
- **Renovar** antes de que venza suma los 30 días al final de tu período.
- **Subir** de plan: empiezas 30 días nuevos desde el pago y los días que te quedaban del plan anterior se suman, convertidos al precio del nuevo (por ejemplo, 20 días de Emprendedor equivalen a 5 días de Negocio).
- **Bajar** de plan: el cambio se aplica cuando termina el período que ya pagaste. No se devuelve dinero. Puedes cancelarlo antes de esa fecha.
- Te avisamos por correo 3 días antes de que venza, el día que vence y el día siguiente, con el enlace para pagar.
- Si no renuevas, tienes **3 días de gracia**; después vuelves al plan Gratis y te avisamos. Los cobros que ya enviaste no se cortan: el cupo sólo se revisa al enviar un cobro nuevo.

## Filtrar tus transacciones

Arriba de la lista siempre ves tres controles: **Fecha**, **Estado** y **Buscar**. El botón **Filtros** abre el resto.

| Filtro | Qué hace |
|---|---|
| Fecha | Hoy, Ayer, Últimos 7 días, Este mes, Mes pasado o **Rango personalizado** (desde–hasta, ambos días incluidos). Los días son de Venezuela: un pago de las 9:00 p. m. entra en ese día. Un cobro cuenta en la fecha en que se pagó; si aún no se paga, en la que se creó |
| Estado | Pagado (en tu banco), Pendiente, Procesando, En revisión, Vencido o Cancelado |
| Buscar | Por concepto, nombre del cliente, referencia del pago o del crédito a tu cuenta, o el identificador del cobro (el final de su enlace) |
| Sucursal | En los tipos de negocio con sucursales. En condominios, urbanización o complejo y propietario o inquilino; en colegios, grado y sección |
| Cuenta donde cae el dinero | Sólo si tienes más de una cuenta de cobro |
| Monto | Mínimo y máximo del cobro, en Bs |
| Propina | Con o sin propina (restaurantes) |
| Cómo se creó | Creado en el portal, página de pago, botón de pago, WhatsApp, API, cobranza masiva o suscripción |
| Etiqueta del cliente | Sólo los cobros enviados a personas con esa [etiqueta](/developers/clientes-y-cobranza#etiquetas). El cobro del switch no trae al cliente, así que se cruza con lo que guardamos al enviarlo: Cobranza masiva, Suscripciones y quienes se registraron al pagar. **Un cobro suelto** (el de Cobrar, o un pago en tu página sin que la persona se registre) **no tiene un cliente asociado y no aparece** con este filtro |
| Modo | Cobros reales o de prueba |
| Pagos rechazados | **Con rechazos:** cobros con al menos un intento de pago rechazado. **Sin rechazos:** los que no tienen ninguno |

Un rechazo no cambia el estado del cobro: vuelve a quedar **Pendiente** y tu cliente puede intentarlo de nuevo; si después paga, sale como pagado y el filtro lo sigue encontrando. Al abrir un cobro con intentos rechazados ves cuántos fueron (por ejemplo **2 intentos rechazados**). Sólo cuentan los intentos en los que tu cliente llegó a escribir la clave de pago de su banco.

Los filtros activos aparecen como etiquetas que quitas con la **x**, y **Limpiar filtros** los quita todos. Quedan en la dirección de la página: puedes recargarla o compartirla y verás lo mismo. Debajo de los filtros ves cuántos cobros salieron, lo **cobrado** (suma de los pagados, sin contar los de prueba; en una cuenta de demostración, que sólo tiene pagos simulados, sí los cuenta) y, en restaurantes, las **propinas**, en la [divisa de tu panel](#divisa-del-panel) y con los bolívares al lado. La lista carga de 50 en 50 con **Ver más**.

Los filtros y los totales cuentan todos tus cobros, en cualquier divisa del panel. En dólares o euros, cada pago se convierte con la tasa BCV de su día de pago, y un cobro que creaste en esa misma divisa cuenta con su monto exacto. Los cobros de suscripción enviados antes del 9 de octubre de 2026 aparecen como cobranza masiva.

## Descargar tus transacciones

En **Transacciones › Descargar** bajas en Excel o CSV **exactamente lo que estás viendo**, con los mismos filtros, y con las fechas en hora de Venezuela. Incluye hasta 5.000 cobros de lo filtrado (los más recientes); si hay más, la pantalla te avisa: acota las fechas para bajar el resto. Las columnas en bolívares (para tu contabilidad) se mantienen; si tu divisa es dólares o euros, se agregan al lado las columnas **Monto**, **Propina** y **Acreditado** en esa divisa, la **Tasa BCV usada** de cada pago y **Tasa aproximada** (Sí cuando no era la tasa exacta de ese día).