Skip to main content

​
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

​
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

1

Abre el instalador de plugins

En WordPress, abre Plugins → Añadir plugin → Subir plugin.
2

Sube el ZIP

Selecciona launcherforge-commerce-for-woocommerce.zip.
3

Instala y activa

Instala el plugin y luego actívalo.
Subir el plugin de LauncherForge

​
2. Configurar la integración

Abre:
Configura: Configurar LauncherForge Commerce
No pegues solamente el prefijo visible. Un valor como lf_commerce_live_d122d2cc091f no es la API key completa.

​
3. Crear el producto

Abre:
Configuración recomendada: Crear un producto de juego en WooCommerce Vincular el producto con el App ID 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:
1

Crea un pedido

Abre WooCommerce → Pedidos → Añadir pedido.
2

Agrega el correo

Escribe un correo de facturación.
3

Agrega el producto

Añade el producto vinculado a LauncherForge.
4

Guarda el pedido

Guarda antes de cambiar el estado final.
5

Márcalo como Completado

Cambia el pedido a Completado y guarda nuevamente.
Marcar el pedido de prueba como Completado
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.
Key generada dentro del pedido El cliente también puede verla en:
Detalle del pedido del cliente con la key

​
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.
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.

​
Procesamiento en segundo plano

El plugin programa las entregas mediante WooCommerce Action Scheduler. Abre:
Busca:
Acción programada de LauncherForge Estados posibles:
  • Pendiente.
  • Completada.
  • Fallida.

​
Reintentar una entrega

Abre el pedido y usa:
El plugin reutiliza los identificadores idempotentes. Las unidades ya entregadas no vuelven a generarse.

​
Logs

Activa Debug logging en la configuración y abre:
Selecciona:
Logs del plugin LauncherForge 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.