Wix Velo gateway

Overview

MakePay for Wix uses Wix Velo's Payment Provider service plugin. The merchant adds four MakePay JavaScript files to the Wix editor, installs crypto-js, connects the payment provider in Settings > Accept payments, and stores API secrets in Wix Secrets Manager.

At checkout, Wix calls createTransaction(). The MakePay backend file creates a hosted MakePay payment link and returns the redirect URL to Wix. When MakePay confirms payment, a signed webhook calls the Wix HTTP function and the code records the payment on the Wix order.

Before you start

You will need:

• A Wix store with Developer Mode enabled
• Permission to edit Velo backend files and service plugins
• Permission to use Wix Secrets Manager
• A MakeCrypto company with MakePay settlement configured
• A MakePay API key with payment-link write access
• A MakePay webhook secret for the company

Create MakePay credentials

In MakeCrypto:

1. Select the company that should receive Wix payments.
2. Open Wallet > Balances and configure settlement.
3. Open Integrations > API Integrations and create an API key.
4. Give the key at least:
   • makepay:payment-links:read
   • makepay:payment-links:write
5. Copy the company ID, API key ID, and API key secret.
6. Open Merchant > Payment settings and rotate or copy the webhook secret.

The API key secret and webhook secret are added to Wix Secrets Manager, not to frontend code.

Add Wix Velo files

Open the MakePay Wix source repository:

https://github.com/CHASH-HOSTING/makepay-wix

The same source is maintained in this monorepo under apps/plugins/wix.

In Wix:

1. Open the site editor and enable Dev Mode.
2. Under Public & Backend > Backend, create:
   • MakePay.js
   • http-functions.js
3. Under Service Plugins, create a Payment plugin named MakePayPayment.
4. Copy:
   • MakePayPayment-config.js
   • MakePayPayment.js
5. Install the crypto-js npm package from Packages & Apps.
6. Publish the site.

Add Wix secrets

Open Developer Tools > Secrets Manager and add:

Secret name	Value
makepay_api_key_secret	The MakePay API key secret
makepay_webhook_secret	The MakePay webhook secret

Do not paste these values into page code or public frontend files.

Connect MakePay in Wix

Open Settings > Accept payments in the Wix dashboard and connect the custom MakePay payment provider.

Enter:

Field	Value
MakePay company ID	The MakeCrypto company ID
MakePay API key ID	The MakePay API key ID
Settlement currency	Usually USDT

The checkout payment method title is:

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

Configure webhooks

The Wix HTTP function endpoint is:

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

In MakeCrypto, open Merchant > Payment settings and set the MakePay callback URL to that endpoint. The webhook secret in Wix Secrets Manager must match the MakePay webhook secret.

The Wix webhook handler verifies the X-MakePay-Signature header before it marks any order as paid.

Test checkout

1. Add a low-value product to your Wix cart.
2. Go to checkout.
3. Choose the MakePay crypto payment method.
4. Click Place Order & Pay.
5. Confirm that Wix redirects to hosted MakePay checkout.
6. Complete a test payment.
7. Confirm the Wix order is marked paid after the webhook is received.
8. Check Integrations > Webhook requests in MakeCrypto if the order does not update.

Security notes

The Wix integration uses API-key authentication because merchant-copied Velo payment provider files do not support the automatic Connect MakePay flow yet.

Keep these rules:

• Store secrets only in Wix Secrets Manager.
• Use a MakePay-specific API key, not a broad internal key.
• Do not grant wallet-send or API-key-management scopes.
• Rotate the API key and webhook secret if anyone with old Wix editor access should no longer manage payments.
• Keep the callback URL HTTPS and public.

Troubleshooting

If the provider does not appear in Accept payments, confirm that the service plugin is named MakePayPayment, the two plugin files exist, and the site has been published after adding code.

If Connect fails, confirm that makepay_api_key_secret exists in Wix Secrets Manager and that the API key ID/company ID match the same MakeCrypto company.

If checkout does not redirect, inspect Wix Velo logs for the createTransaction error and confirm the API key has makepay:payment-links:write.

If orders do not update, confirm MakeCrypto callback URL is https://your-wix-domain.com/_functions/makepay_notify, the webhook secret matches, and MakeCrypto webhook delivery logs show a 2xx response.