Mini Program
取消
Development
中文
EN
取消
  • Guide

    • # NFC tag open Weixin Mini Program

    Android WeChat Guest Terminal 8.0.14 is supported, iOS version is covered.

    Based on Weixin Mini Program URL Scheme ,In addition to existing SMS, email, web and other scenarios, WeChat also supports the ability to quickly pull up Mini Program pages through NFC cards.It can be used in scenarios such as rapid network distribution, quick control of smart devices.

    This capability is not subject to the 30-day validity of the URL Scheme and allows access by multiple users.

    # NFC label format

    To enable direct opening of Weixin Mini Program, NFC tags need to be written in the following format:

    The NFC tag must be of typeNFC Data Exchange Format (NDEF), and the tag needs to contain two records:

    • URI Record
      • Type Name Format (TNF):0x01(Well-Known)
      • Type:U
      • Payload:  Weixin Mini Program URL Scheme
    • Android Application Record, AAR
    • Type Name Format (TNF):0x04(NFC Forum external type)
    • Type:android.com:pkg
    • Payload:  WeChat 安卓包名com.tencent.mm

    While iOS only recognizes the URI Record, Android also needs the AAR to specify the pull up WeChat.

    # Use Procedure

    # 1. Device Access

    Weixin Mini Program To open Mini Programs with NFC tags, you first need to access the device, see the " device access " document. Once the access is complete, the developer gets a model_id assigned by the platform.Model_id corresponds to a device type and is an important credential for calling the Weixin Mini Program device capability related interface.

    # 2. Applicant ability

    After the device access is approved, click "Apply for device capabilities" on the Weixin Mini Program Administration Console - Functions - Hardware Devices - Device Management" page and select "NFC tag activation Mini Program."

    # 3. Application for URL Scheme

    After the application ability is approved, the Weixin Mini Program scheme for obtaining NFC via the [interface can obtain the URL scheme to open any page of the Mini Program in an NFC scenario.

    # 4. Start Using

    1. Prepare NFC tags that meet the required format.
    2. Using a device that supports NFC, install the latest version of the WeChat guest, close to the NFC tab to open the corresponding Weixin Mini Program page in the scheme.

    # Restrictions on Use

    • NFC support is required for use. The iPhone requires XS and above.
    • You need to unlock the device before you can use it.
    • It cannot be used when using the system wallet, camera, or when flying mode is turned on.

    # Note

    • Android can directly open Weixin Mini Program, iOS requires users to click an additional system notification banner confirmation.
    • Android WeChat 8.0.14 version below can pull up WeChat, but can not open Weixin Mini Program.

    # 5. Common problem

    # 5.1 NFC tag can't pull up WeChat (Android)

    Opening apps using the AAR tab is a capability provided by Android.

    If some devices fail to pull up WeChat, there may be the following reasons

    1. Device does not support NFC or NFC functionality is turned off
    2. Device not installed WeChat
    3. The ability to NFC pull up apps is disabled in device settings

    If all devices fail to pull WeChat up, there may be the following reasons

    1. AAR package name was written in error or not in the specified format

    # 5.2 The NFC tag can pull up WeChat, but not Weixin Mini Program, or the PTC page

    • The Scheme filled in is invalid (incomplete, formatted wrong or invalid, etc.) or is not written in the specified format
    • WeChat version is too low, suggest upgrading and try again (Android requires at least 8.0.14)