# WeChat "One thing one yard"

# I. Application process

The overall process is as follows:

# 1. Conditions of application

  1. Certified Service Account.
  2. There is a clear object-to-code coding scenario, and it is expected to achieve anti-counterfeiting, origin-tracing, marketing, digital operations and so on through product coding.

# 2. Access to applications

  1. Access the application page from notification channels such as on-site mail.
  2. Add function from Official Account menu, enter one thing one code, click Apply to enter the application page.

The results of the application will be notified via the reserved contact email.

# II. Coding Management

# 1. Call the "Request and obtain QR codes" interface

Interface documentation

Through the interface you can obtain formats as:

a1 b1 c1 d1
a2 b2 c2 d2
  • A is 361 bytes 01 dot matrix, used to support the generation of 19 times 19 micro code, 0 is white, 1 is black
  • B is the source code data, up to 9 bits
  • C is the index position of the code in this application
  • D is 28 characters, used to support the conversion to ordinary two-dimensional code. Two-dimensional codes capable of generating code system 2 and error correction level Q.

# 2. Select the type of QR code you need

Microcodes can be used if there is a need to encode at a smaller print area or if the security afforded by special codes is required. The micro code is Tencent's patent code system, cannot be copied by other organizations or individuals, and supports the minimum printing area of 0.5cm multiplied by 0.5cm.

Please note:

  1. The printing of a microcode requires turning the dot array into a QR code. If your device provider doesn't support it, you can contact wxsaoyisao@tencent.com Printed under the direction of the staff.
  2. Microcode reading requires an upgrade to the WeChat engine.If your production line has a link to collect QR code information, you can contact us and the staff will guide the equipment provider to upgrade.
  3. If there is no need for printing under a smaller area, ordinary QR codes can be used. The printing and reading and passage standards of ordinary QR codes are consistent.

A comparison table of microcode and common code

# 3. Manage microcodes and complete product coding

After obtaining the microcode, the production line is modified according to the production process and the coding, and the QR code is printed on the goods. It is also possible to print the code first, manage distribution, and then associate with the goods.

# III. Development of Weixin Mini Program

# 1. One-size-fits-all scheme design

Based on different needs scenarios, market research is conducted and the overall solution is designed one-size-fits-all. Planning programme objectives, budgets and specific steps for implementation. This step usually occurs before the assignment of the code.

# 2. Development Weixin Mini Program

The WeChat scan portal and the Weixin Mini Program tool provide a carrier for one object and one code.Small-picture developers can set different scanning policies based on different users and QR codes.

Weixin Mini Program Development documentation

One object one code generated two dimensional code is a kind of Weixin Mini Program code, with the following special product capabilities:

# 2.1 Weixin Mini Program Focus on Official Account Components

Weixin Mini Program Follow Official Account function can help brands reach users better. It can send Official Account message template to realize the reflow of users and cultivate users' stickiness.

The current feature supports Official Account binding to the same principal. Please bind the Mini Program in Weixin Mini Program management, you can go to the Mini Program management background, in the "Settings" - "Concerned about the Official Account" binding, set the Official Account template to be consistent with the body of the Mini Program. When the user scans the Mini Program code to open the Mini Program, the developer can configure the Official Account message template in the Mini Program, which is convenient for the user to quickly follow the Official Account, and can be nested in the native component.

Refer to development documentation

Component notation:

# 2.2 Weixin Mini Program Red envelopes

Weixin Mini Program Red envelopes are an important function to attract users to participate in a code scanning activity, which can significantly improve the code scanning rate.Users who scan the bottle QR code and enter the small app to collect red envelopes can directly collect user change money, which serves as an incentive to prompt users to buy back goods.

The application conditions need to meet: the merchant number meets the WeChat payment product opening conditions, Weixin Mini Program has not opened the social red envelope category.

Functional indicators:

# 3. Activate QR codes and put them on the market

Typically, there is a process of QR code activation before the goods are put on the market, which is aimed at reducing the risk of code leakage in production.WeChat One-item-one-code code activation, which aims to return product information (to provide data analysis services), define code and Weixin Mini Program jump relationships, should be completed before the original activation process and does not affect the original setup.

# 4. Login to MP to view data

After the goods are put into the market, log in the Official Account background, select one thing one code function, you can view the scanning data and user analysis.The activity name, trade name, and brand in the data caliber are all from the fields defined when the QR code is activated. Please note that you fill in the analytical request specification when activating.

# IV. Service providers implement business on their behalf

The overall process of one thing, one code includes planning, offline code printing, online Official Account interface calls & Weixin Mini Program development. Service providers can help merchants use microcodes and skip Mini Programs by following the following processes.

# 1. Becoming a third-party service provider on an open platform

