# Cómo se integra

Integrar QuickPay son dos decisiones.

## 1. ¿Dónde paga tu cliente?

| Opción | Cómo | Para |
|---|---|---|
| **En la página de pago de QuickPay** (recomendado) | Creas un enlace y llevas al cliente a su `url` | Webs, apps, bots, correos: casi todo |
| **En tu propia pantalla** | Pides tú la clave del banco con la API directa | Sólo aliados con contrato → [API directa](/developers/api-directa) |

Con la página de QuickPay no manejas datos bancarios ni la clave del banco: sólo un `id` y una `url`.

## 2. ¿Cómo te enteras del pago?

| Opción | Cómo | Cuándo |
|---|---|---|
| **Webhook** (recomendado) | Te enviamos `link.pagado` a tu servidor, firmado | Siempre que puedas recibir un POST |
| **Consulta** | `GET /switch/v1/links/:id` hasta ver `pagado` | Como respaldo, o si no puedes recibir webhooks |

## El camino completo

```
Tu servidor ──POST /links──▶ QuickPay      (te devuelve id y url)
Tu cliente  ──abre la url──▶ página de pago (paga con la clave de su banco)
QuickPay    ──link.pagado──▶ tu servidor    (entregas el pedido)
```

> **La llave va sólo en tu servidor.** Nunca en el navegador, en una app móvil ni en un bot del lado del cliente: con ella cualquiera crearía cobros a tu nombre.

Empieza aquí: [Tu primer cobro en 5 minutos](/developers/quickstart)