Tema 1.5

Pasarelas de pago

Conecta Wompi, Bold o Mercado Pago para cobrar desde el QR de la mesa y el menú público, y el datáfono Bold.

Dueño

Configuración › Cobros › Pasarelas de pago

Video 1.7Conecta Mercado PagoAbrir en YouTube

Con una pasarela, tus clientes pagan desde el QR de la mesa o desde tu menú público. Rukkos trabaja con Wompi, Bold y Mercado Pago, y cada negocio usa su propia cuenta: la plata llega directo a ti. En Configuración, grupo Cobros, entra a Pasarelas de pago y haz clic en Configurar → en la que vas a usar.

Pasarelas de pago con las tarjetas de Wompi, Bold y Mercado Pago

Primero en pruebas

Las tres pasarelas tienen llaves de pruebas y de producción. Conéctala primero con las de pruebas, haz un pago de prueba y, cuando todo funcione, cámbialas por las de producción.

Wompi

Wompi es la pasarela de Bancolombia: Bre-B, Nequi, DaviPlata, PSE, tarjeta y billeteras digitales. Necesitas tu cuenta de comercio en Wompi.

1
Busca tus llaves
En tu panel de Wompi, entra a Desarrollo › Programadores. Ahí están la llave pública, la llave privada y los secretos de eventos y de integridad. Para probar sin dinero real, activa el Modo de pruebas y usa esas llaves.
2
Pégalas en Rukkos
Activa el interruptor Habilitado y pega las cuatro: Llave pública (public_key), Llave privada (private_key), Secreto de integridad y Secreto de eventos. Haz clic en Guardar. Rukkos detecta solo si son de pruebas o de producción por cómo empieza la llave pública (pub_test_ o pub_prod_).
3
Configura el webhook
Copia la URL del webhook de Rukkos y pégala en Wompi, en Programadores › URL de Eventos, y guarda. Así cada pago queda registrado aunque tu cliente cierre el navegador.

Panel de Wompi recreado: Desarrollo › Programadores con las llaves y los secretos

Detalle de Wompi en Rukkos con las cuatro llaves y la URL del webhook

Bold

Bold es una pasarela colombiana: tarjeta, PSE, Nequi y Botón Bancolombia. Además, si tienes datáfono Bold, el mesero le manda el cobro desde la tablet sin digitar el monto.

1
Busca tus llaves
En tu panel de Bold, entra a Integraciones › Llaves de integración, pestaña Botón de pagos. Hay dos juegos, llaves de producción y llaves de pruebas, y cada uno trae una llave de identidad y una llave secreta.
2
Pégalas en Rukkos
Activa el interruptor y pega la Llave de identidad (API key) y la Llave secreta. Rukkos detecta el ambiente por cómo empieza la llave: no tienes que elegirlo.
3
Configura el webhook
Copia la URL de Webhook de Bold. En Bold, entra a Integraciones › Webhooks y haz clic en Nuevo webhook. Pega la URL, marca Venta aprobada y, mientras pruebas, activa Webhook de prueba. Haz clic en Crear webhook. Al pasar a producción, crea otro con la misma URL y ese interruptor apagado, y cambia tus llaves en Rukkos.
4
Prueba y guarda
Haz clic en Probar conexión y luego en Guardar cambios.

Detalle de Bold en Rukkos con las dos llaves y el webhook

Ojo

Las llaves y el webhook tienen que estar en el mismo ambiente. Si en Rukkos pegas llaves de producción pero el webhook de Bold está en modo de prueba (o al revés), los pagos reales no quedan marcados como pagados.

Panel de Bold: nuevo webhook con el evento Venta aprobada

Datáfono Bold

Las llaves del datáfono están en la otra pestaña de Bold, API datáfono, y son distintas a las del botón de pagos. En Rukkos, activa API Datáfono Bold, pégalas y haz clic en Guardar llaves. Luego, Sincronizar desde Bold: aparecen tus datáfonos en Mis datáfonos. Puedes asignar cada uno a un mesero o dejarlo Compartido. Si usas un datáfono de otro proveedor, agrégalo con Datáfono manual.

Mercado Pago

Mercado Pago es la pasarela de Mercado Libre: tarjeta, PSE, Efecty y la cuenta de Mercado Pago de tu cliente. Todo se hace en Mercado Pago Developers.

1
Crea tu aplicación
En Mercado Pago Developers, entra a Integraciones y haz clic en Crear aplicación. Ponle un nombre, elige Pagos online, con un desarrollo propio, y luego Checkout Bricks, que es el que usa Rukkos. Confirma.
2
Copia las credenciales de prueba
Adentro de tu aplicación, entra a Credenciales de prueba y copia la Public Key y el Access Token. El Client ID y el Client Secret no se usan en Rukkos.
3
Pégalas en Rukkos
Activa el interruptor, pega la Llave pública (public_key) y el Access Token, y haz clic en Guardar.
4
Configura el webhook
Copia la URL de Webhook de MercadoPago. En tu aplicación, entra a Webhooks › Configurar notificaciones. En Modo de prueba pega la URL y marca el evento Pagos (legacy); haz lo mismo en Modo productivo, con la misma URL. Haz clic en Guardar configuración.
5
Pega la clave secreta
Al guardar, Mercado Pago genera una Clave secreta. Cópiala y pégala en Rukkos, en Secreto de webhooks, y guarda. Así Rukkos verifica que cada aviso viene de verdad de Mercado Pago.
6
Pasa a producción
Cuando termines de probar, entra a Credenciales de producción y cambia en Rukkos la llave pública y el Access Token por los de producción.

Ojo

El Client Secret de Mercado Pago no es el Secreto de webhooks. El secreto que va en Rukkos es la Clave secreta que aparece al guardar los webhooks.

Mercado Pago Developers: Configurar notificaciones con el evento Pagos (legacy)

La pasarela primaria

De vuelta en Pasarelas de pago, la pasarela aparece como Habilitada. Haz clic en Hacer primaria en la que vas a usar. La primaria es la que usan el QR de la mesa y tu menú público: sin ella, tus clientes no pueden pagar.

Pasarelas de pago con Wompi como primaria

Nota

Tus llaves privadas y tus secretos se guardan cifrados y nunca vuelven al navegador. A qué cuenta contable entra cada pago lo eliges en Métodos de pago y medios de egreso.