10/27/2025 18:02:26
Solution
I. WeChat platform's return codes
| Return code | Error description | Recommended handling method |
|---|---|---|
| 0 | ok | - |
| -1 | Common error type | View the detailed information returned |
| -2 | The user clicks the "Cancel" button and return | - |
| -3 | Fail to send messages. Please try again | - |
| -4 | Authorization fails. Please try again | - |
| -5 | WeChat does not support this | - |
| -6 | The application signature is illegal | - |
| 26 | The user denies the authorized login | - |
| 10026 | BundleID is incorrect | Please use BundleID which is consistent with the platform's configuration |
| 40001 | invalid credential | Re-launch authorization |
| 40002 | invalid grant_type | Re-launch authorization |
| 40003 | invalid openid | Confirm the accuracy of openid. If there is still any problem, please contact MSDK Assistant and report it to WeChat side to handle it |
| 40007 | invalid media_id | media_id used to upload the image is invalid. Re-upload the image to get media_id |
| 40008 | invalid message type | - |
| 40009 | invalid image size | Check if the image size is within the required range |
| 40012 | invalid thumb size | Check if the thumbnail size is within the required range |
| 40013 | invalid appid | Confirm the accuracy of appid. If there is still any problem, please contact MSDK Assistant and report it to WeChat side to handle it |
| 40014 | invalid access_token | Confirm the accuracy of access_token. If there is still any problem, please contact MSDK Assistant and report it to WeChat side to handle it |
| 40029 | invalid code | Re-launch authorization |
| 40030 | invalid refresh_token | Re-launch authorization |
| 40031 | invalid openid list | Re-launch authorization |
| 40032 | invalid refresh_token | Re-launch authorization |
| 40036 | invalid template_id size | - |
| 40037 | invalid template_id | - |
| 40039 | invalid url size | Check if the url length is within the required range |
| 40066 | invalid url | Check if url is valid |
| 40097 | invalid args | The receiver blocks the message. Let the receiver check WeChat: Go to "Discover-> Games-> I-> Privacy Settings-> Game Management" to check whether "Receive Game Message" is set to "off" |
| 40163 | code been used | Re-launch authorization |
| 40180 | invalid client tmp token | Re-launch authorization |
| 41001 | access_token missing | Re-launch authorization |
| 41002 | appid missing | Confirm the accuracy of request parameter appid. In case of failure, please contact MSDK Assistant to provide technical support |
| 41003 | refresh_token missing | Confirm the accuracy of request parameters like parameter appid and refresh_token. In case of failure, please contact MSDK Assistant to provide technical support |
| 41004 | appsecret missing | Confirm the accuracy of request parameters like parameter appid and appkey. In case of failure, please contact MSDK Assistant to provide technical support |
| 41006 | media_id missing | Check if the "media_id" parameter is transmitted |
| 41008 | missing code | Confirm the accuracy of request parameter code. In case of failure, please contact MSDK Assistant to provide technical support |
| 41009 | missing openid | Confirm the accuracy of request parameters like parameter appid and openid. In case of failure, please contact MSDK Assistant to provide technical support |
| 41010 | missing url | Check if the "url" parameter is transmitted |
| 42001 | access_token expired | accessToken has expired. Refresh token or re-launch authorization |
| 42003 | code expired | Re-launch authorization |
| 42004 | refresh_token expired | Re-launch authorization |
| 42009 | client tmp token expired | Re-launch authorization |
| 43003 | require https | Use https request |
| 43004 | require subscribe | - |
| 43005 | require friend relations | - |
| 44002 | empty post data | - |
| 45003 | title size out of limit | Check if the "title" parameter exceeds the limit |
| 45004 | description size out of limit | Check if the "description" parameter exceeds the limit |
| 45005 | url size out of limit | Check if the "url" parameter's length exceeds the limit |
| 45009 | api freq out of limit | Limit the access frequency and check whether the API is under attack. In case of failure, please contact MSDK Assistant to provide technical support |
| 45011 | api limit | Limit the access frequency and check whether the API is under attack. In case of failure, please contact MSDK Assistant to provide technical support |
| 45013 | too many template args | Limit the access frequency and check whether the API is under attack. In case of failure, please contact MSDK Assistant to provide technical support |
| 45014 | template message size out of limit | Limit the access frequency and check whether the API is under attack. In case of failure, please contact MSDK Assistant to provide technical support |
| 47001 | data format error | - |
| 48001 | api unauthorized | Re-launch authorization |
II. WeChat group function's return codes
| Return code | Error description | Recommended handling method |
|---|---|---|
| -1 | System error | Retry again. If the retry also fails, please contact MSDK Assistant to provide technical support |
| -10000 | The game does not open the permission to create groups on the open platform | - |
| -10001 | This game does not have permission to create groups | The game does not open the permission to create groups in the Game Center |
| -10002 | Parameter check error | Confirm the accuracy of parameters. In case of failure, please contact MSDK Assistant to provide technical support |
| -10003 | The link does not exist (not related to the group) | - |
| -10004 | Fail to get the hoplink (not related to group) | - |
| -10005 | The group ID already exists | Do not repeat creating the group |
| -10006 | The user has reached the upper limit on the number of groups created by a user | - |
| -10007 | The group ID does not exist | Change to use an existing group ID |
| -10008 | The user has reached the upper limit on the number of groups created by a user a day | - |
| -10009 | The user is not in the group | - |
| -10010 | The number of groups added reaches the upper limit | |
| -20001 | The number of groups unbound by the user reaches the upper limit | - |
| -20002 | The user reaches the upper limit of creating groups | - |
| -20003 | group_id has created groups (client interface) | - |
| -30001 | The joined group_id does not exist (client interface) | - |
| -201608 | Fail to read kv | Contact WeChat-related staff |
| -201609 | Fail to write kv | Contact WeChat-related staff |
Copyright © 2025 MSDK.
All rights reserved.
All rights reserved.