What Web321 Site Register does
Web321 Site Register adds a guided “find a domain, pay, register it, set up hosting” flow to your WordPress site. It does four jobs:
- Domain search. Type a business name or an exact domain and see live availability across the extensions you choose.
- Payment. Optionally take payment through Stripe Checkout before anything is registered or created. One payment covers one domain and its hosting account.
- Domain registration. Register an available domain through your Namecheap account, with the owner’s contact details collected in a short form.
- Hosting set-up. Create a cPanel hosting account for the domain on your WHM server, and get the username, password, server IP and nameservers back.
The plugin stops once the hosting account exists. It does not install WordPress or upload a website to the new account.
Setup steps
- In your Namecheap account, turn on API access (Profile » Tools » API Access) and whitelist the public IPv4 address of the server this site runs on.
- In WHM, go to Development » Manage API Tokens and create a token. It needs permission to create and suspend accounts and to list packages.
- In WordPress admin, open Site Register » Settings. Enter the Namecheap details, your nameservers, the default contact, and at least one WHM host.
- Save, then use the Test Namecheap and Test connection buttons in the sidebar to confirm both services answer.
- Open Site Register » New Site to run the flow yourself, or add the
shortcode to any page.Find a domain
Type a business name for ideas, or the exact domain you want. Availability is checked live.
Domain Status Action Choose a plan for
Your plan covers this domain and its hosting. You pay on our secure Stripe page, then come straight back here to finish.
Register
Provide accurate contact details for the domain owner. They must match the registrant's official mailing address.
Set up hosting for
Make sure the domain uses these nameservers:
DNS changes can take several hours to reach everyone.
All set
Copy the password now. It is shown once and is not stored.
- Decide who may register domains and create hosting under Access. Leave it on “Administrators only” until Stripe is set up.
Taking payment with Stripe
- In Stripe, create a product for your hosting plan with up to three prices (for example monthly, yearly and three-year). Recurring and one-time prices both work. Copy each price ID; they start with
price_. - In Site Register » Settings » Stripe, enter your secret key and the price IDs. Use test keys (
sk_test_) and test prices first. - In Stripe, go to Developers » Webhooks and add an endpoint using the webhook address shown in the settings. Subscribe it to
checkout.session.completed,checkout.session.async_payment_succeeded,customer.subscription.updatedandcustomer.subscription.deleted. Paste its signing secret (it starts withwhsec_) into the settings. - Turn on Stripe’s customer portal (Settings » Billing » Customer portal) so customers can update a card or cancel.
- Save, press Test Stripe, then set “Who can register and set up hosting” to Logged-in users, after Stripe payment.
- Add
to a public page, andFind a domain
Type a business name for ideas, or the exact domain you want. Availability is checked live.
Domain Status Action Choose a plan for
Your plan covers this domain and its hosting. You pay on our secure Stripe page, then come straight back here to finish.
Register
Provide accurate contact details for the domain owner. They must match the registrant's official mailing address.
Set up hosting for
Make sure the domain uses these nameservers:
DNS changes can take several hours to reach everyone.
All set
Copy the password now. It is shown once and is not stored.
to a page where customers can see their plans and open the billing portal.
Customers must be logged in to pay, so that the payment can be tied to their account. Administrators using Site Register » New Site are never asked to pay.
Configuration reference
| Setting | What it does | Default |
|---|---|---|
| API user / Username | Your Namecheap account name. Both are normally the same value. | Empty |
| API key | The key from Namecheap’s API Access page. Can be set in wp-config.php as W321SR_NC_API_KEY instead. |
Empty |
| Whitelisted server IP | The IPv4 address Namecheap sees your requests coming from. It must match an address whitelisted in Namecheap. | Empty |
| Use the Namecheap sandbox | Sends requests to Namecheap’s test system so nothing is bought. Needs separate sandbox credentials. | Off |
| Registration length | Years each new domain is registered for. | 1 |
| WHOIS privacy | Adds Namecheap’s free privacy protection where the extension supports it. | On |
| Allow premium domains | Lets premium-priced names be registered. Leave off to avoid unexpectedly large charges. | Off |
| Nameservers | Set on newly registered domains and shown to customers linking a domain they already own. | Empty |
| Extensions to suggest | The endings used when building suggestions from a business name. | com, ca, net, org, co |
| Default contact | Technical, admin and billing contact sent with every registration. If any part is blank, the registrant’s details are used. | Empty |
| WHM hosts | Up to three servers (primary, secondary, tertiary), each with an address, WHM user and API token. Tokens can be set in wp-config.php as W321SR_WHM_PRIMARY_TOKEN, W321SR_WHM_SECONDARY_TOKEN and W321SR_WHM_TERTIARY_TOKEN. |
Empty |
| Active host | The server new hosting accounts are created on. Switch it to fail over to another server. | Primary |
| Default package | The WHM package applied to new accounts. Blank uses the server default. | Empty |
| Stripe secret key | Your Stripe API key. Can be set in wp-config.php as W321SR_STRIPE_SECRET_KEY instead. |
Empty |
| Webhook signing secret | Lets the site trust messages from Stripe about completed payments and cancelled subscriptions. Can be set as W321SR_STRIPE_WEBHOOK_SECRET. |
Empty |
| Monthly / Yearly / Three-year price ID | The Stripe prices offered at checkout. Leave a plan blank to hide it. | Empty |
| Suspend hosting when a subscription ends | Suspends the cPanel account when Stripe reports the subscription cancelled or unpaid. Nothing is deleted. | On |
| Who can search | Everyone, logged-in users, or administrators only. | Everyone |
| Who can register and set up hosting | Administrators only; logged-in users after Stripe payment; or any logged-in user with no payment. | Administrators only |
| Search limit | Searches allowed per visitor in ten minutes. | 30 |
| Remove data on uninstall | Deletes settings, records and this page when the plugin is deleted. | Off |
Troubleshooting
- “Invalid request IP” from Namecheap. The whitelisted IP in settings does not match the address Namecheap sees. Ask your host for the server’s outgoing IPv4 address and whitelist that one.
- Every domain shows “Unknown”. Namecheap did not answer the check. Run Test Namecheap; administrators see the exact error.
- Registration fails for .ca, .us, .eu or .uk. These extensions need extra registrant information that the form does not collect. A developer can add it through the
w321sr_namecheap_create_paramsfilter. - WHM says the token is a cPanel token. The token was created inside a cPanel account. Create it in WHM itself.
- Certificate errors talking to WHM. If the WHM address is an IP or uses a self-signed certificate, untick “Verify SSL certificate” for that host.
- The hosting step times out. Account creation can take a couple of minutes. Check WHM before retrying: the account may already exist.
- A customer paid but was not moved on to registration. Their payment is kept as an unused plan. When they return to the page and pick a domain, they carry on without paying again. If the payment never shows under Records, check the webhook endpoint in Stripe for failed deliveries.
- Cancelled subscriptions are not suspending hosting. The webhook signing secret is missing or wrong, or the endpoint is not subscribed to the subscription events. Test Stripe reports a missing secret.
- “No such price” from Stripe. The price ID belongs to the other mode. Test keys only work with test prices, and live keys with live prices.
- The cPanel password was lost. It is shown once and never stored. Reset it from WHM under Account Functions » Password Modification.
FAQ
Who pays for a registered domain?
Your Namecheap account balance is charged for the domain. With Stripe payment turned on, the customer pays you first and the domain is included in their plan, so price your plans to cover it.
Can customers register domains themselves?
Yes. Set “Who can register and set up hosting” to “Logged-in users, after Stripe payment” and place the shortcode on a page.
What happens if the domain a customer paid for cannot be registered?
Their payment stays on their account as an unused plan and they can choose a different domain straight away. Refunds are handled in your Stripe dashboard.
What happens when a customer cancels?
When Stripe reports the subscription has ended, the hosting account is suspended (not deleted). The domain itself stays registered until it expires. An administrator can unsuspend the account from Records.
Can I use a domain that is registered somewhere else?
Yes. Choose “Use a domain you already own”, then point the domain at the nameservers shown.
Does it install a website?
No. Developers can hook w321sr_hosting_provisioned to run their own installer once the account exists.
Where are the records kept?
Payments, registered and linked domains, and the hosting accounts created, are listed under Site Register » Records. Hosting accounts can be suspended and reactivated from there.
Need help?
Contact Web321 at [email protected] or (844) 493-2321, or visit web321.ca.