Integraciones
Conectar Stripe
Tus clientes pagan las facturas en línea a través de tu cuenta de Stripe; VentionDesk registra el pago.
Dónde se conecta
En VentionDesk, en Operaciones › Fuentes › «Añadir fuente», categoría Pagos, y después Stripe. Solo el propietario puede conectar, editar y quitar.
Paso a paso
- En Stripe, crea en Developers › API keys una clave restringida «VentionDesk». Necesita exactamente estos permisos; todo lo demás se queda en «None»: Checkout Sessions: Write (crea la página de pago); PaymentIntents: Read (comprueba qué queda pendiente antes de un reembolso); Charges: Read (lee lo que ya se ha reembolsado allí); Refunds: Write (reembolsos desde VentionDesk).
- Introduce aquí la clave y guarda. VentionDesk la comprueba consultando las checkout sessions; no se cobra nada. Se admite una clave de prueba (rk_test_…): entonces solo está el enlace de prueba en la factura, y el correo y el documento de la factura quedan sin enlace.
- Después, haz clic en «Mostrar la dirección del webhook» en «Operaciones» › «Fuentes» › Stripe y añádela en Stripe en Developers › Webhooks › «Add endpoint», con exactamente estos eventos: checkout.session.completed, checkout.session.async_payment_succeeded, checkout.session.async_payment_failed, charge.refunded.
- Copia el «Signing secret» del endpoint (whsec_…) y vuelve a guardar la conexión con la clave y el signing secret. Solo entonces aparece el enlace de pago en el correo y en el documento de la factura: sin webhook, un pago llegaría sin que VentionDesk lo registrara.
- El dinero va a tu cuenta de Stripe. VentionDesk registra cada pago y cada reembolso en la factura y solo envía a Stripe el número de factura, el importe y la dirección de correo del cliente.
Qué pide el diálogo
| Campo | Dato | De dónde |
|---|---|---|
| Clave restringida | Obligatorio | secreto | Developers › API keys › «Create restricted key» (rk_live_… o rk_test_…). Una secret key (sk_…) también funciona, pero puede hacerlo todo. |
| Signing secret del webhook | opcional | secreto | Aparece tras crear el endpoint en Developers › Webhooks › tu endpoint › «Signing secret» (whsec_…). Si lo dejas vacío, se conserva el anterior. |
VentionDesk guarda los datos secretos cifrados y no vuelve a mostrarlos nunca. Solo se guardan cuando el proveedor confirma el acceso; si editas una conexión y dejas vacío un campo secreto, se mantiene el valor anterior.
Todos los proveedores de un vistazo: IntegracionesDirecciones de webhook: Webhooks