Configurar Stripe
Cree una clave restringida de Stripe y conecte sus pagos a Order Invoicer
Requisitos previos
Antes de comenzar, asegúrese de que:
- Dispone de una cuenta de Stripe activa (modo de prueba o real)
- Tiene acceso de administrador al panel de control de Stripe
- Su cuenta de Stripe ha aceptado las Condiciones de servicio de Stripe (de lo contrario, los Payment Links no están habilitados)
Order Invoicer utiliza una clave de API restringida (prefijo rk_test_ o rk_live_). No se requiere la instalación de ninguna aplicación de Stripe Connect: usted conserva el control total de la clave y puede revocarla en cualquier momento desde su panel de control de Stripe.
Crear una clave restringida
Ir a las claves de API de Stripe
- Inicie sesión en dashboard.stripe.com
- Seleccione la cuenta (o sandbox) que desea conectar
- Vaya a Developers > API keys
- Desplácese hasta Restricted keys y haga clic en + Create restricted key
Asignar un nombre a la clave
Utilice un nombre descriptivo, por ejemplo Order Invoicer — Payment Links. El nombre solo es visible en su panel de control de Stripe; le ayuda a encontrar la clave si alguna vez necesita revocarla.
Activar los permisos necesarios
Order Invoicer necesita los siguientes permisos para sincronizar los Payment Links y crear las facturas correspondientes:
Read
- ✅ Account (para identificar su cuenta de Stripe al conectarse)
- ✅ Balance Transactions
- ✅ Charges
- ✅ Checkout Sessions
- ✅ Customers
- ✅ Payment Intents
- ✅ Payment Links
- ✅ Payouts
- ✅ Products
Write
- ✅ Webhook Endpoints (Order Invoicer crea el webhook automáticamente al conectarse)
Todos estos permisos son obligatorios. Si falta alguno, Order Invoicer rechazará la clave con un mensaje que indica el permiso que falta: simplemente añádalo e inténtelo de nuevo.
Generar y copiar la clave
- Haga clic en Create key
- Stripe muestra la clave una sola vez: cópiela de inmediato
- Comienza por
rk_live_(modo de producción) ork_test_(modo de prueba)
La clave deja de ser visible después de cerrar la ventana. Si la pierde, cree una nueva y revoque la antigua.
Introducir la clave en Order Invoicer
- En Order Invoicer, seleccione Stripe como plataforma de comercio electrónico
- Pegue la clave restringida en el campo Restricted API key
- Haga clic en Siguiente
Order Invoicer:
- Verificará la clave leyendo la información de su cuenta de Stripe
- Registrará automáticamente un webhook en su cuenta de Stripe (para recibir los eventos
checkout.session.completed,checkout.session.async_payment_succeededycharge.refunded) - Iniciará una primera sincronización de sus Payment Links existentes
Resolución de problemas
«La clave no se reconoce» / Credenciales no válidas
- Compruebe que la clave comienza efectivamente por
rk_test_ork_live_(las claves publishablepk_…y las claves secretsk_…no funcionan para este flujo) - Asegúrese de haber copiado la clave completa, sin espacios al principio ni al final
- Compruebe que la clave no haya sido revocada del panel de control de Stripe
«Restricted key is missing the 'Account: Read' permission»
La clave se creó sin el permiso Account → Read. Stripe no lo incluye de forma predeterminada, por lo que debe añadirse explícitamente:
- Vuelva a Developers > API keys en Stripe
- Haga clic en Edit junto a su clave restringida
- Active Account: Read
- Guarde e intente de nuevo la conexión en Order Invoicer
«Failed to create Stripe webhook endpoint»
La clave no tiene permiso para escribir webhooks. Edite la clave y active Webhook Endpoints: Write, luego inténtelo de nuevo.
Probar la clave manualmente
Puede verificar que una clave restringida funciona con cURL:
curl https://api.stripe.com/v1/account \
-u "rk_test_votre_cle:"Una respuesta JSON que describe su cuenta (con "id": "acct_...") confirma que la clave es válida y tiene el permiso Account: Read.
Seguridad
- La clave restringida se almacena cifrada del lado de Order Invoicer
- Puede revocarla en cualquier momento desde Developers > API keys en Stripe: la conexión se interrumpirá de inmediato
- Order Invoicer no realiza ninguna operación de escritura en su cuenta de Stripe aparte de la creación inicial del webhook
Soporte
Si tiene dificultades:
- Consulte la sección de resolución de problemas anterior
- Compruebe el estado de Stripe en status.stripe.com
- Póngase en contacto con nuestro soporte:
contact@orderinvoicer.com