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
- ✅ Balance Transactions
- ✅ Charges
- ✅ Checkout Sessions
- ✅ Customers
- ✅ Invoices
- ✅ Payment Intents
- ✅ Payment Links
- ✅ Payouts
- ✅ Products
- ✅ Subscriptions
Connect — Read
- ✅ All Connect resources (para identificar su cuenta de Stripe al conectarse)
Stripe clasifica la lectura de su propia cuenta en la sección Connect del editor de claves, aunque usted no utilice Stripe Connect: no existe una fila «Account». Order Invoicer solo lee su propia cuenta.
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 Clave de API restringida
- 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
Para sincronizar las liquidaciones de Stripe de una tienda ya conectada (WooCommerce, PrestaShop o Wix), abra Liquidaciones → Proveedores de pagos en el conector, haga clic en Conectar en la tarjeta de Stripe, pegue la clave y guarde. El formulario recuerda los permisos requeridos. Si sus pedidos ya se pagan con Stripe, la tarjeta aparece primero, en Sugeridos para este conector.
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 required permissions»
El mensaje enumera los permisos que faltan, con el nombre que tienen en el editor de claves de Stripe. Para añadirlos:
- Vuelva a Developers > API keys en Stripe
- Haga clic en Edit junto a su clave restringida
- Ponga cada permiso de la lista en el nivel indicado (Read o Write). All Connect resources se encuentra en la sección Connect: Stripe clasifica allí la lectura de su propia cuenta y no existe una fila «Account»
- 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 All Connect resources: 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