WeChat Connect

To use WeChat as a social login provider, you need the App ID and App Secret from your WeChat app. You’ll then copy and paste these keys into your ReachFive settings. This docs detail how to connect your WeChat application to your ReachFive account.

This page does not contain steps on creating a WeChat application. To create an application with WeChat, you should follow the official WeChat documentation.

Complete the following steps to connect your WeChat application to ReachFive:

Create a WeChat application

You can create a website application or mobile application with WeChat. If you want to use both WeChat applications types with ReachFive, you need to create a separate application for mobile and webapp.

In the WeChat app creation process, where you’re asked for the Authorization callback domain, add https://{REACHFIVE_DOMAIN}/login/callback, where REACHFIVE_DOMAIN is your ReachFive domain.

  • You can’t add both a staging and production URL, so you need to create another app for staging purpose.

  • It typically takes around 7 days for WeChat to validate your application request.

Configure the WeChat application for iOS

If you are creating an iOS application for WeChat, there are some things you must do in order to ensure everything works properly. You need to:

  1. Configure a universal link. You can do this under the iOS section in your WeChat application dashboard under the term Universal Links.

    Full link example


  2. In your own iOS application, create an associated domain file that matches the domain URL for the universal link you made in your WeChat application.


    https://example.com/.well-known/apple-app-site-association This should be stored in your .well-known directory.

  3. Ensure your iOS application is also associated with the WeChat universal link domain in your <app_name>.entitlements file.

    	<string>applinks:<DOMAIN_FROM_WECHAT></string> (1)
    1 Where DOMAIN_FROM_WECHAT is your WeChat universal link without the scheme like example.com.

Connect WeChat to ReachFive

To connect your WeChat web and/or mobile application to ReachFive:

  1. Go to your WeChat web or mobile application.

  2. Copy your App ID and App Secret.

    If you don’t see it, you might need to generate the secret.

  3. Go to the ReachFive Console.

  4. Navigate to Settings  Providers.

  5. Click on WeChat.

    wechat select

  6. Paste your App ID into the Client ID field and your App Secret into Client Secret field under Default if it’s a web application.

    Configuring a mobile WeChat application?

    If you have a mobile application with WeChat, you need to add a variant:

    1. Click the icon in the dialog.

    2. Click the icon to edit the variant name.

      1. The variant name must contain android for an Android app and ios for an iOS app. Variant names are case sensitive.

      2. If you are using the same WeChat application for iOS and Android, you can name it android_and_ios. This covers both mobile application types.

    3. Paste your App ID into the Client ID field and your App Secret into Client Secret field.

    4. iOS only For iOS apps, you must enter an iOS universal link.

      View from the ReachFive Console

      wechat ios universal link

  7. Don’t forget to Save your input.

    wechat default

WeChat mini_program

A mini program does not follow the same flow as other Social Login providers.

  1. Configure a variant with mini_program as part of the name in the WeChat connector in the ReachFive Console.

    Accepted names

    • my_mini_program

    • mini_program

    • mini_program_production

    • tiny_program

    wechat miniprogram

  2. Start the flow using the wx.login method, where you’ll receive a code in the response.

  3. Using this code, call the ReachFive /oauth/provider/token endpoint.