Use Case
Update Time：2025.02.18About this Document
This document is the official manual for WeChat’s payment APIs. As such, it is the tutorial for technical architects, R&D engineers, testing engineers and service engineers for the integrated WeChat payment system, which includes merchants' systems such as online shopping platforms, cashier systems, or automatic smart POS systems. The following topics are designed to be read in order and there are references to topics "previously seen" and topics "yet to come". These references are linked accordingly and it should generally not be a problem to read ahead on other topics.
Payment Method
1. Quick Pay
The Payer shows their bar code or QR Code on WeChat's Quick Pay page to the Merchant to scan in order to pay directly. This mode applies to offline payment scenarios.
2. QR Code Payment
The Merchant generates a transaction QR Code according to the WeChat Payment Protocol and the Payer goes to "Scan QR Code" in their WeChat in order to complete payment. This mode is applicable to payments made on websites, physical stores, media advertising, or other scenarios.
3. Official Account Payment
In-App Web-based Payment, also called Official Account Payment. The Payer opens the Merchant's HTML5 pages on their WeChat and calls the WeChat payment module via the JSAPI interface to pay their transaction. This mode is applicable in the following scenarios:
a. The Payer enters the Merchant’s official account and completes their payment on the transaction page;
b. The Payer’s friend shares the Merchant's payment URL in a chat or in Moments and the payer clicks the link to complete their payment;
c. The Payer scans the payment QR Code displayed within the Merchant’s page and opens it in a browser to complete their payment.
4. In-App Payment
In-App payment also refers to a mobile-based payment in which the Merchant calls the WeChat payment module by using the open SDK integrated in their mobile-based app to pay for transactions.
5. H5 Payment
H5 payment is to integrate WeChat payment in the third party browser outside of WeChat client. It will call the WeChat client to complete payment once the vendor requests the H5 payment service.
Note: Before starting development, please contact WeChat staff to configure H5 payment directory.
