Product Documentation General instructions Access Guidelines FAQs

Uploading Image

Update Time：2025.02.20

Merchants or institutions call this API to upload the certificate images in jpeg, jpg, bmp, png format. The API should be called through POST form, with enctype set as multipart/form-data.

API intro

Request Url: https://apihk.mch.weixin.qq.com/secapi/mch/uploadmedia

Request method:POST

Certificate Requirements：Yes Certificate is required.

Parameter Settings

Name	Variable Name	Type	Required	Description
Merchant ID	mch_id	string[1,32]	Yes	Merchant ID assigned by WeChat Pay Example：1000000000
Media File	media	string[1,256]	Yes	fThe media file content in form-data, including filename, filelength, content-type, etc. This field will not be used to generate the signature Example：test.jpg
Hash value of media file content	media_hash	string[1,32]	Yes	The MD5 value of media content Example：hjkahkjsjkfsjk78687dhjahdajhk
Signature	sign	string[1,32]	Yes	Signature, please refer to Security Specifications for the detailed signature algorithm Example：D675A1E471DBF7C0B1AC5883B5BDA9EF
Sign type	sign_type	string[1,10]	No	MD5 as default Example：HMAC-SHA256

Example

1curl --cert ./apiclient_cert.pem --key ./apiclient_key.pem -F 'mch_id=1000000000' -F 'media_hash=709d1e858d2ef9d0501cc053668b2872' -F 'sign=D675A1E471DBF7C0B1AC5883B5BDA9EF' -F 'media=@test.jpg' https://api.mch.weixin.qq.com/secapi/mch/uploadmedia

Return Data

Name	Variable Name	Type	Required	Description
Return Status Code	return_code	string[1,16]	Yes	SUCCESS/FAIL Specifies communicating label instead of transaction label. The status of the transaction is determined by the value of the result_code field. Example：SUCCESS
Return Data	return_msg	string[1,128]	No	If not empty, the returned info is the error description. Signature failure Parameter format checking error Example：Signature failure

If return_code is SUCCESS, return data will also include the following fields:

Name	Variable Name	Type	Required	Description
Service Result	result_code	string[1,32]	Yes	SUCCESS/FAIL Example：FAIL
Media ID	media_id	string[1,256]	Yes	The media file content ID returned by WeChat Pay Example：9UYfXi- WMUhgWXvJtEw4_gBl e_EfrD_pIL0bS8GAsK8
Signature	sign	string[1,32]	Yes	Specifies a signature. Example：pIL0bS8GAsKpIL0bS8GAsKpIL0bS8GAs
Error Code	err_code	string[1,32]	No	Error code Example：INVALID_REQUEST
Error Code Description	err_code_de s	string[1,128]	No	Detailed description of error code Example：Sub merchant information error, please check and retry

Example

1<xml> 
2<return_code><![CDATA[SUCCESS]]></return_code> 
3<return_msg><![CDATA[OK]]></return_msg> 
4<result_code><![CDATA[SUCCESS]]></result_code> 
5<media_id><![CDATA[9UYfXi- WMUhgWXvJtEw4_gBle_EfrD_pIL0bS8GAsK8]]></media_id>
6<sign><![CDATA[D675A1E471DBF7C0B1AC5883B5BDA9EF]]></sign> 
7</xml>

Error Code

Error Code	Description	Reason	Solution
INVALID_REQUEST	HTTP GET method not supported	Use POST method. Check and call again.	Debugging by developer
INVALID_REQUEST	Invalid XML format	Invalid XML format. Check and call again.	Invalid XML format. Check and call again.
SIGNERROR	Signature validation	Signature validation failed. Check and try again.	Signature validation failed. Check and try again.
INVALID_REQUEST	Certificate is required	Getting certificate serial number is failed. Certificate verification is failed.	Check the certificate
PARAM_ERROR	Regular Validation	XXX has invalid format. Check and try again.	Automated checks and filters
PARAM_ERROR	Image format error	The image format is wrong, please check and retry. The image size should be less than 2M. Image Hash value error, please check and retry.	Please check the image
PARAM_ERROR	Merchant ID error	The merchant ID is wrong, please check	Please check the merchant ID
INVALID_REQUEST	Entry permissions	No permissions. Check and try again.	Check permissions
FREQUENCY_LIMITED	Frequency limit	Operation is too fast, please retry later	Please reduce the API call frequency
SYSTEMERROR	System error occurred when viewing a sub-vendor	System error occurred when viewing a sub-vendor. Try again later.	Contact WeChat Pay Support