WeChat Mini Program Code

Overview

A WeChat Mini Program Code (Weixin mini program code) is Tencent's proprietary circular scannable code that opens a specific page of a WeChat Mini Program — a sub-application that runs inside the WeChat super-app. It is rendered as a distinctive circular pattern with the Mini Program's icon at the center, and is the format Tencent recommends over a plain square QR code for better recognition and richer capabilities [3]3. It is designed to be scanned through WeChat; WeChat-specific codes generally require the native WeChat scanner and do not resolve in ordinary camera apps [6]6.

History

WeChat Mini Programs launched in January 2017 as an in-app application platform, and the circular Mini Program Code is Tencent's branded entry point into them [5]5. Tencent has at times experimented with how Mini Program codes/QR codes may be scanned: it tested allowing Mini Program access by long-pressing an in-chat QR image, then disabled that path within days, reflecting a deliberate strategy of steering Mini Programs toward in-the-moment, offline-to-online (O2O) scanning rather than viral image sharing [6]6.

Technical specification

Tencent does not publish the code's binary symbology, but the developer platform documents its generation and behavior [3]3:

• Two output formats: a circular Mini Program Code (recommended; better recognition and advanced capabilities) and a conventional square QR code (not recommended) [3]3.
• Three generation APIs, all server-side and requiring an access token:
  • getwxacode (interface A) — accepts longer path parameters; capped (shares a ~100,000-code total limit with interface C) [3]3.
  • getwxacodeunlimit (interface B) — for high volume; effectively unlimited codes but rate-limited to ~5,000 calls/minute; requires short scene parameters [3]3.
  • createwxaqrcode (interface C) — square QR variant; capped (shares the ~100,000-code limit with interface A) [3]3.
• Parameters include path (the Mini Program page to open), width (default 430 px, min 280, max 1280), auto_color, line color, and is_hyaline (transparent background) [1]1.
• Validity: all generated Mini Program codes are permanently valid and can be safely cached/printed; codes can only be generated for published Mini Programs [3]3.
• Scope: scanning resolves only within WeChat, taking the user to the targeted Mini Program page [3][3][6]6.

Use cases

• Offline-to-online entry points: codes on storefronts, posters, packaging, menus, and event tickets that open a merchant's Mini Program page directly [6]6.
• Pre-generated batch codes for large-scale campaigns (using the unlimited getwxacodeunlimit interface) [3]3.
• Travel, ticketing, and in-store service flows where a one-time service is needed without installing a separate app [5]5.

Implementations

There is no official open-source encoder for the proprietary circular symbology; codes are produced only through Tencent's server-side APIs against a published Mini Program [3]3. Community resources document the workflow rather than the format — e.g. a developer write-up on generating dynamic codes and an English-language Mini Program wiki — but these wrap Tencent's APIs rather than re-implementing the code [1][1][2]2.

Comparison

Like Apple's App Clip Code and Snap's Snapcode, the WeChat Mini Program Code is a brand-controlled symbology chosen over plain QR for recognizability and platform lock-in: the circular shape signals "this opens a WeChat Mini Program," and resolution is confined to WeChat's scanner so Tencent controls the funnel [3][3][6]6. A square QR fallback exists for compatibility, but Tencent steers developers to the circular form for better scan recognition and access to advanced features [3]3. The deliberate restriction on long-press scanning further distinguishes it from open QR, prioritizing physical-world O2O conversion over in-app virality [6]6.

Fun facts

• WeChat's leadership framed Mini Programs as services users "only need at a specific moment," which is why the platform intentionally limited image-based QR scanning to discourage Mini Programs from farming sharing traffic [6]6.

Status

Active. A core part of the WeChat Mini Program ecosystem; codes are generated via Tencent's developer APIs and scanned inside WeChat [3]3.

Sources

1 How to generate dynamic QR code for WeChat Mini-Program — David Yu, Shanghai Coders (Medium), 2020 2 wechat-miniprogram-wiki — schmunk42 (GitHub), 2019 3 Get Weixin Mini Program code — WeChat / Tencent developer docs, 2024 5 WeChat Mini-Programs Guide 2025 — The China Travel, 2025 6 WeChat Mini Program: The QR Code Dilemma — TMO Group (Medium), 2018

Deployments

No country reports mention this standard by name.