Description
SpectroCoin Payment Integration for WHMCS
SpectroCoin Payment Integration for WHMCS allows customers to pay eligible WHMCS invoices using Bitcoin through the SpectroCoin merchant checkout. The module creates a signed payment order containing the invoice amount and currency, then redirects the customer to SpectroCoin to complete the transaction.
After payment, the integration validates the signed SpectroCoin callback, checks the related WHMCS invoice and transaction reference, and automatically applies successfully confirmed payments.
Bitcoin Payments for WHMCS
- Add SpectroCoin as a payment option for eligible WHMCS invoices.
- Let customers complete payments using Bitcoin.
- Send the invoice total and billing currency to SpectroCoin.
- Create a separate merchant order for each unpaid invoice.
- Return customers through the configured success or cancellation flow.
Hosted SpectroCoin Checkout
- Redirect customers to the payment URL generated by SpectroCoin.
- Keep cryptocurrency payment instructions outside the local WHMCS card form.
- Display the amount, deposit information, and expiry through SpectroCoin.
- Provide a familiar Pay Now action from the WHMCS invoice.
- Avoid storing customer wallet credentials in WHMCS.
Signed Merchant Orders
- Sign outgoing merchant orders using the configured private merchant key.
- Include the Merchant ID and Project ID with each request.
- Send the invoice amount, currency, description, and return URLs securely.
- Use OpenSSL-based signatures for merchant API communication.
- Report order-creation errors when SpectroCoin rejects a request.
Verified Payment Callbacks
- Parse payment notifications returned by SpectroCoin.
- Validate merchant and project identifiers before processing callbacks.
- Verify callback signatures using the SpectroCoin public certificate.
- Reject malformed or invalid payment notifications.
- Process invoice payments only after receiving the paid status.
Automatic Invoice Updates
- Validate the WHMCS invoice before recording payment.
- Generate a unique WHMCS transaction reference from the SpectroCoin order ID.
- Check for duplicate transaction IDs.
- Apply confirmed payments to the corresponding invoice.
- Record received and payment-currency details in the WHMCS activity log.
Payment Status Handling
- New: The SpectroCoin payment order has been created.
- Pending: The payment is awaiting final processing or confirmation.
- Paid: The transaction is confirmed and applied to the invoice.
- Failed: The payment could not be completed.
- Expired: The payment order expired before successful completion.
- Test: Recognize test-status notifications without treating them as live payments.
Simple Merchant Configuration
- Configure the SpectroCoin Merchant ID.
- Enter the associated Project ID.
- Add the private merchant key used to sign payment requests.
- Manage the gateway from the WHMCS payment settings.
- Install the integration without modifying WHMCS core files.
Why Choose This Module?
- Accept Bitcoin: Give crypto customers another way to pay WHMCS invoices.
- Hosted Checkout: Let SpectroCoin provide the customer-facing payment page.
- Signed Communication: Protect merchant requests and validate payment callbacks.
- Automatic Processing: Apply confirmed payments to WHMCS invoices.
- Status Awareness: Distinguish new, pending, paid, failed, expired, and test orders.
- Transaction Tracking: Record SpectroCoin references and payment details in WHMCS.
Ideal For
- Web hosting and VPS providers
- SaaS and digital service businesses
- International online businesses
- Crypto-friendly WHMCS merchants
- Businesses with a SpectroCoin merchant project
Accept SpectroCoin Payments Through WHMCS
SpectroCoin Payment Integration for WHMCS combines Bitcoin checkout, signed merchant requests, hosted payment processing, callback validation, status handling, automatic invoice updates, and transaction tracking in one cryptocurrency payment workflow.




