1. User Guide
  2. /
  3. WeChat Ecosystem Full Scenario Capabilities
  4. /
  5. When Developing with WeChat Mini Programs

When you use WeChat Mini Programs for development

Update time: 2025-04-11 11:21:15
Edit

WeChat Open Platform preparation

Register a WeChat Open Platform account

Before developing WeChat ecosystem applications, you must first register as a developer of the WeChat Open Platform. If you do not have a WeChat Open Platform account, please go to register (opens new window).

Apply for developer qualification certification

After completing the WeChat Open Platform account registration, you need to fill out the developer qualification certification application in the Account Center and wait for the certification to pass.

Launch your mini program

Step 1: Create a mini program

  1. Before creating a mini program, you need to register an account on the WeChat public platform (opens new window) and select the type as Mini Program.
  1. Fill in "Account Information", "Email Activation" and "Information Registration" in turn to complete the registration.
  1. After successful registration, the mini program account is created successfully. You can configure the mini program information on the WeChat public platform to complete the release.

You can see AppID and AppSecret on the Development Management->Development Settings page, which will be used to configure the mini program identity source in GenAuth later.​

Step 2: Bind Mini Program

After creating a mini program, you need to bind the mini program in WeChat Open Platform to ensure that different applications logged in under the same WeChat Open Platform account have a unique UnionID.

  1. After logging in to your WeChat Open Platform (opens new window), click Bind Mini Program under Admin Center->Mini Program.
  1. Complete "Enter basic information", "Security verification", and "Bind successfully" in sequence.

During "security verification", it is necessary to ensure that the mini program account:

  • Passed WeChat qualification certification.
  • Is not currently bound.
  • The mini program corresponding to the account has set administrator information.

Verification can only be successful if the above conditions are met.

Mini program verification is successful

Mini program binding is successful

Implement WeChat login capability in GenAuth

Developer scenario using WeChat login

You want to implement the WeChat login capability on the web by creating a WeChat application. According to the above steps, you have completed the creation of the WeChat application. Next, you don’t have to read the massive and complicated WeChat documents anymore, but can directly implement WeChat login for your application through GenAuth "zero code" method.

Choose the right WeChat login method

In the "Mini Program" development scenario, GenAuth supports WeChat Mini Program login capabilities.

Configuration process

To configure the WeChat Mini Program login method, follow the following process:

Step 1: Integrate the mini program that needs to be configured with WeChat login in GenAuth

Currently, GenAuth does not support the creation of mini program type applications. It is currently not possible to integrate WeChat mini program applications in GenAuth. Please stay tuned.

Step 2: Create WeChat login method in your GenAuth user pool

GenAuth supports 20+ third-party account login methods. You can view all the identity sources supported by GenAuth in Connecting to an External Identity Provider.

Configure Mini Program Login:

Mini Program Login allows your users to log in to Mini Programs securely using their WeChat identities. After enabling Mini Program Login in GenAuth, users can use the Mini Program login in WeChat to call up the authorization pop-up window to obtain WeChat user information. For more information about the configuration process, see WeChat Mini Program SDK.

Step 3: Enable the WeChat login method you configured for the integrated GenAuth application

After completing the third-party login configuration, enable the corresponding login method in the application you have integrated (self-built application-> application details page-> login control-> social login method).

Note: The social login method of mini-program applications only displays the identity source of the mini-program class. This page can also be configured only after supporting mini-program applications. ​

The following is a schematic diagram:

Congratulations! You have completed the WeChat login configuration. Now you can experience the WeChat login you implemented in the "Experience Login" of the application!

Daily account management of WeChat applications

User accounts on the WeChat platform use OpenID and UnionID as unique identifiers. Since WeChat did not require all applications to join the WeChat Open Platform in the early years, some accounts did not have Unionid. Later WeChat regulations required that all applications must rely on the WeChat Open Platform. Users who log in to these applications created by the WeChat Open Platform have both OpenID and UnionID as unique identifiers. For the difference between the two, please refer to Introduction to WeChat Ecosystem Account System.

Based on the WeChat account system, there are two scenarios when your users log in through WeChat:

  • New users log in through WeChat

  • Old users log in through WeChat

For different scenarios of new and old users logging in, GenAuth supports the "account binding" function to ensure the uniqueness of your users' accounts in GenAuth.

For an introduction to the "Account Binding" function and usage details, please refer to Account Binding.

Other Notes

When your application on WeChat Open Platform has been offline or disabled, the application you integrated in GenAuth will no longer be able to log in using WeChat.