Skip to main content

logins-china

On this page

Sign in with WeChat (Optional)

Prerequisites

RainMaker China must be deployed in the cn-north-1 region.

Create a Developer Account

  1. Go to https://open.weixin.qq.com/.
  2. Sign up for a verified enterprise account if you have not registered yet.
  3. A one-time review fee is required (approximately 300 RMB at the time this document was written).
  4. Follow the detailed steps here:
    https://developers.weixin.qq.com/doc/oplatform/en/Third-party_Platforms/2.0/operation/open/create.html
  5. The approval process takes approximately 3–5 business days.
  6. Once approved, your account will be ready as shown below:

WeChat Account

Create a Client in WeChat

App Client

  1. For Android, you will need the following details:

WeChat App

You must provide the APK signer certificate's MD5 digest.

  1. For iOS, you will need the following:

WeChat App

A universal link for the App is required. Follow these steps to create a universal link for Android and iOS.

  1. Select the App type: 工具-设备管理 (Tools-Device Management)
  2. Follow the steps here:
    https://developers.weixin.qq.com/doc/oplatform/en/Third-party_Platforms/2.0/operation/open/create.html
  3. The approval process takes approximately 1–7 business days.
  4. Upon approval, you will receive an AppID and AppSecret.

Create a Provider in RainMaker

  1. Use the RainMaker API. Refer to the example for "WeChat" and enter the AppID and AppSecret obtained in the previous step.
  2. Create a provider for the App with with provider_type: WeChat

RainMaker Phone App Configuration

Ensure that the redirect URIs for both Android and iOS are added to the client configuration. For more details, refer to this guide.

Android

  • In the local.properties file:
    • isChinaRegion=true
    • isMatterSupported=false
  • In the AndroidManifest.xml file:
    • your_app_id=WeChat app id

iOS

Refer to https://github.com/espressif/esp-rainmaker-ios/blob/master/RegionConfig.md.

Note: When calling the Token API, please add the flag wechat_token_only=true.

info

Please get in touch with the ESP RainMaker support team (esp-rainmaker-support@espressif.com) to deploy or set up China specified deployment requirement.