Configurar la conexión con Stripe

Conecta tu cuenta de Stripe con el módulo Stripe de Beply para crear en el programa las facturas de los cobros que ya has recibido en Stripe. Al terminar tendrás una clave restringida con los permisos mínimos, guardada en Beply, y una cuenta lista para importar facturas.

Antes de empezar

• Necesitas acceso de administrador a tu cuenta de Stripe y el módulo Stripe activo en tu servicio de Beply (aparece Stripe en el menú superior del programa).
• Usa una clave restringida (empieza por rk_), no la clave secreta estándar (sk_): así Beply solo puede hacer lo que necesita.
• La clave es una credencial. No la envíes por correo ni chat, no la pegues en tickets y no la publiques en capturas. Si se expone, revócala en Stripe y crea otra.

1. Crear una clave restringida en Stripe

1. Inicia sesión en Stripe y abre Desarrolladores → Claves de API (dashboard.stripe.com/apikeys).
2. Comprueba que Modo de prueba está desactivado si vas a importar cobros reales.
3. En Claves restringidas, pulsa Crear clave restringida.
4. En Nombre de la clave, escribe un nombre que la identifique, por ejemplo Beply.

Ampliar

Permisos mínimos de la clave

Deja Ninguno en todos los recursos y activa solo estos permisos:

En Permisos de Connect, deja Ninguno en todos los recursos: el módulo trabaja con tu propia cuenta.

Crear y copiar la clave

1. Pulsa Crear clave.
2. Copia el valor que muestra Stripe y pégalo directamente en Beply (paso 2). No lo guardes en documentos compartidos.

Al volver a Claves restringidas verás la clave nueva con su nombre y el token enmascarado (solo el principio y los últimos caracteres). Ese valor enmascarado no sirve para conectar: si pierdes la clave completa, crea una nueva.

Ampliar

2. Guardar la clave en Beply

1. En el programa, abre Stripe → Ajustes.
2. En el primer bloque, rellena:
   • Nombre de la cuenta en Stripe: nombre interno para reconocer la cuenta (por ejemplo, Tienda online).
   • Clave secreta (sk_xxx): pega la clave restringida que acabas de crear. El campo admite también claves rk_.
   • Serie: serie de las facturas cuando el cliente no tenga una asignada.
3. Pulsa Guardar.
4. En el segundo bloque, indica Código del cliente por defecto, Código del producto por defecto, Email técnico para gestión de errores y si quieres Enviar email al cliente cuando se genere la factura. Pulsa Guardar.

Ampliar

Comprueba el resultado

• En Claves de Stripe dadas de alta aparece la cuenta con su nombre y su serie. Por seguridad, Beply no vuelve a mostrar la clave.
• Abre Stripe → Facturas, elige la cuenta y un intervalo de fechas y pulsa Consultar: si la clave y los permisos son correctos, verás las facturas pagadas pendientes de procesar.

Facturar automáticamente con el webhook (opcional)

Junto a cada cuenta, Beply muestra la ruta de su webhook (/WebhookStripe?source=...). El valor de source identifica tu cuenta: trátalo como un dato privado.

1. En Stripe, abre Desarrolladores → Webhooks y añade un destino.
2. Como URL, usa la dirección de tu servicio seguida de la ruta que muestra Beply, por ejemplo https://tuempresa.beply.es/WebhookStripe?source=<identificador-de-tu-webhook>.
3. Selecciona el evento invoice.payment_succeeded y guarda.

Cuando Stripe cobre una factura, Beply consultará el evento en Stripe con tu clave y creará la factura. Las facturas con importe pagado 0 no se facturan.

Si algo falla

Si el problema continúa, contacta con soporte indicando el nombre de la cuenta y la fecha del cobro. No envíes la clave.

Siguiente paso

• Importación de facturas con Stripe
• Vinculación de clientes de Stripe
• Vinculación de productos de Stripe