WeChat Pay

Payment Amount

For foreign transactions, the transaction amount will use the smallest unit of currency, but the reference value must be an integer without decimals. For example, using a currency type of "United States dollars" a reference value of "1750" in the payment amount would be equivalent to US$17.50.

Currency Type

The list of currency types is as below:

Notes: The currency type for payment and refund must be identical.

Time Protocol

China Standard Time (UTC+08) is used in this document. If the Merchant is not in this time zone, they should convert their current time into China Standard Time. For instance, if a merchant is in London at the local time of November 11, 2014 0:00, it will be November 11, 2014 8:00 AM in Beijing.

Timestamp

Taking China Standard Time (UTC+08) as the standard time zone, a timestamp is calculated as seconds since 1970/01/01 00:00:00 UTC and is the required method to store timestamps in this document.

Note: Milliseconds should be rounded to seconds (10-digits).

Merchant’s Order Number

The order number for a payment is defined by the merchant and must be unique. We suggest adding a random sequence to the end of the current time in order to create a unique and sequenced number. The original order number is used when initiating a payment again in order to avoid duplicate transactions. However, orders that are paid, closed or revoked cannot be paid again.

Requirements for field body

Some special standards are required for field “body” when calling the WeChat Payment APIs:

MCC code

To match the supervision requirement, merchants need to upload the MCC code when calling WeChat Pay APIs. The MCC code should be transferred through field “detail”, and please refer to the following MCC code list:

CountryCode

Business Category

Bank type