{"slug":"wechat","name":"WeChat","domain":"weixin.qq.com","category":"Messaging / social login","summary":"Getting to public launch is hard. You must register a company with the WeChat Open Platform (open.weixin.qq.com), pay for developer verification and pass a manual review of your website app, and until that review passes, not even your own account can connect.","tier":"gated","tierReason":"WeChat Login for websites requires paid developer verification that individuals reportedly can't get, plus a manual app review before any account can connect.","quality":"generated","updatedAt":"2026-10-27","composio":{"status":"unknown","note":"WeChat isn't in Composio's managed-auth or bring-your-own lists (checked 2026-10-27), so expect to register your own Open Platform app and use it with whatever OAuth client you choose."},"totals":{"effort":{"min":2,"max":6,"unit":"hours"},"wait":{"min":4,"max":14,"unit":"days"},"firstConnection":"Only after developer verification and website app review both pass, roughly 1 to 2 weeks according to developer reports"},"stages":[{"id":"build","name":"Approved website app","whoCanConnect":"No one until the app is approved. After that, any WeChat user who scans the QR code.","userSees":"Before approval, the QR login page fails with errors (scope or redirect errors). After approval, users see the WeChat QR code login page with your app name.","effort":{"min":2,"max":6,"unit":"hours"},"wait":{"min":4,"max":14,"unit":"days"},"unlock":"Once the website app is approved and its WeChat Login interface shows as granted, the same app works for every user. There is no separate launch review.","evidence":{"kind":"community","sources":["s1","s3","s4","s5"],"confidence":"medium"}},{"id":"launch","name":"Public launch","whoCanConnect":"Any WeChat user","userSees":"The WeChat QR code login (scope snsapi_login), confirmed on their phone","effort":{"min":0,"max":0,"unit":"hours"},"wait":{"min":0,"max":0,"unit":"days"},"unlock":null,"evidence":{"kind":"inferred","sources":["s1","s4"],"confidence":"medium"}}],"requirements":[{"id":"open-platform-account","label":"WeChat Open Platform developer account","detail":"Register at open.weixin.qq.com with an email address that isn't used by any other WeChat platform account.","stage":"build","actor":"you","evidence":{"kind":"community","sources":["s3","s7"],"confidence":"medium"}},{"id":"business-entity","label":"Registered company or organization","detail":"Developers report that developer verification takes only enterprise, government or organization materials, not individuals. Mainland verification reportedly needs the legal representative's face scan and a corporate bank account.","stage":"build","actor":"you","evidence":{"kind":"community","sources":["s4","s5","s6"],"confidence":"medium"}},{"id":"verification-fee","label":"Developer verification fee","detail":"Reported as 300 CNY for mainland entities and 99 USD for overseas entities, charged yearly and not refundable.","stage":"build","actor":"you","evidence":{"kind":"community","sources":["s6","s7"],"confidence":"medium"}},{"id":"website-and-domain","label":"Live website and callback domain","detail":"You need a working website and the domain where your redirect URI lives. Your redirect_uri must be on the authorization callback domain you declared during review.","stage":"build","actor":"you","evidence":{"kind":"docs","sources":["s1"],"confidence":"high"}},{"id":"site-registration-form","label":"Signed website information registration form","detail":"Submit the 微信开放平台网站信息登记表 (website information registration form). The app name on it must match the app name you enter. If the site's operator differs from the verified entity, you also need an authorization letter.","stage":"build","actor":"you","evidence":{"kind":"community","sources":["s5"],"confidence":"medium"}}],"steps":[{"id":"register-account","title":"Register a WeChat Open Platform account","actor":"you","stage":"build","time":{"min":15,"max":30,"unit":"minutes"},"detail":"Sign up at open.weixin.qq.com with an email address and activate the account. Each WeChat platform (Official Accounts, Mini Programs, Open Platform) needs its own email address.","actions":["Go to open.weixin.qq.com and choose to register","Use an email address not tied to another WeChat platform account","Confirm the activation email and bind an administrator WeChat account"],"agentNote":"A person has to sign up and scan QR codes with their phone. An agent can fill in profile fields once signed in.","gotcha":"An email address already used for an Official Account or Mini Program can't be reused here.","link":{"label":"WeChat Open Platform","url":"https://open.weixin.qq.com/"},"evidence":{"kind":"community","sources":["s3","s7"],"confidence":"medium"}},{"id":"apply-verification","title":"Apply for developer verification and pay","actor":"you","stage":"build","time":{"min":1,"max":2,"unit":"hours"},"detail":"In Account Center, open 开发者资质认证 (developer verification). Accept the agreement, submit your company documents, enter invoice details and pay the fee.","actions":["Account Center > 开发者资质认证","Accept the service agreement","Upload business license and entity details, then complete the legal representative and corporate bank checks","Enter invoice details and pay (reported as 300 CNY, or 99 USD overseas)"],"agentNote":"An agent can fill in text fields. Payment, identity checks and document uploads need a person.","gotcha":"Individual-type accounts can't complete this step. The fee is reportedly not refunded if you're rejected.","link":{"label":"WeChat Open Platform","url":"https://open.weixin.qq.com/"},"evidence":{"kind":"community","sources":["s3","s4","s5","s6"],"confidence":"medium"}},{"id":"wait-verification","title":"Wait for verification approval","actor":"provider","stage":"build","time":{"min":1,"max":7,"unit":"days"},"detail":"Tencent reviews your verification. Developers report 1 to 3 days, and some report about a week.","gotcha":"Incomplete materials send you back through review. Submit everything the first time.","evidence":{"kind":"community","sources":["s5","s6"],"confidence":"medium"}},{"id":"create-website-app","title":"Create a website app","actor":"you","stage":"build","time":{"min":30,"max":90,"unit":"minutes"},"detail":"In 管理中心 (Management Center) > 网站应用 (website apps), click 创建网站应用 (create website app). Enter the basic info and website info, including app name, logo, website URL and the authorization callback domain, then upload the signed website information registration form.","actions":["Management Center > 网站应用 > 创建网站应用","Fill in basic info: app name, description, logo","Fill in website info: website URL and authorization callback domain (domain only, e.g. www.example.com, no scheme or path)","Upload the signed website information registration form","Submit for review"],"agentNote":"An agent can fill in the form fields and the callback domain. A person should sign the registration form, upload it and submit.","gotcha":"Enter only the domain for the callback domain. The app name must exactly match the name on the registration form, or the review is rejected.","link":{"label":"WeChat Open Platform","url":"https://open.weixin.qq.com/"},"evidence":{"kind":"community","sources":["s3","s4","s5"],"confidence":"medium"}},{"id":"wait-app-review","title":"Wait for website app review","actor":"provider","stage":"build","time":{"min":3,"max":7,"unit":"days"},"detail":"Tencent reviews the website app. Developers report up to about 7 days. Some say verification and app creation can run in parallel.","gotcha":"A rejection restarts the review clock.","evidence":{"kind":"community","sources":["s5","s7"],"confidence":"low"}},{"id":"confirm-login-interface","title":"Confirm WeChat Login is granted","actor":"agent","stage":"build","time":{"min":5,"max":10,"unit":"minutes"},"detail":"Open the approved app. Check that 微信登录 (WeChat Login) shows as granted under 接口信息 (interface info), and note the AppID.","actions":["Open the app from the 网站应用 list","Check that 接口信息 > 微信登录 is granted","Copy the AppID"],"agentNote":"An agent can check the status and copy the AppID. A person should reveal the AppSecret and put it in your OAuth client's secret store.","gotcha":"If WeChat Login isn't granted, authorization fails with a scope error.","link":{"label":"WeChat Open Platform","url":"https://open.weixin.qq.com/"},"evidence":{"kind":"community","sources":["s4"],"confidence":"medium"}},{"id":"store-secret","title":"Store the AppSecret in your OAuth client","actor":"you","stage":"build","time":{"min":5,"max":10,"unit":"minutes"},"detail":"Generate or reveal the AppSecret. Store it server-side in your OAuth client, since the token exchange at api.weixin.qq.com/sns/oauth2/access_token needs it.","actions":["Reveal the AppSecret (this needs administrator QR confirmation)","Save it in your OAuth client's secret storage"],"agentNote":"A person handles this step. Don't give the secret to an agent.","gotcha":"Never put the AppSecret in front-end code.","evidence":{"kind":"docs","sources":["s1"],"confidence":"medium"}},{"id":"configure-oauth-client","title":"Configure your OAuth client endpoints","actor":"agent","stage":"build","time":{"min":15,"max":30,"unit":"minutes"},"detail":"Set the authorize URL to https://open.weixin.qq.com/connect/qrconnect with appid, a URL-encoded redirect_uri, response_type=code, scope=snsapi_login and state. The token URL is https://api.weixin.qq.com/sns/oauth2/access_token, which takes appid, secret, code and grant_type=authorization_code.","actions":["Authorize URL: https://open.weixin.qq.com/connect/qrconnect","Token URL: https://api.weixin.qq.com/sns/oauth2/access_token","Scope: snsapi_login","Make sure your redirect URI is on the approved callback domain"],"agentNote":"An agent can enter the endpoints and the redirect URI and run a test login. A person scans the QR code.","gotcha":"WeChat uses non-standard parameter names (appid and secret instead of client_id and client_secret), so generic OAuth clients often need custom configuration. Codes expire in 10 minutes and access tokens in 2 hours.","link":{"label":"WeChat website login docs","url":"https://developers.weixin.qq.com/doc/oplatform/Website_App/WeChat_Login/Wechat_Login.html"},"evidence":{"kind":"docs","sources":["s1"],"confidence":"high"}}],"scopes":{"intro":"Website apps use a single scope. Getting it depends on the app approval, not on a per-scope review.","tiers":[{"scope":"snsapi_login","grants":"QR code login. Returns the openid (plus a unionid if bound), and the token can be used to fetch basic profile info.","level":"basic","consequence":"Available only after developer verification and website app approval"}]},"blockers":[{"symptom":"Developer verification can't be submitted, or is rejected, for an individual account","cause":"Developers report that verification requires enterprise or organization materials.","fix":"Verify under a registered company. If the site's operator differs from that company, add an authorization letter.","evidence":{"kind":"community","sources":["s4","s5","s7"],"confidence":"medium"}},{"symptom":"\"该链接无法访问\" (link cannot be accessed) or a redirect_uri parameter error on the QR page","cause":"Your redirect_uri domain doesn't match the authorization callback domain set on the app.","fix":"Use a redirect URI on exactly the approved domain, URL-encoded, or update the callback domain in the console.","evidence":{"kind":"docs","sources":["s1","s8"],"confidence":"high"}},{"symptom":"Scope parameter error (scope 参数错误或没有 scope 权限)","cause":"The 微信登录 (WeChat Login) interface isn't granted on the app, or you used a scope other than snsapi_login.","fix":"Wait for approval, check 接口信息 (interface info), and use scope=snsapi_login.","evidence":{"kind":"community","sources":["s4","s1"],"confidence":"medium"}},{"symptom":"Website app review rejected","cause":"The app name doesn't match the registration form, the materials don't match the verified entity, or a signature or seal is missing.","fix":"Make the name and entity consistent across all materials and resubmit.","evidence":{"kind":"community","sources":["s5"],"confidence":"medium"}}],"unknowns":[{"question":"Is the verification fee still 300 CNY / 99 USD per year, and is it refundable?","why":"Only community posts state the fee. No official fee page was fetched.","resolve":"Check Account Center > 开发者资质认证 on open.weixin.qq.com before paying."},{"question":"Can overseas companies verify, and what documents do they need?","why":"A single community post mentions a 99 USD overseas fee. Requirements weren't confirmed.","resolve":"Start verification in the console and choose the overseas entity option, or contact WeChat Open Platform support."},{"question":"Does the website need a Chinese ICP filing to pass app review?","why":"One write-up links the MIIT filing lookup but doesn't say filing is required.","resolve":"Check the website app review guidelines in the Open Platform console."},{"question":"Is there a test or sandbox mode for website QR login before approval?","why":"No official sandbox for Open Platform website apps was found. The Official Account test account covers in-WeChat web authorization, not QR login.","resolve":"Search the WeChat Open Community (developers.weixin.qq.com/community) or ask support."},{"question":"How long do refresh tokens last?","why":"The fetched docs page doesn't state it.","resolve":"Read the token refresh section of the official website login docs."}],"handoff":{"agentCan":["Fill in the website app form fields and authorization callback domain once you're signed in","Check that the WeChat Login interface is granted and copy the AppID","Configure your OAuth client's authorize and token URLs, scope and redirect URI","Run a test login up to the QR scan"],"youMust":["Register the Open Platform account and scan the admin QR codes","Provide company documents, complete identity and bank checks, and pay the verification fee","Sign and upload the website information registration form and submit for review","Reveal the AppSecret and store it in your OAuth client","Scan the QR code to test login"]},"sources":[{"id":"s1","title":"网站应用微信登录开发指南 (Website App WeChat Login guide)","url":"https://developers.weixin.qq.com/doc/oplatform/Website_App/WeChat_Login/Wechat_Login.html","publisher":"WeChat Open Platform docs","kind":"official","checkedAt":"2026-10-27"},{"id":"s2","title":"Composio managed auth toolkits","url":"https://docs.composio.dev/toolkits/managed-auth.md","publisher":"Composio docs","kind":"composio","checkedAt":"2026-10-27"},{"id":"s3","title":"当你使用网页端微信应用进行开发","url":"https://docs.authing.cn/v2/guides/wechat-ecosystem/wechat-web-app.html","publisher":"Authing docs","kind":"community","checkedAt":"2026-10-27"},{"id":"s4","title":"微信开放平台登录","url":"https://www.justauth.cn/guide/oauth/wechat_open/","publisher":"JustAuth","kind":"community","checkedAt":"2026-10-27"},{"id":"s5","title":"【微信开放平台】下绑定【微信公众号】、并创建【网站应用】的操作指南","url":"https://www.cnblogs.com/johnnyzen/p/17336600.html","publisher":"博客园 (cnblogs)","kind":"community","checkedAt":"2026-10-27"},{"id":"s6","title":"Tencent Cloud developer community post on Open Platform verification","url":"https://cloud.tencent.com/developer/article/1782440","publisher":"Tencent Cloud Developer","kind":"search","checkedAt":null},{"id":"s7","title":"V2EX discussion on WeChat platform verification fees","url":"https://v2ex.com/t/1188059","publisher":"V2EX","kind":"search","checkedAt":null},{"id":"s8","title":"微信开放平台 网站应用 回调地址导致的错误如何解决","url":"https://blog.csdn.net/lu12077/article/details/102719925","publisher":"CSDN","kind":"search","checkedAt":null}],"feedback":{}}