Plugin de WordPress

Resumen

MakePay para WooCommerce permite que tu tienda acepte pagos cripto mediante el checkout alojado MakePay. Los clientes eligen el método de pago MakePay en WooCommerce, son redirigidos a MakePay para pagar y vuelven a tu tienda después del checkout.

El plugin crea un enlace de pago MakePay para cada pedido WooCommerce y escucha webhooks firmados de MakePay para que el estado del pedido WooCommerce se actualice automáticamente. Soporta tanto el checkout clásico de WooCommerce como WooCommerce Checkout Blocks.

Antes de empezar

Necesitarás:

• WordPress 6.7 o superior
• WooCommerce 10.x
• PHP 7.4 o superior con OpenSSL habilitado
• URL HTTPS para admin de WordPress y checkout
• Una cuenta admin de WordPress que pueda gestionar WooCommerce
• Una empresa MakeCrypto con liquidación MakePay configurada

PHP Sodium es recomendado. Cuando está disponible, el plugin lo usa con tus salts de WordPress para cifrar credenciales de conexión y webhook guardadas.

Configurar MakeCrypto

Completa la configuración de merchant en MakeCrypto antes de conectar WooCommerce.

1. Inicia sesión en https://www.makecrypto.io y selecciona la empresa que recibirá pagos WooCommerce.
2. Abre Wallet > Balances, luego elige Set up settlement o Edit settlement. Selecciona moneda de liquidación, cadena y wallet de destino. Guarda la configuración.
3. Abre Merchant > Payment settings. Elige si las comisiones de pago las paga el merchant o el cliente.
4. Revisa los ajustes de redirección posteriores al pago. WooCommerce envía URLs específicas de retorno, éxito y fallo para pedidos de checkout, así que la mayoría de tiendas pueden dejar vacíos los campos globales salvo que quieran una página fallback.
5. Configura las reglas permitidas de underpayment. Una pequeña tolerancia puede ayudar con comisiones de red y variación de cotización, mientras que un ajuste estricto requiere que el cliente pague el importe completo.
6. Opcional: abre Settings > Merchant para agregar nombre de merchant, email de soporte, logo, colores de checkout, tema de pago alojado y dominios personalizados.

No necesitas crear una aplicación de desarrollador para WooCommerce. El plugin oficial crea una conexión específica de tienda cuando haces clic en Connect MakePay.

Instalar el plugin

Descarga el ZIP oficial más reciente:

https://plugins.makecrypto.io/downloads/wordpress/latest.zip

Luego instálalo en WordPress:

1. En WordPress admin, abre Plugins > Add New Plugin.
2. Haz clic en Upload Plugin y elige el ZIP descargado.
3. Haz clic en Install Now, luego en Activate Plugin.
4. Abre WooCommerce > Settings > Payments > MakePay.

Si WooCommerce no está activo, WordPress mostrará un aviso y el gateway no estará disponible en checkout.

Conectar tu tienda

Usa Connect MakePay para la configuración normal. Enlaza esta tienda WooCommerce con la empresa MakeCrypto que elijas y puede desconectarse después sin cambiar código de tienda.

1. En WooCommerce > Settings > Payments > MakePay, conserva Authentication en el modo conectado predeterminado.
2. Conserva MakePay portal URL en https://www.makecrypto.io salvo que soporte de MakePay te indique otra URL.
3. Haz clic en Connect MakePay.
4. Inicia sesión en MakeCrypto si se solicita, elige la empresa preparada y aprueba el acceso.
5. Al volver a WordPress, confirma que la página de ajustes de MakePay indique que la tienda está conectada y muestre el final del secreto de webhook configurado.
6. Habilita MakePay payments y haz clic en Save changes.

Durante la conexión, el plugin registra automáticamente el endpoint de webhook de la tienda en MakePay:

https://your-store.example/?wc-api=makecrypto_makepay

Mantén este endpoint accesible desde internet público. Plugins de seguridad, firewalls y reglas de caché deben permitir solicitudes POST a esa URL.

Cómo funciona la conexión

El botón Connect MakePay abre MakeCrypto en una pestaña del navegador. Inicias sesión, eliges la empresa que recibirá pagos, revisas el acceso solicitado y vuelves a WordPress tras aprobar. El plugin guarda la conexión, registra la URL de webhook y usa esa empresa para pedidos de checkout.

No se requiere secreto compartido de app ni configuración de app de desarrollador para WooCommerce.

Configuración del gateway

Revisa estos ajustes en WooCommerce > Settings > Payments > MakePay.

