Última actualización

Inicio rápido en Khipu

Sigue estos pasos para realizar tu primera integración con Khipu usando Pagos Instantáneos.

1. Crea una cuenta de cobrador

Primero, necesitas una cuenta en Khipu.

Una vez registrada, crea una cuenta de cobro y asóciala a una cuenta bancaria para recibir pagos.

2. Obtén tus credenciales

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.

3. Crea un cobro de prueba

Haz una solicitud HTTP POST al endpoint de Khipu:

POST https://khipu.com/api/3.0/payments

Encabezados:

Authorization: Basic {base64_encode(id_cobrador:clave_secreta)}
Content-Type: application/json

Cuerpo (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"
}

4. Redirige al usuario a pagar

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.

5. Espera la notificación del pago

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.

6. Verifica y pasa a producció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.

Anterior
Siguiente