Cobrar con tarjeta los pedidos a domicilio del Menú Digital (Botón de Pago Banco General)

¿Qué es / para qué sirve?

Permite que el cliente pague con tarjeta (Visa o Mastercard) los pedidos a domicilio que hace desde la carta del Menú Digital. El cobro lo hace la página segura de Banco General (Botón de Pago BG, que funciona con CyberSource): el sistema nunca ve ni guarda los datos de la tarjeta.

Lo importante:

• Solo para delivery. En la mesa o en la habitación el cliente sigue pagando como siempre, con el salonero.
• El pedido entra a cocina solo cuando el banco confirma el pago. Mientras tanto queda como "Pago pendiente" y no se cocina, no se imprime, no descuenta inventario y no toca la caja.
• Un pedido a domicilio pagado con tarjeta entra directo, aunque tengas configurado que los delivery esperen aprobación: el pago confirmado hace de aprobación.
• Viene apagado. Si no lo enciendes, la carta se ve y funciona exactamente igual que antes.

No es Yappy. El "Botón de Pago Yappy" es otro servicio del banco y se configura aparte.

Antes de empezar: lo que te entrega Banco General

Para activar el Botón de Pago, Banco General te envía las credenciales de Secure Acceptance (una para el ambiente de pruebas y otra para producción):

• Profile ID
• Access key
• Secret key

Se crean en el portal de CyberSource (Business Center), en Configuración de pagos → Secure Acceptance. Si no las tienes, escríbele a comercioelectronico@bgeneral.com.

En ese mismo perfil de Secure Acceptance hay que poner las direcciones de regreso del sistema. Las encuentras copiadas en la pantalla de configuración (paso 6 de abajo).

Paso a paso: configurarlo

1. Entra a Menú Digital y abre la pestaña Configuraciones.
2. Baja hasta la tarjeta "Pago con tarjeta (Botón de Pago Banco General)". [CAPTURA: tarjeta "Pago con tarjeta (Botón de Pago Banco General)" en Configuraciones]
3. En Ambiente elige Pruebas mientras haces la certificación con el banco. Cambia a Producción solo cuando el banco te lo autorice: en producción se cobra de verdad.
4. Escribe el Profile ID, la Access key y pega la Secret key.
   • La Secret key se guarda cifrada y no se vuelve a mostrar: después de guardar solo verás sus últimos 4 caracteres.
   • Si más adelante cambias otra cosa, deja la Secret key vacía: se conserva la que ya estaba.
5. Pulsa Probar firma. Revisa que las tres credenciales tengan un formato correcto y que se pueda firmar con ellas. No se comunica con el banco: la prueba completa es un pago en el ambiente de pruebas (ver abajo).
6. Copia las tres direcciones que aparecen en la tarjeta y entrégalas al banco o pégalas en el perfil de Secure Acceptance:
   • Página de recibo: https://<tu-negocio>.tuvendor.cloud/qr-pago/bg/regreso
   • Página de cancelación: https://<tu-negocio>.tuvendor.cloud/qr-pago/bg/cancelado
   • Notificación al comercio (Merchant POST URL): https://<tu-negocio>.tuvendor.cloud/qr-pago/bg/notificacion
7. Marca "Ofrecer el pago con tarjeta en la carta" y pulsa Guardar.
   • Si falta alguna de las tres credenciales, el sistema no lo enciende y te avisa; lo demás sí se guarda.

Certificación con Banco General (ambiente de pruebas)

Antes de cobrar de verdad, el banco pide una transacción de prueba:

1. Con el Ambiente en Pruebas, abre la carta del Menú Digital como si fueras un cliente.
2. Arma un pedido, elige una zona de entrega y como método de pago "Tarjeta (Banco General)".
3. Escribe nombre, apellido, teléfono y correo (con tarjeta el correo es obligatorio: ahí llega el comprobante del banco) y confirma.
4. En la página del banco usa la tarjeta de prueba oficial:
   • Número: 4000 0000 0000 1000
   • Vencimiento: mes 01 del año actual + 3 (por ejemplo, en 2026: 01/2029)
   • CVV: 123