Ajuste	Qué hace
Enable/Disable	Activa o desactiva el método de pago MakePay en checkout.
Title	Nombre del método de pago que ven los clientes, por ejemplo Crypto payment.
Description	Texto de ayuda mostrado bajo el método de pago durante checkout.
MakePay portal URL	Entorno MakePay. Usa https://www.makecrypto.io en producción.
Checkout experience	Usa Hosted redirect para el flujo más fiable, o Embedded checkout page para mostrar MakePay en una página iframe segura con fallback alojado.
Authentication	Usa el modo conectado predeterminado para instalaciones normales. Manual API key fallback es para recuperación avanzada o configuración guiada por soporte.
Company ID	Solo requerido para modo con clave API manual.
API key ID	Solo requerido para modo con clave API manual.
API key secret	Solo requerido para modo con clave API manual. Guárdalo cuidadosamente porque autoriza acceso API.
Settlement currency symbol	Símbolo de liquidación preferido para pedidos WooCommerce, como USDT. MakePay resuelve la cadena desde el predeterminado de empresa cuando es posible.
Payment link expiration	Cuánto tiempo permanece pagable el enlace de checkout alojado. Opciones: 15 minutos, 1 hora, 12 horas, 24 horas y 72 horas.

El símbolo de moneda de liquidación debe coincidir con el activo de destino configurado en MakeCrypto. Si el mismo símbolo existe en varias cadenas, MakePay usa la cadena predeterminada de la empresa cuando puede resolverla.

Probar checkout

Ejecuta una prueba de checkout real antes de anunciar el nuevo método de pago.

1. En WooCommerce, crea un producto de prueba pequeño o usa un artículo existente de bajo valor.
2. Realiza un pedido desde el storefront y elige el método de pago MakePay.
3. Confirma que WooCommerce abra la experiencia de checkout seleccionada.
4. Completa o cancela el pago.
5. Abre el pedido WooCommerce y revisa las notas de pedido para actividad de webhook MakeCrypto.
6. En MakeCrypto, abre Merchant > Payments para revisar el enlace de pago generado y su estado.

Cuando se crea un pago, WooCommerce marca el pedido como pendiente con la nota Awaiting MakePay payment. Los estados MakePay pagados o confirmados marcan el pedido como pagado. Pagos fallidos o expirados marcan el pedido como fallido. Pagos cancelados marcan el pedido como cancelado. Otras actualizaciones en progreso ponen el pedido en espera.

Seguridad y permisos

La conexión WordPress solicita:

• company:read
• makepay:payment-links:read
• makepay:payment-links:write
• makepay:customers:read
• makepay:customers:write
• makepay:settings:read
• makepay:settings:write

No puede enviar fondos de wallet ni crear claves API legacy.

Las actualizaciones de webhook están firmadas por MakePay y verificadas por el plugin antes de cambiar cualquier pedido WooCommerce. Los administradores de tienda pueden revocar la conexión en MakeCrypto bajo Integrations > Connected apps, o desconectarla desde la página de ajustes WooCommerce MakePay.

Alternativa con clave API manual

Usa modo con clave API manual solo si Connect MakePay no está disponible o soporte de MakeCrypto te pide usarlo.

1. En MakeCrypto, abre Integrations > API Integrations.
2. Crea o elige una clave API MakePay para la misma empresa que recibe pagos de tienda.
3. Copia ID de empresa, ID de clave API y secreto de clave API.
4. En WordPress, abre WooCommerce > Settings > Payments > MakePay.
5. Establece Authentication en Manual API key fallback.
6. Pega ID de empresa, ID de clave API y secreto, luego guarda.

Mantén secretos de clave API fuera de archivos de tema, scripts del cliente y tickets públicos de soporte. Connect MakePay sigue siendo preferido para operación normal de tienda.

Solución de problemas

Si Connect MakePay falla, confirma que tu URL de admin de WordPress use HTTPS, que tu tienda pueda hacer solicitudes HTTPS salientes a https://www.makecrypto.io y que tu sesión admin tenga permiso para gestionar WooCommerce.

Si el gateway no aparece en checkout, confirma que el plugin esté activo, WooCommerce esté activo, MakePay payments esté habilitado y la tienda esté conectada a MakePay o tenga credenciales manuales válidas.

Si checkout muestra un error de liquidación u onboarding, vuelve a MakeCrypto y completa Wallet > Balances > Set up settlement para la empresa conectada a la tienda.

Si los pedidos no se actualizan después del pago, revisa Integrations > Webhook requests en MakeCrypto. El endpoint WordPress debe devolver una respuesta 2xx. Comprueba también que plugins de seguridad o firewalls de hosting no bloqueen solicitudes POST a /?wc-api=makecrypto_makepay.

Si cambias el dominio de la tienda, URL de admin de WordPress o mueves el sitio a un nuevo entorno, desconecta y vuelve a conectar MakeCrypto para que el callback de conexión y la URL de webhook coincidan con la tienda actual.