What "WeChat QR code" actually means (it is six different things)
You typed "WeChat QR code" into Google because you have a specific job to do. The first useful thing this guide does is split the phrase into the six things it can mean, because the answer for each is different.
1. Payment QR. Used at the point of sale, in both directions. The merchant displays a static QR and the customer scans to pay; or the customer displays a one-time QR from inside WeChat Pay and the merchant scans to charge. The codes are generated inside the WeChat Pay system.
2. Personal-profile QR (add-as-friend). Every WeChat user has a personal QR in their profile. Scanning it triggers the "add as friend" flow. Generated inside the WeChat app.
3. Official Account QR. The brand or business equivalent of a personal profile. Scanning it lets the user follow the Official Account. This is the closest WeChat equivalent to "follow our brand on social." Generated inside the Official Account admin console at mp.weixin.qq.com.
4. Mini Program QR. A Mini Program is an app-like experience that runs inside WeChat with no separate app install. The QR launches the Mini Program straight into a specific screen. Generated inside the WeChat Mini Program developer tools, with a visually distinct rounded-corner aesthetic.
5. Group-entry QR. A QR that lets the scanner join a WeChat group of up to 200 members. Generated by a group admin inside the group settings, and expires after seven days by default.
6. Desktop / Web login QR. Shown by web.wechat.com and the WeChat desktop client. Scanning with the phone authorises the session.
These six contexts share almost nothing operationally. They are generated by different parts of the WeChat platform, encode different kinds of identifiers, and serve different user flows. The single most common mistake in Western "WeChat QR" coverage is treating them as one product. They are not.
For the rest of this guide, "WeChat URL QR" means a standard URL QR generated by a tool like EZQR's WeChat QR generator that points at a WeChat web destination. That is the only category a third-party Western tool can produce.
WeChat in context: why QR is a first-class UI element
To understand why WeChat QR is structured the way it is, you have to remember what WeChat actually is. It is not a social network. It is not a messaging app. It is a Tencent-owned super-app that bundles messaging, payments, social feed, identity, login provider, mini-app runtime, and merchant tools into a single client. As of Tencent's most recent quarterly reporting, WeChat (Weixin in mainland China) had over 1.38 billion monthly active users — for orders of magnitude, you can cross-check against the Wikipedia WeChat reference and Tencent's own investor materials.
Inside China, smartphone penetration is effectively saturated and WeChat is installed on essentially every device. That installed base is the substrate for the QR-as-interaction pattern. When you want to pay a street vendor, the vendor shows a printed QR. When you want to add a contact, you scan their QR. When you want to follow a brand, you scan its Official Account QR. When you want to enter a restaurant's loyalty program, you scan the Mini Program QR taped to the table.
The analogy to Western consumer software does not hold. There is no Western app on which the QR scanner is the default opening surface, accessed more often than search. In WeChat, the scan tab is a top-level navigation primitive. The reason QR became the substrate of Chinese commerce is the same reason it almost did not become the substrate of Western commerce until 2017 — every Chinese phone shipped with a competent QR scanner built into the app every user already had, while Western phones did not have native QR decode in their camera apps until Apple's iOS 11. That history is covered in detail in our QR code history post.
For a non-Chinese brand, the practical takeaway is that scanning a QR is not a niche behaviour to your Chinese customer. It is the default. Building distribution that does not assume QR scanning is the primary entry point is the marketing-side equivalent of refusing to ship a website.
Type 1: WeChat Pay QR — both directions
WeChat Pay supports two QR flows at the point of sale, and getting them confused is the most common source of confusion in English-language coverage.
Merchant-presented QR (static or dynamic). The merchant displays a printed or screen-displayed QR encoding their merchant identifier. The customer opens WeChat, taps Scan, points the camera at the code, enters an amount, and confirms. This is the dominant pattern for street vendors, small shops, taxis, and any merchant who does not want a card terminal.
Customer-presented QR (one-time). The customer opens WeChat Pay and taps "Pay" to reveal a short-lived QR encoding a single-use payment token. The merchant scans it with a handheld scanner or a phone, the amount is applied at the merchant side, and the transaction settles. This is the dominant pattern at supermarket chains, large retailers, and anywhere the merchant has invested in scanning hardware.
Both flows are inside the WeChat Pay system end to end. There is no third-party generator involved on the WeChat side — Tencent's servers mint and validate the payment identifiers. A Western URL QR generator cannot produce either flow. What it can do is link to a WeChat Pay landing page or to a brand page that explains how to pay via WeChat — useful for travel-oriented signage, but not the same as being an accepting merchant.
The nearest functional Western analogue is the way Apple Pay and Google Pay tokenise card details for tap-to-pay. WeChat Pay tokenises into a QR instead of an NFC payload. The economic reason for that choice is covered later in this guide.
Type 2: Personal-profile QR — the add-as-friend code
Every WeChat user has a personal QR code under "Me → My QR Code" inside the app. The code encodes a WeChat-internal user identifier, not a URL. When another WeChat user scans it, the app routes them to the add-as-friend confirmation screen for that user.
A non-WeChat scanner — your iPhone Camera app, for instance — does not know what to do with the code. The encoded payload is meaningful only inside WeChat. If you copy the underlying string and paste it into a browser, nothing useful happens.
This matters because a non-trivial fraction of "I cannot scan a WeChat QR code" support tickets come from users trying to scan a personal-profile QR with a non-WeChat app. The correct fix is to open the scan tab inside WeChat itself, not to try a different external scanner. The pattern is the same for the Official Account QR and the Mini Program QR, which is why we keep coming back to the point that the WeChat-native QR formats are closed-platform identifiers, not URLs.
A brand has no use for the personal-profile QR. It belongs to individual users. The brand-side equivalent is the Official Account QR, which is the next section.
Type 3: Official Account QR — the closest WeChat equivalent to "follow us"
A WeChat Official Account is a brand or business profile on WeChat. There are subtypes (Subscription, Service, Enterprise) that differ on what they can post and what APIs they can call, but the QR mechanics are the same — each Official Account has a public QR that, when scanned inside WeChat, lands the user on the Account profile with a "Follow" button.
This QR is the one most non-Chinese brands actually want. It is the entry point to ongoing WeChat distribution. Once a user follows an Official Account, the Account can push articles, coupons, and Mini Program launches into the user's WeChat feed. For travel brands targeting Chinese visitors, retail brands wanting to be discoverable on Chinese e-commerce, and B2B brands needing a credible Chinese-market presence, the Official Account is the foundation.
The QR itself is generated inside the Official Account admin console at mp.weixin.qq.com. You can also export a standard URL pointing at the Official Account's WeChat web profile, which is what a third-party URL QR generator wraps in a print-ready code. Both routes resolve to the same destination — the difference is that the WeChat-native version is minted inside WeChat's admin tools, and the URL version is generated by any URL QR tool like EZQR's WeChat QR generator or our general-purpose URL QR generator.
The bottleneck for non-Chinese brands is the Account registration, which generally requires a China-incorporated business entity or an authorised agency partnership. Tencent has tightened verification requirements over the past several years; a domain name and a credit card will not get you a verified Official Account. That registration step is the actual hard part of "putting a WeChat QR on our packaging," and it is the part the generator pages on the open internet rarely mention.
Type 4: Mini Program QR — the rounded-corner aesthetic
Mini Programs are the most interesting and least-understood category of WeChat QR. A Mini Program is an app-like experience that runs inside WeChat with no separate install, written in a WeChat-specific framework that compiles to a constrained subset of JavaScript and WebAssembly. The runtime sits inside the WeChat client; the developer ships an updated bundle to Tencent's servers and every WeChat user gets the new version on next launch.
The relevant Western analogue is closer to Apple App Clips or Telegram Bots than to a website or a native app. Major Western brands have invested in WeChat Mini Programs precisely because the user does not have to install anything — Starbucks China, Burberry, Nike, and Tesla all run Mini Programs as their primary China-side digital touchpoint. Tencent's developer documentation landing page is the authoritative reference for the runtime.
The Mini Program QR is visually distinct from a normal QR. Instead of square modules it uses rounded-corner modules in WeChat's palette, with the WeChat logo and a Mini Program logo inset into the centre. This aesthetic is enforced by the generator inside the Mini Program developer console — third-party tools cannot replicate it because the underlying payload is a WeChat-internal launch identifier, not a URL. Scanning the Mini Program QR opens the program directly into the path encoded by the developer, supporting deep-linking into specific screens.
What a third-party URL QR generator can do is wrap the public Mini Program launch URL in a normal square URL QR. The URL resolves to the Mini Program when opened inside WeChat. The visual aesthetic will not match the rounded-corner native version, but for print contexts where the brand wants to keep visual control of the code, the URL approach is the practical workflow. Our multi-URL QR generator is useful when the brand wants the same printed code to deep-link into the Mini Program for WeChat users and into a Western landing page for everyone else.
Type 5: Group-entry QR — the seven-day timer
WeChat groups (group chats) support up to 200 members. The group admin can generate an entry QR from inside the group settings; anyone who scans it inside WeChat joins the group. The QR expires after seven days by default, which is a deliberate Tencent policy to prevent stale codes from circulating indefinitely on the open web.
The seven-day expiration is the single most common source of "WeChat QR code stopped working" complaints. The code was minted inside WeChat, printed or posted somewhere external, and the seven-day timer ran out before the campaign ended. There is no "permanent group QR" option in WeChat — if you need ongoing recruitment into a group, the standard pattern is to rotate the QR weekly, or to put a permanent Official Account QR on the print material and route group invites through Account-side messaging.
This is one of several places where the WeChat platform's assumptions clash with how Western marketers expect QR codes to behave. The cancellation-style concerns we cover in our permanent QR code generator breakdown are about vendor lock-in. The WeChat group QR has an entirely different failure mode: it expires on purpose, by platform policy, regardless of what any vendor does.
Type 6: WeChat desktop and web login QR
When you visit web.wechat.com or open the WeChat desktop client, the login screen displays a QR. Scanning it with the WeChat mobile app authorises the new session and effectively logs you in on the new device. This is the same general pattern Telegram, Signal, and Discord use for desktop login, and it is the cleanest example of QR as a frictionless auth handoff between a trusted device (the phone) and a new device (the desktop).
The encoded payload is a one-time session identifier minted by Tencent's servers, valid for a short window. Scanning a stale desktop-login QR produces a "code expired" error inside the WeChat app and the browser refreshes the QR. This is by design and is the right behaviour for an auth flow.
A Western brand has effectively no involvement with this category. It is included here for completeness, because anyone writing about WeChat QR who omits it tends to be writing about WeChat QR without using WeChat. The full set of categories matters when you are trying to understand why a single phrase covers so many different mechanics.
The six WeChat QR types at a glance
The same information, in one place, with the generator and the practical scope flagged explicitly.
| Type | Generated where | Payload encodes | Third-party tool can mint? |
|---|---|---|---|
| Payment QR (merchant or customer) | WeChat Pay system | Merchant identifier or one-time payment token | No |
| Personal-profile QR | Inside WeChat app (Me → My QR Code) | WeChat-internal user identifier | No |
| Official Account QR | mp.weixin.qq.com admin console | Account identifier (or public profile URL) | Indirectly — URL QR of the public profile URL |
| Mini Program QR | WeChat Mini Program developer tools | Mini Program launch identifier and deep-link path | Indirectly — URL QR of the public launch URL |
| Group-entry QR | Inside WeChat group settings | Group entry token (expires in 7 days) | No |
| Desktop / Web login QR | WeChat servers, displayed by web client | One-time session token | No |
Why Western QR generators cannot mint a true WeChat QR
Here is the honest moment most posts on this topic skip. EZQR cannot generate a true WeChat QR code. Neither can QR Tiger, Uniqode, Flowcode, QRCode Monkey, the QR Code Generator at qr-code-generator.com, ME-QR, Scanova, The QR Code Generator, or any other third-party tool on the open Western internet — the full vendor field is covered in our best QR code generators of 2026 roundup. The reason is structural, not a feature gap.
The WeChat-native QR categories — payment, personal profile, Mini Program launch, group entry, desktop login — encode WeChat-internal identifiers that are minted by Tencent's servers and validated only inside the WeChat client. There is no public API for "give me a payment-QR identifier" or "give me a Mini Program launch identifier" that a third-party generator could call. Tencent does not expose those primitives outside the WeChat platform, by design. The closest public surface is the Mini Program admin tooling, which requires a verified developer account tied to a China-incorporated business entity.
What every third-party "WeChat QR generator" page on the open internet actually produces is a standard URL QR code that links to a WeChat web destination. The QR conforms to ISO/IEC 18004, the same standard underneath every other URL QR, and the same standard our Data Matrix vs QR code comparison discusses against the older industrial 2D format. The destination is a WeChat-hosted URL — an Official Account public profile, a Mini Program launch link, the WeChat Pay landing page. When a user scans the QR with WeChat's scanner, WeChat recognises the destination as a WeChat-routed URL and treats it as if the user had tapped a WeChat-internal link. When a user scans the same QR with a non-WeChat scanner — the iPhone Camera app, for instance — they get a standard URL that opens in a browser and lands on the WeChat web profile, which is a perfectly functional landing page for context.
This is the honest answer to the question "can I generate a WeChat QR for my packaging?" Yes, in the sense of "yes, a URL QR pointing at your WeChat destination." No, in the sense of "no third-party tool can mint the WeChat-internal proprietary QR." The first sense is what almost everyone actually needs.
What EZQR can actually do for WeChat-targeting brands
For a non-Chinese brand wanting WeChat presence with QR distribution on physical materials (packaging, signage, business cards, in-store posters), here is the concrete capability stack.
Generate a URL QR linking to your WeChat Official Account public profile. The URL is the public profile of your Account on weixin.qq.com. The QR wraps that URL. When a user scans it inside WeChat, the WeChat scanner recognises the destination and shows the Account profile with the Follow button. When scanned from the iPhone Camera or a Western Android scanner, the URL opens in a browser to the same web profile.
Generate a URL QR linking to a Mini Program launch URL. Mini Programs expose a public URL that, when opened inside WeChat, launches the Mini Program. A URL QR wrapping that link works the same way as the Official Account pattern.
Generate a URL QR linking to a WeChat Pay merchant landing page. Useful for travel brands wanting to display "we accept WeChat Pay" signage that links to your merchant-side payment instructions.
Generate a multi-URL QR for split routing. For print materials seen by both Chinese and Western audiences, our multi-URL QR generator lets the same printed code route by user-agent or by language — WeChat users go to the Mini Program, English-language users go to the brand's English landing page.
The code itself is a standard ISO/IEC 18004 URL QR. The destination is what makes it "a WeChat QR." Our WeChat QR generator page walks through the URL formats Tencent supports for these flows, and the broader URL QR generator is the underlying tool. Pricing follows the EZQR plan structure — for a one-time print where the URL will not change, a free static URL QR is the right answer.
The actual workflow for a non-Chinese brand wanting WeChat presence
Step by step, the practical path from "we want a WeChat QR on our packaging" to "the code is printed and works."
Step 1: Register a WeChat Official Account. This is the hard step and the one most generator pages skip. Tencent's verification process generally requires a China-incorporated business entity (Wholly Foreign-Owned Enterprise or local partner) or an authorised agency partnership. Authorised agencies will register the Account on behalf of a foreign brand for a fee — common rates land in the low thousands of US dollars for setup plus an annual maintenance fee. Plan for several weeks of paperwork and turnaround.
Step 2: Inside the Official Account admin console at mp.weixin.qq.com, retrieve the public profile URL or download the native QR. The native QR is a normal-looking square QR with the WeChat logo inset in the centre. The public profile URL can be wrapped in any URL QR generator.
Step 3: Use EZQR to wrap the URL in a print-ready QR. For static destinations (the Account profile URL will not change), a free static QR from EZQR's WeChat URL QR generator is the right call — the QR is permanent in the same way ink on paper is permanent, and there is no vendor-cancellation risk to worry about. For destinations that may change (a campaign-specific Mini Program path, for instance), a dynamic QR from a vendor with a clean cancellation policy is the right call; the trade-offs there are covered in our permanent QR code generator breakdown and our static vs dynamic deep dive.
Step 4: Choose an error-correction level appropriate for the print context. Packaging, in-store signage, and outdoor materials typically use level H (30% error correction) to survive abrasion, smearing, and partial damage. The technical detail is covered in our QR code error correction levels guide.
Step 5: Print at the right physical size. The 10:1 rule (scan distance in feet divided by 10 equals minimum code size in inches) is the rule of thumb. A code printed on a 6-foot poster needs to be at least roughly 4 inches per side. The shorter, restaurant-table case is closer to 1.5 inches per side. The QR code examples gallery covers the size-by-context patterns in detail.
The pattern: the QR generation is the easy step. The Official Account registration, the destination strategy, and the print specs are the parts that take work. The table below collapses the workflow into a one-glance reference, with the time and dependency cost flagged at each step.
| Step | What you do | Typical timeline | Dependency |
|---|---|---|---|
| 1. Register Official Account | Apply via Tencent or an authorised agency partner | 2-6 weeks | China-incorporated entity or agency partnership |
| 2. Retrieve destination URL | Pull the public profile URL or Mini Program launch URL from mp.weixin.qq.com | Same day | A verified Official Account or Mini Program |
| 3. Wrap URL in a print QR | Generate a free static URL QR via EZQR | Under 5 minutes | A URL QR generator (any reputable tool) |
| 4. Set error correction | Level H (30%) for packaging, outdoor, abrasion-prone print | Same generator step | Sufficient quiet zone and module size |
| 5. Size the printed code | 10:1 rule — scan distance in feet ÷ 10 = inches per side | Print spec step | Print substrate with adequate contrast |
Mini Programs and the QR moment
Mini Programs deserve their own treatment because they are the most under-appreciated WeChat surface in Western coverage. The model: a developer ships a WeChat-runtime application that runs inside the WeChat client with no install step. The user discovers the program by scanning a QR, by tapping a link inside an Official Account article, or by searching inside WeChat. The program launches in roughly the time a website takes to load on a fast connection.
The Mini Program catalogue has scaled past the million-program mark over multiple years of Tencent reporting, with daily active users in the hundreds of millions. Major Western brand deployments include Starbucks China (mobile order-ahead and loyalty), Burberry (in-store retail companion), Tesla China (test drive booking and showroom navigation), Nike, and Sephora. These are not marketing experiments — they are the primary China-side digital touchpoint for each of these brands.
The QR is the access primitive. A Burberry store in Shanghai uses a Mini Program QR on table cards to launch the in-store experience; a Tesla showroom uses a Mini Program QR for test-drive sign-up; Starbucks China uses Mini Program QRs at the counter for mobile order-ahead. These QRs are minted inside the Mini Program developer console and have the distinctive rounded-module aesthetic. For Western print materials targeting both Chinese and non-Chinese audiences, the practical workflow is the URL-wrapped Mini Program launch link rather than the native Mini Program QR — same destination, less brand-pretty, but mintable by any URL QR generator.
WeChat Pay vs Alipay: the two dominant Chinese payment QRs
Outside China, "WeChat" and "Alipay" are mentioned in the same sentence so often that it is worth clarifying how they actually differ.
WeChat Pay is the payments arm of WeChat, owned by Tencent. The flow lives inside the WeChat super-app — payment is one of dozens of features the same app provides.
Alipay is the payments app from Ant Group, originally a subsidiary of Alibaba. Alipay is a payments-first app with its own catalogue of mini-programs, lifestyle services, and identity features. There is no Tencent-side equivalent of "Alipay" as a standalone app; payments on the Tencent side live inside WeChat.
Both use QR codes for in-store payment and both support the merchant-presented and customer-presented flows described earlier. Aesthetically the QRs look different — the WeChat Pay branding is green-on-white and the Alipay branding is blue. At many merchant terminals the same scanner accepts either app's customer-presented QR, because the payment standard (the EMV/UnionPay-style merchant QR specification underneath) is broadly shared. The end-user experience flows through two different apps with two different reward and loyalty systems, but the merchant side has converged on accepting both.
For a non-Chinese brand, the implication is simple. If you want to accept Chinese consumer payments at a Western physical location, the practical play is to work with a payment processor that supports both WeChat Pay and Alipay rather than picking one. Stripe, Adyen, and several specialised Chinese-payment gateways offer this. The QR signage you display will typically link to both, side by side.
The QR vs NFC subplot in China
There is a question that surfaces in every Western "why QR in China" conversation. Why did China standardise on QR for in-store payments while the West largely standardised on contactless NFC cards?
The answer is straightforward and not exotic. Around 2014, when the two paths diverged, every Chinese smartphone was already a functioning QR scanner because WeChat and Alipay shipped with QR scanners built in. The deployment cost on the merchant side was a printed sticker. Compare to the Western contactless infrastructure, which required replacing point-of-sale terminals with NFC-capable readers — a multi-billion-dollar capex cycle that ran across the mid-2010s and is still incomplete in parts of Europe and the US.
China also had a card-acceptance gap. Card terminals were rarer than in the West, especially in smaller cities and at street-vendor level. A QR-on-sticker payment flow leapfrogged the terminal infrastructure entirely. The smartphone-side capability was already deployed; the merchant-side capability cost roughly nothing. The result was that QR payment penetration in Chinese in-store retail crossed 90% over several years, while the West's NFC transition is still partial more than a decade in.
The broader pattern — open standards, mobile-first deployment, leapfrogged hardware — is one of the case studies in our NFC vs QR comparison. The same comparison covers the technical differences between QR (visual, line-of-sight, free to deploy on any printable surface) and NFC (radio, proximity-based, requires a powered reader). Neither is universally better; the answer depends on the deployment economics and the installed reader base. China's installed reader base was the front-facing camera on every WeChat user's phone. That is hard to compete with.
Why this matters when you commission a WeChat QR for print
A non-Chinese brand printing a "WeChat QR" on packaging, signage, or business cards is doing one of two things, almost always: linking to an Official Account profile so Chinese-speaking customers can follow the brand, or linking to a Mini Program so they can launch a brand experience. Both are URL QR jobs. Both are mintable by EZQR's WeChat URL QR generator. The technical part is a standard ISO/IEC 18004 URL QR. The strategic part is which destination URL to point it at, which depends on the Official Account and Mini Program decisions made several steps upstream.
The parts you do not have to worry about are also worth naming. You do not need to license anything from Tencent to wrap a public WeChat URL in a print-ready QR. You do not need a Chinese hosting provider for the QR generation step. You do not need a Chinese mobile carrier or a China-incorporated entity to generate the URL QR — only to register the Official Account or Mini Program at the destination. You do not need to pay an annual subscription to a "WeChat-specialist" QR vendor for the QR itself; the QR is a commodity and a free static URL QR from any reputable generator works.
The parts you do have to worry about are the destination strategy (which Official Account, which Mini Program path), the print specs (error correction, size, contrast), and the cancellation policy of the QR vendor if you choose a dynamic QR. Our retail QR codes industry overview and marketing QR codes industry overview cover the print-side considerations in more depth, including bilingual layouts where the WeChat QR sits next to a Western-audience landing-page QR on the same packaging panel.