Gateway Wix Velo

Resumen

MakePay para Wix usa el plugin de servicio Payment Provider de Wix Velo. El merchant agrega cuatro archivos JavaScript de MakePay al editor Wix, instala crypto-js, conecta el proveedor de pago en Settings > Accept payments y guarda secretos API en Wix Secrets Manager.

En checkout, Wix llama createTransaction(). El archivo backend de MakePay crea un enlace de pago MakePay alojado y devuelve la URL de redirección a Wix. Cuando MakePay confirma el pago, un webhook firmado llama la función HTTP de Wix y el código registra el pago en el pedido Wix.

Antes de empezar

Necesitas:

• Una tienda Wix con Developer Mode habilitado
• Permiso para editar archivos backend Velo y service plugins
• Permiso para usar Wix Secrets Manager
• Una empresa MakeCrypto con liquidación MakePay configurada
• Una clave API MakePay con acceso para escribir enlaces de pago
• Un secreto de webhook MakePay para la empresa

Crear credenciales MakePay

En MakeCrypto:

1. Selecciona la empresa que recibirá pagos Wix.
2. Abre Wallet > Balances y configura liquidación.
3. Abre Integrations > API Integrations y crea una clave API.
4. Da a la clave al menos:
   • makepay:payment-links:read
   • makepay:payment-links:write
5. Copia el ID de empresa, ID de clave API y secreto de clave API.
6. Abre Merchant > Payment settings y rota o copia el secreto de webhook.

El secreto de clave API y el secreto de webhook se agregan a Wix Secrets Manager, no al código frontend.

Agregar archivos Wix Velo

Abre el repositorio fuente de MakePay para Wix:

https://github.com/makecryptoio/makepay-wix

El mismo código se mantiene en este monorepo bajo apps/plugins/wix.

En Wix:

1. Abre el editor del sitio y habilita Dev Mode.
2. En Public & Backend > Backend, crea:
   • MakePay.js
   • http-functions.js
3. En Service Plugins, crea un plugin Payment llamado MakePayPayment.
4. Copia:
   • MakePayPayment-config.js
   • MakePayPayment.js
5. Instala el paquete npm crypto-js desde Packages & Apps.
6. Publica el sitio.

Agregar secretos Wix

Abre Developer Tools > Secrets Manager y agrega:

Nombre del secreto	Valor
makepay_api_key_secret	El secreto de clave API MakePay
makepay_webhook_secret	El secreto de webhook MakePay

No pegues estos valores en código de página ni archivos frontend públicos.

Conectar MakePay en Wix

Abre Settings > Accept payments en el dashboard Wix y conecta el proveedor de pago personalizado MakePay.

Introduce:

Campo	Valor
MakePay company ID	ID de empresa MakeCrypto
MakePay API key ID	ID de clave API MakePay
Settlement currency	Normalmente USDT

El título del método de pago en checkout es:

Crypto Payment in USDT, BTC, ETH, LTC, DOGE and others

Configurar webhooks

El endpoint de función HTTP de Wix es:

https://your-wix-domain.com/_functions/makepay_notify

En MakeCrypto, abre Merchant > Payment settings y configura la URL de callback MakePay con ese endpoint. El secreto de webhook en Wix Secrets Manager debe coincidir con el secreto de webhook MakePay.

El handler de webhook de Wix verifica la cabecera X-MakePay-Signature antes de marcar cualquier pedido como pagado.

Probar checkout

1. Agrega un producto de bajo valor al carrito Wix.
2. Ve al checkout.
3. Elige el método de pago cripto MakePay.
4. Haz clic en Place Order & Pay.
5. Confirma que Wix redirige al checkout alojado MakePay.
6. Completa un pago de prueba.
7. Confirma que el pedido Wix queda marcado como pagado después de recibir el webhook.
8. Revisa Integrations > Webhook requests en MakeCrypto si el pedido no se actualiza.

Notas de seguridad

La integración Wix usa autenticación con clave API porque los archivos Velo de proveedor de pago copiados por el merchant todavía no soportan el flujo automático Connect MakePay.

Mantén estas reglas:

• Guarda secretos solo en Wix Secrets Manager.
• Usa una clave API específica de MakePay, no una clave interna amplia.
• No concedas scopes de envío de wallet ni gestión de claves API.
• Rota la clave API y el secreto de webhook si alguien con acceso antiguo al editor Wix ya no debe gestionar pagos.
• Mantén la URL de callback HTTPS y pública.

Solución de problemas

Si el proveedor no aparece en Accept payments, confirma que el service plugin se llame MakePayPayment, que existan los dos archivos del plugin y que el sitio se haya publicado después de agregar código.

Si Connect falla, confirma que makepay_api_key_secret exista en Wix Secrets Manager y que el ID de clave API/ID de empresa correspondan a la misma empresa MakeCrypto.

Si el checkout no redirige, inspecciona los logs de Wix Velo para el error de createTransaction y confirma que la clave API tenga makepay:payment-links:write.

Si los pedidos no se actualizan, confirma que la URL de callback de MakeCrypto sea https://your-wix-domain.com/_functions/makepay_notify, que el secreto de webhook coincida y que los logs de entrega de MakeCrypto muestren una respuesta 2xx.