Coinvay offers a WHMCS gateway module for USD invoices, with hosted checkout, saved invoice mappings and authenticated reconciliation. Install it on staging and verify your own provisioning, credit and partial-payment rules before accepting customer payments.
Install the supplied module carefully
Back up WHMCS and its database, review PHP and WHMCS compatibility in the package guide, and upload the supplied modules and includes directories without replacing core files. Enable Coinvay in Payment Gateways and configure the merchant API key and HTTPS gateway origin. The current module handles USD invoices; avoid automatic currency conversion that changes the meaning of the expected amount. Receiving wallets remain configured in the Coinvay merchant workspace.
Keep invoice and accounting identities aligned
When a customer chooses Pay with crypto, the module uses the server-provided outstanding balance and saves its Coinvay invoice mapping. A successful confirmation should create one accounting transaction for that mapped invoice. The WHMCS cron hook reconciles bounded batches of unapplied invoices. On a webhook-enabled plan, configure the callback URL and matching signing secret without overwriting another store’s postback unless you have an intentional routing layer.
Account for hosting-specific exceptions
Consider a renewal invoice whose balance changes because a customer applies account credit while crypto checkout is open. The original crypto invoice no longer describes the same outstanding amount; the module must require review rather than silently crediting an altered invoice. Test simultaneous callbacks and cron, cancelled invoices, wrong totals and failed provisioning hooks. Normal WHMCS renewal invoices still require separate customer payments. Automatic debits, refunds and business-specific service recovery are not supplied simply by installing the gateway files.
Practical checklist
- Review the current WHMCS module guide and configure a working system cron.
- Test exact outstanding balances, credits, partial payments and currency restrictions.
- Preserve the invoice mapping and accounting history when disabling or replacing the gateway.
Common questions
Will the module withdraw monthly hosting fees automatically?+
No. It connects normal invoices to checkout. The customer pays each invoice; Coinvay automatic token subscriptions are a separate contract-based flow.
Does a successful transaction guarantee service provisioning succeeds?+
No. A downstream provisioning hook can fail after payment. Use WHMCS recovery procedures and reconcile the accounting record before retrying service actions.
Sources and further reading
Primary references and Coinvay product documentation. Check the linked pages for current details.
AI-assisted drafting, published by Coinvay. Examples are illustrative. Read our editorial approach.