Website verification fails
If website verification fails, first confirm the WPLinker Connector plugin is installed and active. Open the WPLinker page inside WordPress and make sure the connection status says Connected.
If WPLinker receives HTML instead of JSON, the WordPress REST endpoint may be blocked, redirected, or protected by a firewall/security plugin. Temporarily disable aggressive REST blocking or whitelist WPLinker requests.
Missing request token
A missing request token usually means the automated health check reached WordPress without the expected WPLinker authentication header. Regenerate or copy the connection token from the website edit page, paste it into WordPress, save, and verify again.
Each website has its own token. Do not reuse one website token on another website.
Publishing fails
Publishing failures usually come from one of five places: WordPress connection, invalid category, author permission, featured image upload, or blocked REST API. Open the order, read the publishing error, and compare it with the website connection status.
- Refresh website categories and make sure the selected category still exists.
- Check that the default WordPress author can publish posts.
- Confirm the featured image is a valid image file and not too large.
- Make sure WordPress security plugins are not blocking REST requests.
- Retry publishing after correcting the issue.
Storefront domain issues
For custom domains, DNS must point to WPLinker and SSL must be ready. If a storefront shows degraded status, wait for DNS propagation and run diagnostics again.
Do not use the same domain for a WordPress website and a storefront. Use separate subdomains such as example.com for WordPress and links.example.com for the storefront.
Payment webhook issues
If Stripe payments succeed but orders do not update, check the webhook URL and selected events in Stripe. The signing secret must match the endpoint shown in the storefront payment settings.
For bank transfer, remember that payment is manual. The seller must mark the order as paid after confirming the transfer.
When to contact support
If the error message is unclear or a retry keeps failing, open a support ticket from your dashboard. Include the website URL, order number, payment method, and the exact error message shown in WPLinker.