Payku (Pagos online con Webpay Plus)
¿Para qué sirve?
Permite cobrar en línea desde el sitio público con Webpay Plus a través de Payku: tarjetas de crédito (Visa, Mastercard, American Express, Diners) y débito Redcompra.
El cliente paga en la página de Webpay, Payku procesa, y tu sistema recibe la confirmación automáticamente por webhook.
¿Cuándo lo necesitas?
- Tienes una tienda online y quieres cobrar con tarjeta.
- Quieres generar links de pago para enviar por WhatsApp o email.
- Necesitas cobros presenciales complementarios al efectivo/POS.
Cómo activarlo
- Necesitas una cuenta de comercio en Payku (payku.cl).
- Obtén tu token desde
des.payku.cl(sandbox) oapp.payku.cl(producción). - Registra el plugin
payku. - Configura desde la página del plugin en el CMS.
Configuración inicial
En el CMS → Payku → Configuración. Esta página solo la abren las cuentas superadministrador y administrador: contiene las credenciales con las que se cobra.
Si administras condominios, cada comunidad cobra en su propia cuenta Payku y no se usa la de esta pantalla. El token de cada una se pega en Gastos Comunes → Tesorería → Configuración → Configurar Payku, con la comunidad abierta. Así una administradora con tres edificios recibe la plata de cada uno donde corresponde, y nunca en la cuenta de otro.
Lo de esta pantalla es la cuenta por defecto de la instalación: la que usa cualquier cobro que no venga de una comunidad. Ver Gastos Comunes.
- Activa Activar Plugin Payku.
- Plataforma: elige
Sandboxpara pruebas oProducciónpara vender de verdad. Cada plataforma requiere su propio token. - Modo de acceso:
Ingresar directamente a Webpay Plus. - Token Público: pega el token que corresponde a la plataforma seleccionada. Asegúrate de que el token corresponda:
- Si eliges
Sandbox, usa un token dedes.payku.cl. - Si eliges
Producción, usa un token deapp.payku.cl.
- Si eliges
- Token Marketplace (opcional): solo para usuarios marketplace.
- Incremento (%): un recargo sobre el valor de la orden,
0para no aumentar nada. Ojo con lo que significa: con7, una orden de $1.500 se le cobra al cliente en $1.605, y ése es el monto que verá en Webpay y en su comprobante. El sistema guarda los dos —lo que pidió el módulo y lo que se cobró de verdad— para poder conciliarlos después. - Estado del Pago Exitoso: a qué estado del workflow pasa la orden cuando el pago se aprueba (ej.
entregado,pagado). - Guarda.
- Copia la URL del webhook que aparece más abajo y regístrala en tu cuenta de Payku para que te avise de cada pago.
- Prueba una compra completa en Sandbox antes de pasar a producción.
El error más común es dejar el token de prueba con la plataforma en producción (o viceversa). Los pagos fallan sin explicación clara. Revisa siempre que coincidan.
Pasar a producción
El sistema cobra de verdad sólo cuando el campo Plataforma dice exactamente PROD. Con cualquier otro valor —incluido el nombre de tu plataforma, que es lo que uno tiende a escribir ahí— sigue cobrando contra el sandbox, y la pantalla no se ve distinta: plata que nunca entró. Si pones algo que no es TEST ni PROD, queda anotado en el registro del servidor diciendo justamente eso.
| Plataforma | A dónde va | Qué pasa |
|---|---|---|
TEST | des.payku.cl | Sandbox: tarjetas de prueba, no se cobra nada |
PROD | app.payku.cl | Producción: cobra de verdad |
| cualquier otra cosa | des.payku.cl | Sandbox, y lo avisa en el log |
Al cambiar a PROD hay que cambiar también el token: el de sandbox no sirve en producción, y al revés tampoco. Y la URL del webhook tiene que estar registrada en la cuenta de producción de Payku, no sólo en la de pruebas.
Las dos direcciones usan el mismo camino, el mismo encabezado de autorización y el mismo cuerpo de petición; lo único que cambia es el token y el dominio. Una compra que funcionó completa en sandbox funciona igual en producción.
Cuando vuelvas a entrar a la configuración verás solo los últimos 4
caracteres del token (••••••1a2b). Es a propósito: la credencial no se
vuelve a mostrar completa en pantalla.
- Si no quieres cambiarla, deja el campo tal como está y guarda: se conserva la que ya estaba.
- Si quieres reemplazarla, borra el contenido y pega el token nuevo.
Cómo se usa día a día
Este plugin es la conexión con la pasarela. Hoy tiene: la página de configuración, el flujo de pago (la transacción se crea desde código), el webhook que confirma, y la lista Cobros al final de la misma pantalla.
No existe todavía: el botón "Generar link de pago" dentro de las ventas, ni las integraciones automáticas con Punto de Venta, Workflow o Notificaciones. Para iniciar un cobro hay que llamar al plugin desde código; para verlos, ya no.
Recibir la confirmación
Cuando el cliente termina el pago, Payku hace un webhook a tu sistema. El plugin:
- Consulta la API de Payku para verificar que el pago realmente ocurrió — el aviso por sí solo nunca se toma como prueba.
- Comprueba que esa transacción corresponde a esa orden y que el monto coincide exactamente.
- Recién entonces marca la orden como pagada, y esa marca es definitiva: un aviso repetido no la reabre ni la cambia.
Es asíncrono: aunque el cliente cierre el navegador, la confirmación llega al webhook y se procesa.
Consultar los pagos
Al final de la pantalla Payku está la lista Cobros, con lo que se ha cobrado, de lo más nuevo a lo más viejo:
| Columna | Qué dice |
|---|---|
| Orden | El identificador con que el módulo pidió el cobro |
| Fecha | Cuándo se creó |
| Quién paga | El correo del pagador |
| Cobrado | El total que se le cobró; si hay recargo, lo desglosa |
| Estado | Pendiente, Pagada o Rechazada |
| Para conciliar | El número con que el banco identifica ese pago |
Los botones de arriba a la derecha filtran por estado, y la línea gris resume todo el conjunto filtrado, no solo la página que estás viendo. Abajo, Anteriores y Siguientes recorren el resto.
Para conciliar no es la referencia de la pasarela (trx…): es el número de
la transacción con que llega el depósito. Es el que hay que buscar cuando el
abono del banco no cuadra con una orden.
Debug Logging
Puedes activar Activar Debug Logging durante desarrollo para tener trazas
detalladas del flujo; quedan en logs/payku-debug.log, fuera de la carpeta que
publica el servidor. Desactívalo en producción: con el interruptor apagado
no se escribe el correo del cliente, el monto ni la respuesta de la pasarela en
el registro del servidor. Lo que sí queda siempre anotado es un fallo —
una caída de conexión, un token rechazado, una respuesta ilegible—, porque es
justo lo que hay que poder leer cuando un cobro no pasó.
Independiente de ese interruptor, cada orden guarda su propia historia: lo que la pasarela respondió al crear el cobro y lo que dijo en cada aviso posterior, sin pisar lo anterior. Es lo que hay que mirar cuando alguien reclama que le cobraron y la orden dice otra cosa.
Se conecta con
- Gastos Comunes — es la pasarela con la que el residente paga el total de su cuenta desde el portal. El pago confirmado se registra e imputa solo en su unidad; no hay que cargarlo a mano.
- Contabilidad — contempla el cobro por Payku como origen de un asiento de cobro.
Punto de Venta, Workflow y Notificaciones no se conectan automáticamente con Payku. Un pago confirmado no dispara hoy una transición ni un aviso: hay que programarlo.
Preguntas frecuentes
¿Qué comisión cobra Payku? Depende de tu plan comercial — consulta directamente con Payku.
¿Puedo devolver un pago? Sí, desde el panel de Payku (payku.cl) — pero el estado en tu sistema no cambia solo. Una orden pagada es definitiva a propósito: es lo que impide que un aviso repetido, o uno falso, reabra un cobro que ya se cerró. Esa misma puerta deja afuera al aviso de la devolución.
Después de devolver en Payku, la orden sigue diciendo Pagada en la lista de Cobros. Registra la devolución donde corresponda en tu operación y trátala aparte; hoy el plugin no la refleja.
Al cliente le cobraron más de lo que decía la orden.
Es el Incremento (%) de la configuración. No es un error: el recargo se
suma antes de crear el cobro, y tanto Webpay como el comprobante muestran el
total con recargo. En la lista de Cobros aparece desglosado. Si no quieres
recargo, deja ese campo en 0.
¿Quién puede configurar la pasarela? Quien tenga la sección Payku concedida en Roles y Permisos, incluido el administrador de tu propia instalación. No hace falta ser el proveedor.
¿Puedo cobrar en dólares u otras monedas? Depende de tu cuenta Payku. Por defecto trabaja en CLP.
¿Funciona en sandbox para pruebas?
Sí, con las credenciales de des.payku.cl puedes probar sin cobrar de verdad.
¿Otros procesadores de pago? La arquitectura de plugins permite agregar más pasarelas (Transbank directo, MercadoPago). Consulta con tu equipo técnico.
¿Qué sigue?
- POS Manager — para cobrar ventas presenciales.
- Formularios públicos — para captar el pedido antes del pago.