Pasarelas de pago
Actualizado el 14 de noviembre de 2026
Sirven para que el cliente pague desde fuera del mostrador: el depósito de una reserva, un pedido de la tienda, un enlace de pago. Se configuran en Ajustes → Integraciones → Pagos online, y se elige cuál es la principal.
| Pasarela | Qué necesitas |
|---|---|
| Stripe | Clave publicable, clave secreta y secreto del webhook |
| PayPal | Client ID, Client Secret, Webhook ID y modo sandbox para pruebas |
| Square | Access token, Location ID y clave de firma del webhook |
| Redsys | Código de comercio, terminal (001 por defecto) y clave secreta, con modo pruebas |
En cada una, la propia pantalla te muestra la dirección del webhook que hay que registrar en el panel del proveedor, con el evento que hay que suscribir. Los pasos, resumidos:
- Crea la cuenta en el proveedor y copia sus credenciales.
- Pégalas en GuauKit y activa la pasarela.
- Registra el webhook con la dirección que te da GuauKit.
- Pega también el secreto de firma. No es opcional: sin él, GuauKit rechaza los avisos.
- Prueba con un importe pequeño antes de anunciarlo.
En Square hay que suscribir dos eventos:
payment.createdypayment.updated. Square manda los dos por el mismo cobro y a GuauKit le vale cualquiera de ellos —el apunte no se duplica—.
Y la dirección del webhook tiene que coincidir carácter a carácter con la que enseña GuauKit. Square firma sus avisos sobre la URL registrada + el cuerpo del mensaje, así que una barra de más o un dominio distinto hacen que la firma no cuadre y el aviso se rechace.
Guías oficiales: Stripe · PayPal · Square · Redsys.
Qué es el webhook y por qué no es opcional. Cuando el cliente termina de pagar, su navegador vuelve a GuauKit — pero volver de la pasarela no es haber pagado: esa vuelta se puede escribir a mano en la barra de direcciones. Lo que marca la factura es el aviso firmado que la pasarela manda por su cuenta al servidor, y eso es el webhook. Sin registrarlo, el cliente paga de verdad y la factura se queda pendiente.
Y un aviso que llega mientras se cobra en el mostrador no se pisa con el cobro. Si el cliente paga una parte por el enlace y otra en el mostrador en el mismo momento, la factura suma las dos. El mismo aviso que llega dos veces se apunta una sola.
Stripe, paso a paso
- En dashboard.stripe.com → Desarrolladores → Claves de API, copia la clave publicable (
pk_live_…) y la clave secreta (sk_live_…). Para probar, usa las de test (pk_test_…/sk_test_…). - Pégalas en GuauKit y activa la pasarela.
- En Desarrolladores → Webhooks → Añadir endpoint, pega la dirección que te da GuauKit y suscribe el evento
checkout.session.completed. - Stripe te enseña entonces el signing secret (
whsec_…). Cópialo al campo Secreto del webhook de GuauKit.
PayPal, paso a paso
- En developer.paypal.com → Apps & Credentials, crea una app y copia Client ID y Client Secret. Elige Sandbox o Live según lo que vayas a hacer, y marca en GuauKit el mismo modo.
- En la misma app, Add Webhook: pega la dirección de GuauKit y suscribe dos eventos:
CHECKOUT.ORDER.APPROVED— es el que hace que el cobro sea inmediato.PAYMENT.CAPTURE.COMPLETED— el que confirma que el dinero se ha movido y marca la factura.
- PayPal te da un Webhook ID. Cópialo a GuauKit: sin él, GuauKit rechaza todos los avisos de PayPal y ninguna factura se marcará como pagada sola. No es opcional.
Si solo registras el segundo evento, sigue funcionando. GuauKit revisa cada cinco minutos las aprobaciones sin cobrar y las cobra él. Registrar
CHECKOUT.ORDER.APPROVEDlo que hace es que no haya que esperar esos minutos.
Con PayPal el cobro va en dos pasos, y conviene saberlo. El cliente aprueba el pago, y después el cobro se pide desde el servidor. Con el evento
CHECKOUT.ORDER.APPROVEDregistrado eso pasa en el acto; sin él, en la siguiente revisión, que es cada cinco minutos. El cliente ve «La factura se actualizará en breve», que es exactamente lo que ocurre.Si pasada media hora una factura sigue pendiente, mira el aviso de administración: cuando no se ha podido cobrar una aprobación, GuauKit lo dice con el motivo. PayPal caduca una aprobación sin cobrar a los tres días, así que eso no puede esperar a la semana que viene.
Square, paso a paso
- En developer.squareup.com → Applications, crea una app.
- Copia el Access Token y el Location ID. Ojo con el modo: si activas Modo sandbox (pruebas) en GuauKit, tienen que ser los del Sandbox, no los de producción.
- En Webhooks → Subscriptions, pega la dirección que te da GuauKit y suscribe
payment.createdypayment.updated. Square manda los dos por el mismo cobro y a GuauKit le vale cualquiera: el pago no se apunta dos veces. - Copia la Signature Key de esa suscripción al campo Webhook Signature Key de GuauKit. Mientras esté vacío, GuauKit rechaza todos los avisos y ninguna factura se marca sola.
Dos cosas de Square que dan problemas y no se ven venir:
payment.completedno existe. Si lo buscas en la lista de eventos de Square, no está.- La dirección tiene que coincidir carácter a carácter. Square firma sus avisos sobre la URL registrada + el cuerpo del mensaje; con una barra de más,
httpen vez dehttpso un dominio distinto, la firma no cuadra y el aviso se rechaza. Usa Copiar en GuauKit y pega, sin retocar.Y una que sí es normal: la orden se queda en
OPENen el panel de Square aunque esté cobrada. Es así como funcionan sus enlaces de pago —el cobro entra como tender y la orden solo pasa aCOMPLETEDcuando la das por servida—. GuauKit mira lo que queda por cobrar, no ese estado.
Redsys, paso a paso
- Tu banco te da el código de comercio (FUC), el terminal (normalmente
001) y la clave secreta de firma. - Pégalos en GuauKit y elige modo pruebas o real según lo que te haya dado el banco: son claves distintas.
- En el panel de administración de Redsys, en Gestión de comercio → Datos de configuración, pega la dirección que te da GuauKit en URL de notificación (
DS_MERCHANT_MERCHANTURL). En Redsys eso hace de webhook. Deja Notificación online enHTTPy Sincronización enSíncrona.
Redsys no funciona como las otras tres. Las demás dan una dirección y el cliente va a ella; Redsys exige que el navegador envíe un formulario con los datos firmados a su TPV virtual. Por eso verás un instante la pantalla «Redirigiendo a la pasarela de pago…» antes de llegar al banco. Si esa pantalla se queda dando vueltas y no pasa de ahí, es que algo está impidiendo ese envío.
Cuando el pago no se marca
El cliente dice que ha pagado y la factura sigue pendiente. Por orden de probabilidad:
| Mira | Qué pasa si está mal |
|---|---|
| ¿Has pegado el secreto de firma? | Sin él GuauKit rechaza todos los avisos, a propósito: sin firma no hay forma de saber si el aviso viene de la pasarela o de cualquiera |
| ¿El evento suscrito es el que dice GuauKit? | Con otro evento la pasarela no manda nada, y no hay ningún error que mirar |
| ¿La dirección es exactamente la que da GuauKit? | En Square la firma se calcula con la URL dentro; en las demás, el aviso va a otro sitio |
| ¿Modo pruebas coincide en los dos lados? | Las credenciales de sandbox no valen en producción ni al revés |
| ¿El importe cubre el total? | Un pago parcial deja la factura pendiente, con el cobro apuntado |
| Redsys: ¿se queda en «Redirigiendo a la pasarela»? | Ahí el pago no ha llegado a empezar: no es que no se marque, es que el cliente nunca vio el datáfono. Nada que buscar en el banco |
El panel del proveedor tiene el registro de intentos de entrega del webhook, con la respuesta que dio GuauKit. Es el sitio donde se ve si el aviso salió y qué se le contestó.
Los depósitos de reserva se recuperan solos. Si el aviso se pierde, hay un proceso que cada 15 minutos le pregunta a la pasarela por los cobros que quedaron a medias y confirma la reserva (Automatizaciones). No sustituye al webhook, pero evita que un aviso perdido deje una plaza sin confirmar.
¿Has cambiado de pasarela hace poco? Los depósitos que ya estaban abiertos se siguen comprobando con la pasarela con la que se iniciaron, no con la nueva — y es lo correcto: la referencia del cobro es de la vieja y solo ella sabe si se pagó. Por eso no quites las credenciales de la pasarela anterior hasta que no queden depósitos pendientes: el plazo por defecto es de 48 horas, y si lo has desactivado pueden quedar abiertos más tiempo. Lo mismo vale al pasar de modo pruebas a producción: son credenciales distintas, así que para GuauKit es un cambio de pasarela.
Varios intentos de entrega no son varios cobros. En el panel de tu pasarela es normal ver el mismo aviso entregado dos o tres veces: cuando algo va lento por el camino, la pasarela lo reenvía. La factura apunta ese cobro una sola vez, así que si ves dos líneas de pago del mismo importe son dos cobros de verdad, y eso sí hay que mirarlo en la pasarela.
Un cobro que llega por una factura que ya no lo espera
Puede pasar que el cliente pague por un enlace que se quedó abierto después de que se anulara lo que pagaba: cancela en el portal un pedido de la tienda sin pagar —y su borrador de factura se borra—, pero la pestaña del pago seguía abierta y termina de pagar. La pasarela cobra de verdad y avisa a GuauKit.
- Si la factura se borró, no se apunta nada contra ella, pero administración recibe un aviso en la campana —en rojo, Cobro por devolver—: «Cobro de 12,50 € por una factura borrada: hay que devolverlo», con la pasarela, la factura y la referencia del cobro para encontrarlo.
- Si la factura estaba anulada, el cobro sí se apunta —es dinero que ha entrado—, pero la factura sigue anulada y llega el mismo aviso.
En los dos casos el dinero está en la pasarela y se devuelve desde allí. El aviso sale una vez por cobro, aunque la pasarela entregue el aviso varias veces.
Las claves se guardan, no se enseñan
Una vez guardada una credencial, GuauKit deja de mostrarla. En su lugar verás los cuatro primeros caracteres y el resto tapado (sk_l****), que basta para reconocer cuál está puesta. El campo aparece vacío: escribe una nueva solo si quieres cambiarla, y si lo dejas en blanco se conserva la que hay. Para retirarla del todo, el enlace quítala que hay debajo del campo. Ojo con eso último si has cambiado de pasarela hace poco: retirar una credencial deja sin poder comprobar los cobros que se abrieron con ella.
Vale para las cuatro pasarelas, para el datáfono y también para el token de Twilio de SMS y WhatsApp. El motivo es simple: con la clave secreta de tu pasarela se puede cobrar y devolver dinero en tu nombre, así que no tiene por qué estar en la pantalla de nadie —ni en la respuesta que el navegador guarda en su caché— cuando ya está guardada. La pantalla necesita saber si hay una clave, no cuál es.
Solo la ve el administrador, y solo la pantalla de pagos. El resto del personal no recibe estos datos ni enmascarados.
Tres reglas que explican por qué está hecho así
- Un aviso repetido no cobra dos veces. Las pasarelas reenvían el mismo aviso cuando algo va lento por el camino, y PayPal avisa por escrito de que puede mandarlo duplicado. GuauKit guarda la referencia del cobro que da la pasarela y apunta cada referencia una sola vez por factura, así que un aviso repetido no deja dos cobros ni pone la factura al doble. Y si el primer aviso se cortó a medias —se apuntó el cobro pero no llegó a marcarse la factura—, el segundo termina de cuadrarla en vez de darse la vuelta.
- Sin secreto de firma, el aviso se rechaza. Podría parecer más cómodo aceptar los avisos sin comprobar la firma cuando no hay clave configurada, pero eso permite que cualquiera que conozca la dirección marque como pagada una factura ajena. GuauKit falla cerrado.
- Lo que cobra la pasarela se apunta en su moneda. Las pasarelas informan del cobro en la unidad más pequeña de la moneda: céntimos para el euro, y el peso entero para el peso chileno, que no tiene decimales. GuauKit lo convierte con los decimales de la moneda del cobro: un cobro de 15 000 pesos se apunta como 15 000 pesos, no como 150.
- Volver de la pasarela no es haber pagado. Que el navegador del cliente aterrice en la página de «pago correcto» no prueba nada: GuauKit guarda la referencia del cobro y le pregunta a la pasarela —o espera su aviso firmado— antes de dar por buena una reserva o una factura. Es la diferencia entre un cobro y una pantalla verde.
Cobro con datáfono
Aparte de las pasarelas online, el TPV puede lanzar el cobro a un terminal físico —Stripe Terminal, SumUp o Redsys— desde Ajustes → Integraciones → Cobros (recuadro Datáfono (TPV físico)). Con SumUp, Probar conexión comprueba el lector y el permiso de leer transacciones antes del primer cobro. El cobro se inicia desde la venta y GuauKit consulta el resultado al datáfono.