WHMCS crypto payment integration checklist
This is an integration checklist for WHMCS billing flows that need crypto checkout, webhook-backed payment updates, support-visible invoice references, and finance reconciliation.
Implementation flow
- Create or load the WHMCS invoice and keep its ID as
order_id. - Create a SwapSS Pay invoice from your server. See invoices.
- Redirect the payer to the returned
payment_url. - Verify webhook signatures before marking a WHMCS invoice paid. See webhooks.
- Reload invoice state and use payment statuses before provisioning service.
- Store invoice, webhook, status, and ledger evidence for reconciliation.
WHMCS invoice mapping
| WHMCS value | SwapSS Pay value | Purpose |
|---|---|---|
| Invoice ID | order_id | Connects billing, support, and finance records. |
| Gateway redirect | payment_url | Sends the payer to the hosted crypto checkout. |
| Transaction note | Invoice public ID | Gives support a stable reference. |
| Service provisioning | Invoice status | Prevents activation before the payment is safe. |
Provisioning guard
Do not activate hosting, licenses, or subscriptions from a raw redirect alone. Verify the webhook, reload the invoice status, and provision only when the status page classifies the payment as safe for delivery.
Related docs: quickstart, webhook verification, statuses, and reconciliation.