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

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