> ## Documentation Index
> Fetch the complete documentation index at: https://docs.launcherforge.io/llms.txt
> Use this file to discover all available pages before exploring further.
# Integración con WooCommerce
> Instala el plugin de LauncherForge, vincula productos y entrega keys después de confirmar pedidos.
# Integración con WooCommerce
El plugin LauncherForge Commerce for WooCommerce conecta las órdenes de WooCommerce con la entrega de keys de LauncherForge.
WooCommerce administra el checkout, impuestos, métodos de pago, reembolsos y correos al cliente. LauncherForge genera la key. El plugin conecta ambos sistemas.
## Qué hace el plugin
```text theme={null}
La orden de WooCommerce queda pagada
↓
El plugin identifica productos vinculados a LauncherForge
↓
Solicita una key por cada unidad comprada
↓
LauncherForge devuelve la entrega y la key
↓
El plugin guarda el resultado en la orden
↓
WooCommerce incluye la key en los correos del cliente
```
## Requisitos
* WordPress con WooCommerce activo.
* Plugin LauncherForge Commerce for WooCommerce.
* Add-on Commerce API activo.
* Commerce API key completa.
* App ID de LauncherForge para cada producto.
* Protección mediante CD-Key habilitada en cada juego vinculado.
## 1. Instalar el plugin
En WordPress, abre **Plugins → Añadir plugin → Subir plugin**.
Selecciona `launcherforge-commerce-for-woocommerce.zip`.
Instala el plugin y luego actívalo.
## 2. Configurar la integración
Abre:
```text theme={null}
WooCommerce → Ajustes → Integraciones → LauncherForge Commerce
```
Configura:
| Campo | Valor |
| ------------------ | ----------------------------------------- |
| Enable integration | Activado |
| API base URL | `https://backend.launcherforge.io/api/v1` |
| Commerce API key | Secreto completo mostrado una sola vez |
| Debug logging | Activado temporalmente durante pruebas |
No pegues solamente el prefijo visible. Un valor como `lf_commerce_live_d122d2cc091f` no es la API key completa.
## 3. Crear el producto
Abre:
```text theme={null}
Productos → Añadir nuevo
```
Configuración recomendada:
| Campo | Valor |
| ---------------------- | -------------------------------- |
| Tipo de producto | Producto simple |
| Virtual | Activado |
| Descargable | No es necesario |
| Precio normal | Precio del juego |
| LauncherForge delivery | Activado |
| LauncherForge App ID | App ID numérico de LauncherForge |
Usa el App ID numérico esperado por Commerce API. No escribas el slug del juego.
## 4. Realizar una prueba manual
Para una prueba manual clara:
Abre **WooCommerce → Pedidos → Añadir pedido**.
Escribe un correo de facturación.
Añade el producto vinculado a LauncherForge.
Guarda antes de cambiar el estado final.
Cambia el pedido a **Completado** y guarda nuevamente.
Para pruebas manuales usa **Completado**. En un checkout real, el plugin también escucha la confirmación de pago y transiciones de órdenes pagadas, pero el proveedor de pago controla el flujo exacto de estados.
## 5. Verificar la entrega
Abre el pedido y comprueba:
* Una nota indicando que LauncherForge generó la key.
* La key debajo del producto de la orden.
* El delivery ID de LauncherForge.
* La nueva key dentro de LauncherForge.
El cliente también puede verla en:
```text theme={null}
Mi cuenta → Pedidos → Ver
```
## Entrega por correo
El backend de LauncherForge no envía el correo al comprador en las entregas externas.
El plugin de WooCommerce agrega las keys a los correos del pedido que WooCommerce envía al cliente.
```text theme={null}
Backend de LauncherForge
→ genera y devuelve la key
Plugin de WooCommerce
→ guarda la key en el pedido
WooCommerce
→ envía el correo al cliente
```
La instalación de WordPress debe poder enviar correos. Para producción configura un transporte de correo confiable o un plugin SMTP según tu hosting.
## Cantidades
Si el comprador adquiere cantidad `3`, el plugin solicita tres keys.
Cada unidad usa una idempotency key diferente, por lo que los reintentos no duplican licencias.
```text theme={null}
Orden 1001, ítem 72, unidad 1 → key 1
Orden 1001, ítem 72, unidad 2 → key 2
Orden 1001, ítem 72, unidad 3 → key 3
```
## Procesamiento en segundo plano
El plugin programa las entregas mediante WooCommerce Action Scheduler.
Abre:
```text theme={null}
WooCommerce → Estado → Acciones programadas
```
Busca:
```text theme={null}
lf_wc_fulfill_order
```
Estados posibles:
* Pendiente.
* Completada.
* Fallida.
## Reintentar una entrega
Abre el pedido y usa:
```text theme={null}
Acciones del pedido → Retry LauncherForge key delivery
```
El plugin reutiliza los identificadores idempotentes. Las unidades ya entregadas no vuelven a generarse.
## Logs
Activa **Debug logging** en la configuración y abre:
```text theme={null}
WooCommerce → Estado → Registros
```
Selecciona:
```text theme={null}
launcherforge-commerce
```
El plugin no escribe la Commerce API key ni las keys generadas en el log técnico.
## Problemas comunes
### No aparecen los campos de LauncherForge en el producto
Confirma que:
* WooCommerce esté activo.
* El plugin de LauncherForge esté activo.
* Estés editando un producto de WooCommerce.
### El pedido queda completado, pero no aparece la key
Confirma que:
* La integración esté habilitada.
* La API key completa esté guardada.
* LauncherForge delivery esté habilitado en el producto.
* El App ID sea numérico y correcto.
* La protección mediante CD-Key esté activa.
* El add-on Commerce API esté activo.
Luego revisa Acciones programadas y los logs de WooCommerce.
### `INVALID_COMMERCE_API_KEY`
La credencial guardada es inválida o contiene solamente el prefijo. Regenera la key en LauncherForge y copia el valor completo.
### `EXTERNAL_GAME_NOT_AVAILABLE`
El App ID es incorrecto, el juego pertenece a otro workspace o la protección mediante CD-Key está desactivada.
## Checklist para producción
* Usa primero una tienda de staging.
* Desactiva debug logging después de probar.
* Configura envío confiable de correos en WordPress.
* Prueba el método de pago real en modo sandbox.
* Verifica el correo y la página Mi cuenta.
* Prueba cantidades mayores que uno.
* Repite una actualización de estado para confirmar que no se duplican keys.
* Protege el acceso de administrador de WordPress.