Ajustes — Pagos en línea

Ruta: /ajustes/pagos Quién la usa: dueño, gerente Permiso requerido: settings.manage (además, el plan debe incluir facturación) Capturas: docs/manual/screenshots/ajustes/

Qué es

La pantalla de Pagos en línea configura los dos rieles con los que un cliente paga sin estar en el local: Yappy (botón de pago de Banco General) y Tarjetas en línea — Tilopay. Arriba lleva además la tarjeta Pagos y cobros, con el interruptor Cobrar ITBMS por defecto que fija el impuesto de todos los cobros. Un chip de estado indica si cada riel está activo y en qué ambiente.

Cuándo se usa

Al activar el cobro en línea del sitio de pedidos, cuando el comercio cambia su ID o su Clave Secreta de Yappy, y cuando se pasa de pruebas a producción. También se abre para comprobar en qué ambiente está cada riel antes de conciliar sus liquidaciones.

Paso a paso

1. Desde la fila de pestañas de Ajustes, abra Pagos en línea.
2. En Pagos y cobros, decida Exigir pago en línea en los pedidos web (marcado por defecto: el cliente paga al enviar el pedido; si lo desmarca, el sitio toma el pedido sin pagar y el delivery lo cobra el motorista en efectivo al entregar), deje marcado Cobrar ITBMS por defecto si el negocio está registrado en ITBMS (es el 7 % que se ve en todos los totales del día) y presione Guardar pagos y cobros.
3. Lea el chip de estado de Yappy: dice Yappy activo (UAT) o Yappy activo (PROD) cuando hay configuración, y Yappy sin configurar cuando no la hay. En frankies-sim dice Yappy sin configurar.
4. Siga Actívalo en 4 pasos: abrir la cuenta Yappy Comercial, entrar al portal (Métodos de cobro → Botón de Pago → «desarrollo propio»), registrar exactamente el dominio que la pantalla muestra en monoespaciado, y copiar el ID de comercio y la Clave Secreta.
5. Llene ID de comercio * y Clave Secreta *, elija el Ambiente (Pruebas (UAT) o Producción), deje marcado Activo (mostrar el botón Yappy en tus facturas) y presione Guardar configuración.
6. Baje a Tarjetas en línea — Tilopay y lea su chip: Tilopay activo (UAT) en esta simulación, o Tilopay sin configurar. Las credenciales no se cargan aquí: la pantalla enlaza a Conexiones.

Campos y botones

Mensajes y errores

Al guardar la configuración de Yappy, la pantalla muestra el resultado bajo el formulario:

"Configuración guardada. El botón Yappy ya aparece en tus facturas abiertas."

"Algo salió mal. Intenta de nuevo." NG_UNKNOWN — es lo que se ve cuando el guardado se rechaza por datos incompletos (falta el ID de comercio o la clave): el código NG_YAPPY_NOT_CONFIGURED no tiene texto propio en español.

Otros códigos que este riel puede devolver:

"Completa usuario, contraseña y API key de Tilopay." NG_TILOPAY_NOT_CONFIGURED

"No tienes permiso para esta acción." NG_FORBIDDEN

Lo que la pantalla no hace:

• No muestra la Clave Secreta guardada: el campo sale siempre vacío y hay que pegarla de nuevo en cada guardado, aunque solo se quiera cambiar el ambiente.
• No configura Tilopay: solo informa su estado y remite a Conexiones.
• Tilopay es solo para pedidos en línea; las tarjetas en el local van por el datáfono del banco. Por eso el cierre del día separa tilopay de Tarjeta (datáfono) y la conciliación espera dos liquidaciones distintas.
• El método de cobro Yappy del POS es independiente de este riel: en frankies-sim el cajero cobra con Yappy y toma la referencia a mano mientras el botón de pago en línea sigue sin configurar.
• Un usuario sin settings.manage no ve Pagos en línea en la fila de pestañas y, si escribe la ruta, recibe un 404 — no un aviso de permiso.

Relacionado

• Métodos de pago
• Conexiones
• Conciliación bancaria
• Cierre del día
• Portal del cliente — pago