# WeChat Mini Program Code

> Source: https://docs.barcoder.ai/docs/standards/wechat-mini-program-code
> research date 2026-06-03 · extracted at 2026-10-06
> Publisher: Barcoder — encyclopedia of QR, barcode and payment-code standards

Specifications:
- [Get Weixin Mini Program code — WeChat Open Ability docs](https://developers.weixin.qq.com/miniprogram/en/dev/framework/open-ability/qr-code.html)

## 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 <sup>[3][3]</sup>. 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 <sup>[6][6]</sup>.

## 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 <sup>[5][5]</sup>. 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 <sup>[6][6]</sup>.

## Technical specification

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

- **Two output formats:** a **circular Mini Program Code** (recommended; better recognition and advanced capabilities) and a conventional **square QR code** (not recommended) <sup>[3][3]</sup>.
- **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) <sup>[3][3]</sup>.
  - **`getwxacodeunlimit`** (interface B) — for high volume; effectively unlimited codes but rate-limited to ~5,000 calls/minute; requires short scene parameters <sup>[3][3]</sup>.
  - **`createwxaqrcode`** (interface C) — square QR variant; capped (shares the ~100,000-code limit with interface A) <sup>[3][3]</sup>.
- **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) <sup>[1][1]</sup>.
- **Validity:** all generated Mini Program codes are **permanently valid** and can be safely cached/printed; codes can only be generated for **published** Mini Programs <sup>[3][3]</sup>.
- **Scope:** scanning resolves only within WeChat, taking the user to the targeted Mini Program page <sup>[3][3]</sup><sup>[6][6]</sup>.

## 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 <sup>[6][6]</sup>.
- Pre-generated batch codes for large-scale campaigns (using the unlimited `getwxacodeunlimit` interface) <sup>[3][3]</sup>.
- Travel, ticketing, and in-store service flows where a one-time service is needed without installing a separate app <sup>[5][5]</sup>.

## 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 <sup>[3][3]</sup>. 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 <sup>[1][1]</sup><sup>[2][2]</sup>.

## 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 <sup>[3][3]</sup><sup>[6][6]</sup>. A square QR fallback exists for compatibility, but Tencent steers developers to the circular form for better scan recognition and access to advanced features <sup>[3][3]</sup>. The deliberate restriction on long-press scanning further distinguishes it from open QR, prioritizing physical-world O2O conversion over in-app virality <sup>[6][6]</sup>.

## 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 <sup>[6][6]</sup>.

## Status

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

## Sources

[1] [How to generate dynamic QR code for WeChat Mini-Program](https://davidyu-44356.medium.com/how-to-generate-dynamic-qrcode-for-wechat-mini-program-8a591504c95) — David Yu, Shanghai Coders (Medium), 2020
[2] [wechat-miniprogram-wiki](https://github.com/schmunk42/wechat-miniprogram-wiki) — schmunk42 (GitHub), 2019
[3] [Get Weixin Mini Program code](https://developers.weixin.qq.com/miniprogram/en/dev/framework/open-ability/qr-code.html) — WeChat / Tencent developer docs, 2024
[5] [WeChat Mini-Programs Guide 2025](https://thechina.travel/apps/mini-program/) — The China Travel, 2025
[6] [WeChat Mini Program: The QR Code Dilemma](https://medium.com/@tmo_group/wechat-mini-program-the-qr-code-dilemma-8234652b63c9) — TMO Group (Medium), 2018

[1]: https://davidyu-44356.medium.com/how-to-generate-dynamic-qrcode-for-wechat-mini-program-8a591504c95
[2]: https://github.com/schmunk42/wechat-miniprogram-wiki
[3]: https://developers.weixin.qq.com/miniprogram/en/dev/framework/open-ability/qr-code.html
[5]: https://thechina.travel/apps/mini-program/
[6]: https://medium.com/@tmo_group/wechat-mini-program-the-qr-code-dilemma-8234652b63c9

## Deployments

_No country reports mention this standard by name._
