MakePay XenForo Payment Provider

Overview

The official MakePay XenForo add-on adds hosted crypto checkout to XenForo payment profiles. XenForo creates the purchase request, MakePay creates the hosted payment link, and XenForo's payment callback handler completes the purchase after a signed MakePay webhook.

Use Connect MakePay for normal setup. Manual API-key credentials remain available as a fallback.

Before You Start

• XenForo 2.3 or newer
• PHP 8.1 or newer with OpenSSL enabled
• HTTPS forum/community URL
• Admin access to payment profiles
• A MakePay company where you can manage payment settings

Install The Add-On

Download the latest ZIP package:

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

Install it through XenForo's add-on archive installer or upload the upload/ directory contents to your XenForo root. The add-on ID is MakePay/Payment, and the source is installed at:

src/addons/MakePay/Payment

Connect MakePay

Go to Options > Service providers > Payment profiles > Add payment profile and choose MakePay. Save the profile once, reopen it, then choose Connect MakePay. The add-on:

1. Opens MakeCrypto in a browser tab.
2. Asks you to sign in and choose the company that should receive payments.
3. Shows the permissions needed by the XenForo payment provider.
4. Returns you to XenForo after approval.
5. Saves the connection in the payment profile options.
6. Configures the MakePay callback URL and webhook secret.

Configure MakePay

After connection finishes, keep Connection Method set to the default connected mode. Review:

• MakePay company ID
• Settlement currency
• Payment link expiration
• Webhook callback URL
• Manual API-key fallback credentials

Manual fallback requires a MakePay company ID, API key ID, API key secret, and webhook secret.

Checkout Flow

Add the MakePay payment profile to a XenForo user upgrade, paid resource, or another purchasable flow that supports payment profiles. When a member chooses MakePay, the add-on creates a MakePay payment link with XenForo metadata.

Field	Purpose
source=xenforo	Identifies the integration
orderId=xenforo_purchase_<requestKey>	Maps MakePay activity back to XenForo
requestKey	XenForo purchase request key
purchasableTypeId	XenForo purchasable type
moduleVersion	Installed MakePay add-on version
xenforoVersion	XenForo runtime version

The buyer is redirected to hosted MakePay checkout and returns to XenForo after payment or cancellation.

Payment States

MakePay sends signed callbacks to:

https://your-forum.example/payment_callback.php?_xfProvider=makepay

MakePay status	XenForo callback result
paid, completed, confirmed, succeeded	Payment received
failed, expired	Payment reversed
cancelled, canceled	Payment reversed
refunded	Payment reversed
Other statuses	Pending

XenForo records the payment provider log with the MakePay payment UID, purchase request key, payment URL when available, and the callback payload.

Security Notes

The add-on stores connection details in the payment profile options. Keep XenForo admin access limited to trusted operators, and disconnect the community in MakeCrypto if an administrator account or server backup is exposed.

The connection asks for these permissions:

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

Troubleshooting

If Connect MakePay cannot start, confirm the XenForo board URL is HTTPS and publicly reachable. If the Connect MakePay button is missing, save the payment profile once and reopen it. If purchases do not complete, compare the MakePay webhook callback URL with XenForo's payment_callback.php?_xfProvider=makepay URL and rotate the webhook secret.