Saltar al contenido principal

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​

  1. Necesitas una cuenta de comercio en Payku (payku.cl).
  2. Obtén tu token desde des.payku.cl (sandbox) o app.payku.cl (producción).
  3. Registra el plugin payku.
  4. Configura desde la página del plugin en el CMS.

Configuración inicial​

En el CMS → Payku → Configuración:

  1. Activa Activar Plugin Payku.
  2. Plataforma: elige Sandbox para pruebas o Producción para vender de verdad. Cada plataforma requiere su propio token.
  3. Modo de acceso: Ingresar directamente a Webpay Plus.
  4. 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 de des.payku.cl.
    • Si eliges Producción, usa un token de app.payku.cl.
  5. Token Marketplace (opcional): solo para usuarios marketplace.
  6. Incremento (%): para aumentar el valor final de la orden (0 para no aumentar).
  7. Estado del Pago Exitoso: a qué estado del workflow pasa la orden cuando el pago se aprueba (ej. entregado, pagado).
  8. Guarda.
  9. 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.
  10. Prueba una compra completa en Sandbox antes de pasar a producción.

:::warning Un token por plataforma 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. :::

Cómo se usa día a día​

Desde el CMS (por ejemplo, en una venta o cotización), botón Generar link de pago → crea una URL única que envías por WhatsApp, email o SMS.

Recibir la confirmación​

Cuando el cliente termina el pago, Payku hace un webhook a tu sistema. El plugin:

  • Verifica que el pago realmente ocurrió (contra la API de Payku).
  • Marca la venta / cotización como pagada.
  • Cambia el estado configurado (ej. de pendiente a pagado).
  • Puede disparar acciones adicionales (email de confirmación).

Es asíncrono: aunque el cliente cierre el navegador, la confirmación llega al webhook y se procesa.

Consultar pagos​

En Pagos ves el historial: monto, cliente asociado, estado (pendiente, pagado, fallido, reembolsado), fecha.

Debug Logging​

Puedes activar Activar Debug Logging durante desarrollo para tener trazas detalladas del flujo. Desactívalo en producción para mejorar el rendimiento.

Se conecta con​

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). El webhook actualizará el estado en tu sistema.

¿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?​