Pairing does not always work on the first attempt.
Here are some common problems and their possible solutions.
1. Incorrect Phone Number Format
This is one of the most common beginner mistakes.
For example, Pakistani numbers use the country code +92.
If the website requests an international format, entering the local number incorrectly may prevent the request from working.
Solution:
Select the correct country code.
Check the number carefully.
Follow the website's formatting instructions.
Avoid adding an unnecessary leading zero.
2. Pairing Code Expired
You may receive a code but wait too long before entering it.
The code may expire before authentication finishes.
Solution:
Return to the developer's pairing website.
Request a fresh code.
Open WhatsApp Linked Devices.
Enter the new code promptly.
Do not repeatedly reuse an expired code.
3. Too Many Pairing Attempts
Some authentication services limit repeated requests.
If you request several codes within a short period, additional requests may be temporarily restricted.
Solution:
Stop requesting new codes.
Wait before trying again.
Check whether the developer has published any service restrictions.
Try again with the correct number.
Avoid repeatedly refreshing the pairing website.
4. Pairing Server Is Busy
Sometimes the pairing website is working, but its authentication server is temporarily overloaded.
Possible symptoms include:
The website keeps loading.
No code appears.
Requests time out.
An error appears after submitting the number.
Solution:
Wait a little before trying again.
Check the developer's official announcements.
Verify your internet connection.
Try again when the service becomes available.
5. Pairing Website Is Offline
A developer may temporarily take down a pairing website or discontinue its authentication service.
Solution:
Check the original repository and developer announcements.
Do not use random alternative pairing websites simply because the original service is unavailable.
6. Code Is Not Accepted by WhatsApp
Sometimes a code is generated successfully but WhatsApp refuses it.
Possible reasons include:
The code has expired.
The wrong WhatsApp account is open.
The code was entered incorrectly.
The authentication request is no longer valid.
The pairing service has encountered an error.
Solution:
Confirm the account and request a fresh code through the verified service.
Pairing Code vs QR Code: What Is the Difference?
Both methods can be used to link a WhatsApp account to a compatible MD bot.
However, their authentication processes are different.
Pairing code vs QR code:
Authentication / Enter a temporary code / Scan a QR code
Phone camera / Usually not needed for linking / Required for scanning
Website / May be provided by developer / May be displayed by the application
Expiration / Temporary / QR code also expires or refreshes
Internet / Required / Required
Ease of use / Convenient for remote setup / Convenient when both screens are accessible
Which Method Is Better?
Neither method is universally better.
Pairing codes can be convenient when the bot is running on a remote server and you are using your phone to complete authentication.
QR codes can be convenient when the bot displays its authentication screen on another device.
Choose whichever method the original developer officially supports.