Service providers need to pass the developer quality certification, become open platform third-party service providers can be on behalf of Official Account to achieve business, on behalf of Weixin Mini Program to achieve business.

# 2. Call an object-to-code interface on behalf of the merchant

Reference to implement business documents on behalf of Official Account

Brands need to login Official Account to authorize third-party service providers, and then third-party service providers through the call interface to achieve Official Account message template business.Merchants refer to the above opened a code of one thing at the same time, third-party service providers need to apply to WeChat for a third-party download key, the method is linked mailbox (wxsaoyisao@tencent.com) send an email describing the service provider and provide a third-party APPID.

A third-party service provider invokes a one-item-one-code interface to issue a code and activate reference above.

# 3. Weixin Mini Program

Brand Weixin Mini Program need to be authorized, Third Party Platform can be Mini Program development, reference authorization process .

When a third-party service provider helps its authorized Weixin Mini Program with code management, You must first develop the Mini Program template and then deploy the Mini Program model to your Mini Program account. The process is related to to implement the Mini Program business instead .

# 4. Become a WeChat One Thing One Code Partner

Having the ability to help brands achieve "one thing, one size," third-party service providers can enter the WeChat service provider market, fully demonstrate their capabilities, and broadly reach merchants with digital marketing needs.

Log in [WeChat-END]] Open the community](https://developers.weixin.qq.com/community/servicemarket) Create a business home page, for detailed process references Process guidelines .

Third-party service providers can display their services in the enterprise homepage, supporting the use of graphics, rich media and other formats to show the past case, and a code related to marketing, anti-counterfeiting and other modules. After the quality of service is evaluated, the compiled homepage can be searched by the merchant by the recommended keyword, service industry and relevant keyword.

# V. List of interfaces

Request and obtain QR codes

用户扫描二维码

Interface NameEnglish nameRequest Path
Check the QR code application form interfaceintp_marketcode_applycodequery/intp/marketcode/applycodequery
Download QR Code Package Interfaceintp_marketcode_applycodedownload/intp/marketcode/applycodedownload
Activate QR code interfaceintp_marketcode_codeactive/intp/marketcode/codeactive
Check the QR code activation status interfaceintp_marketcode_codeactivequery/intp/marketcode/codeactivequery
CODE_TICKET for CODE interfaceintp_marketcode_tickettocode/intp/marketcode/tickettocode
Request QR code interfaceintp_marketcode_applycode/intp/marketcode/applycode

# VI. Decryption instructions for QR code packets

The real name data is encrypted using AES CBC mode, iv using adding and decoding key, padding using PKCS7Padding, and finally using base64 encoding.

Decryption is performed by base64 decoding, and then decrypted using the key and AES / CBC / PKCS7Padding. The key is provided to the applicant when applying for real name interface rights.

# VII. FAQS

# 1. Permissions open

# Q: Where is the one thing one yard entrance?

A: You can enter the application page from the notification channels such as the letter inside the station, or add functions from the Official Account menu, add a function plug-in for one thing, one code, and click on the application to enter the application page.

# Q: Do you charge for one yard?

A: WeChat provides one-thing one-code and Weixin Mini Program related product capabilities, open to brands and service providers to access, without charge.

# 2. Send a code

# Q: WeChat What is the code?What's different from regular QR codes?

A: WeChat Tencent patent microcode issued through the "one thing one code" interface.Micro-code belongs to the QR-code, which uses WeChat's proprietary coding rules, and is different from any ordinary QR-code. The effects are:

Microcodes can only be generated by WeChat and cannot be counterfeited by any organization or individual, fundamentally improving the security of code making.At the same time, it can only be read and landed Weixin Mini Program through WeChat scanning code, which is difficult to obtain benefits by means of large-scale simulation scanning code.

The microcode consists of a dot array of 19*19 and can still maintain a good scan speed at a small print area (0.5mm*0.5mm).

# Q: How to send code through WeChat?

A: WeChat is an open API. After the merchant opens the one-item-one-code feature, it can call the Official Account interface on its own or through a third party service provider to obtain the code packet, and flexibly define the code and Weixin Mini Program jumping relationship.

# 3. Encryption

# Q: What is the format of the code package obtained through the WeChat interface and how to print it?

A: According to the number of requests, the code package is the number of requests / 1w files compressed, a single code format example:

1111111111111111111100000110101100000110111010000010111011011101011101011101101110100100101110110000011011110000011111111110111111111110001100000110001100101110111100010010100000011110100010100101110010101010111000110100100010101111111100101001100100000111001111101010111010101110111111011101000110101110101110101011100100110000011011001111111111111100101000101 0436Z31$0 0 P.URL.CN/0V/IXO*FWWYLZLXUXGR

The first 361 of these are arrays of 19 times 19, with 1 representing black and 0 representing white, forming a microcode array. The second parameter is the parameter that the code represents, the third parameter is the relative location number of the QR code, and the last string of characters is the normal QR code character.

When printing, you can print a dot array directly or switch to bitmap printing. If you encounter printing problems, you can contact wxsaoyisao@tencent.com Print under the direction of staff.

# Q: WeChat How about error correction and redundancy?Is the code verification mechanism perfect? If parts of the print are missing, broken, stained, etc., can it be read correctly?

A: In the 19\ * 19 = 361-bit dot matrix of miniature code, 60% is used for redundancy and error correction (the most high-end H file of ordinary code system is 30% fault tolerance).At the current level of printing technology, the probability of substandard products is extremely low, and there will be no misprint.

# Q: How does the hardware equipment of the product production line and circulation line collect the code information in the code part?

A: Microcode information can only be read by the WeChat scanning engine.If in production and circulation, there is a demand to use hardware equipment to scan codes, printing suppliers or hardware equipment suppliers need to apply through the brand to obtain the WeChat Qbar engine open and upgrade the decoding library, and WeChat technicians will cooperate with the proposal to evaluate and implement.

Note: Some device manufacturers currently support hardware reading of microcode, please contact wxsaoyisao@tencent.com ..

# Q: The current printing and acquisition equipment does not support upgrading to micro-code, how to access WeChat one thing one code?

A: The micro code is an important upgrade to the ordinary two-dimensional code, whether from the security or the experience of the consumer scanning code. If the current printer and acquisition equipment can not support the micro-code, the fourth character string can be directly re-printed, compatible with most of the current printer and acquisition equipment.

Example of a common QR code single code format:

P.URL.CN/0C12345678901234ABC

Total length of 28 characters, support to version 2, error correction level Q binary code.

Ordinary two-dimensional codes are consistent with microcodes in terms of Weixin Mini Program capability and numerical analysis.

# 4. Landing Weixin Mini Program

# Q: WeChat Do you provide ground Weixin Mini Program development?

A: WeChat does not provide landing Weixin Mini Program development, developed by the brand itself or commissioned by third-party service providers.You can evaluate and select suitable service providers through a one-size-fits-all service provider market case briefing.

# Q: How is the jump relationship between code and Weixin Mini Program defined? Can the same batch of codes jump to different Mini Programs?

A: The jump relationship between the code and Weixin Mini Program is defined when you call the code to activate the interface, and you can flexibly define the jump Mini Programs and the pages under the Mini Programs depending on the different sections of the code under a batch. The same batch of code with the same block number can repeatedly activate the jump relationship. Therefore, the issue phase does not need to determine the correspondence between the code and the Mini Program, which can be defined flexibly.

# Q: What are the Weixin Mini Program capabilities in the one-thing one-code scenario?

A: One thing one code scene special empowerment is Weixin Mini Program red envelope and scan code attention Official Account. One of the mini program red envelopes is about to open, scan the code to follow the Official Account message template has been opened.In addition, depending on different scanning requirements, the Mini Program has a combination of capabilities, has a better user experience and return channels than H5, and is the first step for brands to connect to the WeChat ecosystem.

# 5. User scans for codes

# Q: What is the experience of spenders scanning code?

A: Whether it is a micro code or a normal two-dimensional code, the consumer can only scan the code through WeChat.When scanning through other applications, the tiny code will be difficult to read; The normal QR code will pass the browser to the URL and return an error message.

# 6. Continued Operations

# Q: How do I view scanning data and user analysis?

A: After the encoded goods are placed on the market and the barcode data is generated, you can log in to the WeChat public platform and view detailed barcode data and user analysis under the One-item, One-barcode feature menu.

# Q: What are the viewable data dimensions?What is the difference between Weixin Mini Program Data Kanban?

A: The scanning data includes the scanning time, location, frequency distribution of goods, activities, and cross-scanning of goods. User analysis includes user age, gender, geography, terminal, model distribution, brand reach, and repurchase of different products.

Weixin Mini Program Data is access data and user analysis for a single Mini Program, including multiple traffic sources.One-item, one-code data is the comprehensive data reflected by the scanning code itself, reflecting the distribution of the scanning codes under the same body, and multiple Mini Programs can carry out different services, while supporting the selection of activities, brands, and goods.

# Q: How is the scanning data used? Can you connect with your own CRM?

A: Can combine brand own CRM comprehensive analysis.It should be pointed out that the numerical analysis provided by WeChat is group image data, does not contain information about a single consumer, and cannot achieve individual dimensional correspondence.

Scanning data is objective feedback of consumer consumption behavior, and on the basis of obtaining accurate scanting data, it can be analyzed and re-reached using message channels within the WeChat ecosystem, such as Official Account graphic messages.

In addition, scan code users can be used as core users to achieve accurate touch of commercial traffic and improve advertising performance.