5. Al terminar, el banco te devuelve a la carta con el aviso "¡Pago recibido!" y el pedido pasa a cocina.
6. Envía la prueba (número de pedido, fecha y monto) a comercioelectronico@bgeneral.com para que el banco la valide y te autorice la salida a producción.
7. Con la autorización, cambia el Ambiente a Producción y pon las credenciales de producción.

Lo que ve el cliente

1. En el paso Finalizar, con una zona de entrega elegida, aparece el método "Tarjeta (Banco General)". [CAPTURA: selector de método de pago con "Tarjeta (Banco General)"]
2. Al elegirlo se pide el apellido y el correo pasa a obligatorio. La propina no se cobra por tarjeta en esta versión: la casilla de propina se oculta.
3. Al confirmar, la carta lo lleva a la página segura de Banco General.
4. Al volver:
   • Pago aprobado: ve "¡Pago recibido!" con su número de pedido y el botón Volver al menú.
   • Pago rechazado o cancelado: ve "El pago no se completó". Puede intentar de nuevo con tarjeta o volver al menú y elegir otro método (su carrito sigue guardado).

Lo que ves tú (el restaurante)

• En Menú Digital → Pedidos aparece el filtro "Pago pendiente" (solo si tienes el pago con tarjeta encendido). Ahí están los pedidos que esperan que el cliente termine de pagar.
• Cuando el banco confirma, el pedido pasa a Aceptados con la etiqueta "Pagado con tarjeta", sale la comanda por donde tengas configurado (impresora, KDS o ambos) y suena la campanita.
• La venta queda con su pago con tarjeta ya registrado (método Tarjeta, con el número de transacción del banco y los últimos 4 dígitos de la tarjeta). El pedido queda como cuenta abierta para que el cajero emita la factura al despacharlo, sin volver a cobrarlo.
• Un pedido que nunca se paga se anula solo a las 2 horas y queda como "Pago vencido". Como nunca tocó inventario ni caja, no hay nada que reponer.

Notas y avisos

Si el cliente ve el cargo en su tarjeta pero el pedido no aparece pagado, revisa la transacción en el portal de CyberSource (Gestión de transacciones → Transacciones) antes de cobrarle de nuevo.

Si el banco deja un pago "en revisión" (antifraude), el pedido no entra a cocina: el cliente ve el aviso de que el restaurante lo contactará. Revisa el pago en el portal de CyberSource.

Si un cliente llegara a pagar dos veces el mismo pedido (por ejemplo, desde dos pestañas), el sistema registra un solo pago y no repite la comanda; el segundo cobro hay que devolverlo desde el portal del banco.

Monedas: el Botón de Pago cobra siempre en dólares (USD), que equivalen al balboa.

Cerrar en el POS un pedido ya pagado con tarjeta

1. En el POS abre la cuenta del pedido (ventas suspendidas / cuentas abiertas) y presiona PAGAR.
2. En el cuadro de pago verás la fila "Tarjeta (Banco General)" con el monto ya pagado, bloqueada (no se puede cambiar), Pago Total igual al total y Saldo: 0.00.
3. No marques efectivo ni otro método. Presiona Cobrar sin ticket o Cobrar e Imprimir.
4. La cuenta se cierra con el pago del banco tal cual (número de transacción y últimos 4 dígitos).

[CAPTURA: cuadro de pago del POS con la fila "Tarjeta (Banco General)" bloqueada y Saldo 0.00]

La fila "Tarjeta (Banco General)" aparece aunque tu sucursal no tenga el método "Tarjeta" en el POS: es el pago que confirmó el banco y no se puede borrar ni cambiar desde el POS.

PENDIENTE DE VERIFICAR: la factura electrónica que se emite al cerrar estos pedidos (forma de pago tarjeta) — en la copia de pruebas la emisión de FE estaba apagada.