# 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](https://khipu.com).

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](https://khipu.com/login), 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:


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

### Encabezados:


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

### Cuerpo (JSON):


```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:


```json
"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.**