Sigue estos pasos para realizar tu primera integración con Khipu usando Pagos Instantáneos.
Primero, necesitas una cuenta en Khipu.
Una vez registrada, crea una cuenta de cobro y asóciala a una cuenta bancaria para recibir pagos.
Desde tu sesión privada en Portal Khipu, dirígite a:
- Opciones de la cuenta (en el menú lateral)
- Despliega la opción "Para integrar Khipu en tu sitio web"
- Obtén tu 'Id de cobrador' (identificador único)
- Obtén tu 'Nueva API key' (usa la de modo desarrollo para pruebas)
⚠️ Guarda tu clave secreta en un lugar seguro. Nunca la expongas públicamente.
Haz una solicitud HTTP POST
al endpoint de Khipu:
POST https://khipu.com/api/3.0/payments
Authorization: Basic {base64_encode(id_cobrador:clave_secreta)}
Content-Type: application/json
{
"subject": "Compra de prueba",
"amount": 1000,
"currency": "CLP",
"transaction_id": "pedido-1234",
"return_url": "https://tu-sitio.com/exito",
"cancel_url": "https://tu-sitio.com/cancelado",
"notify_url": "https://tu-sitio.com/notificacion"
}
La respuesta incluirá una URL:
"payment_url": "https://khipu.com/payment/show/..."
Redirige al usuario a esta URL para que realice el pago.
Una vez completado, Khipu lo enviará de vuelta a tu sitio mediante return_url
.
Khipu enviará un webhook a notify_url
con los detalles del pago.
Solo da por válido el pago cuando recibas y verifiques esta notificación.
Cuando todo funcione en pruebas, repite el proceso con tus credenciales de producción.
Asegúrate de tener activadas las notificaciones, la cuenta bancaria registrada y tu sitio accesible desde internet.
✅ ¡Listo! Ya puedes comenzar a recibir pagos con Khipu.