Everything you need to know about OpenID, UnionID, WeChat login and the ways you can learn to retrieve user data in WeChat.
Our “WeChat for Dummies” series tries to answer some of the most frequently asked questions we receive about WeChat from our clients and partners. We focus on topics such as User Data, Customer Service, CRM, Payment, Data Security, Data Analytics, and Personalization.
Have another topic or question you’d like us to write about? Get in touch.
What is WeChat Open Platform?
WeChat currently has four platforms to connect its 1 billion users with its business, app, or website:
The Smart Platform 微信智能开放平台 enables developers to utilize WeChat’s articial intelligence tools, such as image, video, or voice recognition.
The Open Platform 微信开放平台 connects your app or website to WeChat’s mobile services including user authentication and payment.
WeChat Open Platform is a hub for mobile applications, website applications, Mini Programs, Official Accounts (OA) and third-party platforms.
What are OpenID and UnionID?
These are two important parameters mentioned all the time by product people and developers.
OpenID is an unique encrypted WeChat ID for each user of an OA (including Mini Program). Users have separate OpenIDs corresponding to different OAs. In Developer Mode, when subscribed users interact with an OA, the developer can obtain their OpenIDs and use it to get basic user information (gender, photo, location etc.)
UnionID is an unique ID to identify a single user under the same WeChat open platform account. If a developer possesses multiple mobile applications, website applications, and OAs (including Mini Programs), they can use a UnionID to differentiate the uniqueness of users. In other words, UnionID offers a mechanism for developers to acquire a user’s data from multiple platforms and attribute actions back to the specific user.
How to get OpenID and UnionID?
Ways to get OpenID:
A user subscribes to your OA
A non-follower visits an OA’s web page
A user authorizes WeChat access through app
A user authorizes WeChat access through Mini Program
Ways to get UnionID:
You’ll need OpenID and access_token to obtain UnionID (OA, Mini Program, PC or WeChat browser)
Note: To get access to a user’s UnionID, you first need to complete developer qualification verification and bind your accounts (OA, Mini Program and Applications) on WeChat open platform.
The value of OpenID
With an OpenID, you have access to the following user info:
Location (city, province, country)
Subscribe time (the latest subscribe time)
Remark (set by OA operator)
GroupID (set by OA operator)
Subscribe source (e.g. OA search, OA migration, OA card share, QR code, payment page)
QR code scanning scenario
QR code scenario description
Note: Once a user has unsubscribed from your OA, you can’t pull their basic info anymore. To keep your user database up to date, you can set up automatic data synchronization with a certain frequency.
How can individuals and brands benefit from UnionID mechanism?
For individuals, the UnionID mechanism provides a seamless user experience across channels and devices, along with real-time communication and personalized offers:
Skip new account registration through WeChat login authorization
Instant and personalized customer service
Convenient status updates and reminders (e.g. delivery and transactions tracking)
Real-time data synchronization across OA, PC web and mobile app
Diversified membership benefits and rewards (users can redeem points across brands)
Enriched user experience (users can collect/transfer points from one platform to another)
Security (users get notified of any unusual activities associated with his UnionID through multiple channels).
For brands, unionID mechanism provides a closed-loop opportunity to understand, approach, convert and retain consumers.
Increase user retention rate through smooth onboarding
A better way to acquire and manage user data
Boost sales through cross marketing and scenario-based promotion
Improve data security
Accurate customer segmentation and targeted advertising (when a user authorizes WeChat login on a cosmetics app, WeChat can push beauty related ads accordingly)
Data security (users don’t need to log in with account and password)
How to enable WeChat login authorization?
WeChat login for third-party apps is based on the OAuth 2.0 standard (OAuth 2.0 is the industry-standard protocol for authorization).
After a user has given permission, the OA will receive a special API calling certificate (authorization access_token). Based on this access token, the OA may call APIs and obtain the user’s basic information.
A simplified authorization flow:
Step 1: User clicks WeChat login and grants authorization.
Step 2: OA gets a temporary code.
Step 3: Based on the code, OA gets access_token from server.
Step 4: OA obtains users’ basic data with access_token and OpenID.
What is Silent Authorization?
Silent authorization means users will be automatically redirected to the configured business page without an authorization prompt. When the scope is set to snsapi_base, developers can obtain the user’s OpenID under silent authorization mode.
When scope is set to ‘snsapi_userinfo’, the user must first confirm their authorization. After receiving permission, developer can obtain the user’s basic information.
Before implementing WeChat login in your app, you’ll need to register a developer account on the developer portal, have your app approved, and obtain the corresponding AppID and AppSecret. Login functionality will be available after your application has been approved.
When users have followed an OA and enter the authorization webpage of this OA via its chat window or custom menu, silent authorization will prevail over manual authorization even when the authorization scope is set to snsapi_userinfo.
How to grant the access to third party vendors in grace?
Is it possible to outsource your MP to other vendors without granting your AppID and AppSecret?
Ask them to create a third-party platform on WeChat Open Platform. Here is how.
Note: If an OA authorizes a third-party to manage its web-based authentication, the OA does not need to change any settings.