Ir al contenido

Bienvenido a Payku Docs

En este espacio se encuentra todo lo necesario para que puedas integrar fácilmente Payku a tu comercio.

Si estás interesado en implementar este medio de pago, infórmate en Payku.com y solicita una demo 👍
  1. Elige tu país — la API es la misma; cambian los medios de pago, la moneda y algunos campos: 🇨🇱 Chile · 🇵🇪 Perú · 🇻🇪 Venezuela.
  2. Obtén tus credenciales — al registrarte en app.payku.cl recibes un token público y un token privado. El público se envía como Authorization: Bearer TOKEN en tus llamadas a la API; el privado es la clave secreta con la que se calcula la firma Sign y nunca se envía directamente. Ver Autenticación.
  3. Prueba sin riesgo — usa el servidor sandbox https://des.payku.cl/ y el ambiente de pruebas; en Chile tienes además tarjetas de prueba Webpay/Oneclick. Ver Acceso a la API.
  4. Crea tu primer pago (PayIn) — con POST /api/transaction generas una orden y recibes la URL de pago para redirigir al pagador. Ver Transacción.
  5. Recibe la confirmación — al completarse el pago, Payku notifica a tu urlnotify (webhook) y puedes verificar el estado con GET /api/transaction/{id}. Importante: revisa siempre el campo status del JSON, no solo el código HTTP.
  6. Firma las operaciones que lo requieren — suscripciones, anulaciones, mall y pagos a terceros usan el header Sign (HMAC-SHA256 con tu token privado). Ver Firma.
  7. Paga a terceros (PayOut) — envía dinero desde tu wallet con POST /api/wallet/payout. Ver Wallet.

🚀 ¿Prefieres probar antes de escribir código? Descarga la colección de Postman de tu país (enlace en cada introducción) junto al entorno: trae todos los endpoints con cuerpos de ejemplo y calcula la firma Sign por ti.

🤖 ¿Integras con IA? Descarga la documentación completa en Markdown (también disponible por país en cada introducción) y úsala como contexto para tu asistente.