MakePay WISECP Gateway

The official MakePay WISECP gateway lets clients pay invoices through hosted crypto checkout. WISECP keeps control of clients, invoices, services, renewals, and provisioning. MakePay creates the checkout link and sends payment updates back to WISECP.

This is useful for hosting providers, SaaS teams, agencies, and service businesses that already run billing through WISECP.

Before You Start

You need:

• WISECP 3.1.7 or newer
• HTTPS WISECP installation
• Administrator access to WISECP payment gateway settings
• MakePay settlement and branding configured

Install The Gateway

Download the latest package:

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

Extract the ZIP and upload the MakePay folder to:

WISECP/coremio/modules/Payment/MakePay

In WISECP, open Settings > Billing > Payment Gateways, find MakePay, enable it, and save the module settings.

Connect MakePay

Open the MakePay gateway settings in WISECP and use the Connect MakePay link shown in the connection status field.

The connection flow:

1. Opens the MakePay connection page.
2. Lets you choose the company that should receive payments.
3. Returns you to WISECP after approval.
4. Saves the gateway connection for this WISECP installation.

After connecting, create a small test invoice and pay it from the client area.

Manual API Key Fallback

Connect MakePay is the recommended setup. Manual API-key setup is available for installations that cannot complete the guided connection.

For manual setup, set connection method to api_key and enter:

• MakePay company ID
• API key ID
• API key secret
• Webhook signing secret

Keep the callback URL generated by WISECP reachable from the public internet.

Checkout Flow

When a client chooses MakePay for a WISECP invoice, the gateway:

1. Reads the checkout ID, invoice amount, and currency from WISECP.
2. Creates a hosted MakePay payment link.
3. Shows a Pay with MakePay button.
4. Sends the client to hosted checkout.
5. Receives a signed callback when the payment status changes.

The payment link includes metadata such as:

Field	Purpose
source=wisecp	Identifies the integration
checkoutId	Maps MakePay activity back to the WISECP checkout
orderId	Uses the WISECP checkout ID for callback lookup

Invoice States

MakePay status	WISECP behavior
paid, completed, confirmed, succeeded	Marks the checkout successful
pending, waiting, confirming	Keeps the checkout pending
failed, expired, cancelled	Marks the checkout as error

WISECP remains responsible for service activation, renewals, invoice numbering, and client notifications after the invoice is paid.

Security Notes

Use HTTPS, keep WISECP administrator access limited, and disconnect the gateway from the MakePay dashboard if an administrator account or server backup is exposed. Reconnect after changing the WISECP domain so callback and return URLs match the live installation.

Troubleshooting

If Connect MakePay cannot start, confirm the gateway is installed under coremio/modules/Payment/MakePay and that the WISECP callback URL is public.

If invoices do not update, check that the webhook signing secret is present and that your server can receive HTTPS callbacks from MakePay.

If clients see a checkout error, confirm MakePay is connected and the selected invoice currency is supported by your MakePay setup.