机构appid

app_id

string(32)

是

机构在微信公众平台申请服务号对应的APPID
示例值：wx8888888888888888

机构商户号

mch_id

string(32)

是

微信支付分配的机构商户号
示例值：3200000001

子商户号

sub_mch_id

string(32)

是

子商户号
示例值：20000100

签名

sign

string(32)

是

参数签名，详见签名方法
示例值：C380BEC2BFD727A4B6845133519F3AD6

返回状态码

return_code

string(16)

是

SUCCESS/FAIL
此字段是通信标识，非交易标识，交易是否成功需要查看result_code来判断
示例值：SUCCESS

返回信息

return_msg

string(128)

否

返回信息，如非空，为错误原因
签名失败
参数格式校验错误
示例值：签名失败

业务返回码

result_code

string(16)

是

业务结果 SUCCESS/FAIL
示例值：SUCCESS

错误编码

err_code

string(32)

否

详细参见错误列表
示例值：SYSTEMERROR

错误描述

err_code_des

string(128)

否

错误信息描述
示例值：系统错误

签名

sign

string(32)

是

签名信息
示例值：C380BEC2BFD727A4B6845133519F3AD6

子商户号

sub_mch_id

string(32)

是

微信支付系统生成的子商户号
示例值：1234567

子商户名称

merchant_name

string(128)

是

子商户公司注册的名称
示例值：7-11

子商户简称

merchant_shortname

string(64)

是

子商户简称，用于微信订单详情和支付成功页展示
示例值：Merchant shortname

注册国家或区域

merchant_country_code

string(3)

否

公司所注册的国家或区域，详见国家/地区代码
示例值：344

业务类目

business_category

string(10)

是

业务类目，详见业务类目列表
示例值：101

MCC

mcc

string(4)

否

Mcc码，请参考商户行业编码
示例值：075586010000

公司联系电话

office_phone

string(32)

是

商户联系方式，用户支付完成后展示给用户的商家联系方式
示例值：075586010000

联系人姓名

contact_name

string(64)

否

联系人姓名
示例值：张三

联系人手机

contact_phone

string(32)

否

联系人手机
示例值：1800000000

联系人邮箱

contact_email

string(256)

否

联系人邮箱
示例值：test@test.com

子商户唯一标识

merchant_remark

string(20)

是

机构为商户备注的信息，可以是商户在机构系统的商户编号
示例值：ABC1234567

业务类型

business_type

string(7)

否

取值为三种业务类型：ONLINE, OFFLINE 或BOTH
示例值：BOTH

商户类型

merchant_type

string(10)

否

取值ENTERPRISE或INDIVIDUAL
示例值：ENTERPRISE

公司注册文件编号

registration_certificate_number

string(50)

否

公司注册文件编号，当商户类型取值为ENTERPRISE时必填
示例值：5555-8888

公司注册文件过期时间

registration_certificate_date

string(10)

否

公司注册文件过期时间。取值为过期的日期或取值为“PERMANENT” , “N/A”, 若取值为日期，格式为YYYY-MM-DD，比如：2020-10-16。当商户类型为ENTERPRISE时必填。
示例值：2020-10-16

APP下载链接

app_download

string(128)

否

商户APP的下载地址
示例值：https://download.qq.com

业务网站

business_website

string(128)

否

商户的业务网站地址
示例值：https://www.qq.com

公众号

office_account

string(128)

否

商户的公众号appid
示例值：wx8888888888888888

小程序

mini_program

string(128)

否

商户的小程序appid
示例值：wx8888888888888888

门店地址

store_address

string(128)

否

商户的门店地址
示例值：10F World Finance Centre (South Office), 11 Canton Road, Tsim Sha Tsui, Hong Kong

董事姓名

director_name

string(128)

否

董事姓名
示例值：Bob Zhang

董事证件编号

director_id_number

string(128)

否

董事证件编号
示例值：5555-8888

负责人姓名

principal_name

string(128)

否

负责人姓名
示例值：Bob Zhang

负责人证件编号

principal_id_number

string(128)

否

负责人证件编号
示例值：5555-8888

子商户结算银行账户

settlement_bank_number

string(128)

否

子商户结算银行账户信息
示例值：555588889999

渠道编号

channel_id

string(20)

否

机构合作渠道的编号，通过商户平台创建
示例值：101

H5支付权限状态

h5_authorization_state

string(32)

否

描述子商户的H5支付权限状态：
APPROVED：已有H5权限；
UNAUTHORIZED：未获得H5权限，也未申请过H5权限；
UNDER_REVIEW：H5权限申请当前在审核中；
REJECTED：H5权限申请被驳回，请于h5_audit_reject_detail字段查看驳回原因；
UNDER_PUNISHMENT：曾经申请并获得H5权限，但当前权限被处罚，请联系BD处理；
APPLICATION_FAILED：H5权限申请单创建失败，请于h5_audit_reject_detail字段查看失败原因
示例值：APPROVED

H5驳回详情

h5_audit_reject_detail

string(1024)

否

H5支付权限状态为REJECTED或APPLICATION_FAILED时返回；申请单被驳回的原因或申请失败原因。
示例值：商户证书无效

子商户状态

sub_mch_status

string(32)

是

子商户状态，表示当前该子商户在微信支付系统内的状态：
OPERATING：正常；子商户权限正常，可发起交易；
PENDING：待处理；子商户资料未通过日常审核，需要机构登录微信支付商户平台查看和处理。子商户权限正常，可发起交易；
DEACTIVATED：已停用；该子商户被机构自主停用，无支付权限，不能发起交易；
CLOSED：已关闭；该子商户被微信支付关闭支付权限，不能发起交易；
INCOMPLETE_APPLICATION：未完成入驻；子商户入驻申请未完成，无支付权限，不能发起交易。请于application_status字段查看入驻申请状态
示例值：OPERATING

子商户入驻状态

application_status

string(32)

否

子商户状态为
INCOMPLETE_APPLICATION时返回；子商户入驻申请状态：
UNDER_REVIEW：审核中；微信支付正在审核该子商户的入驻申请，请耐心等待；建议每隔一天查询一次子商户状态，直至子商户流转到其他状态；
REJECTED：已驳回；该子商户的入驻申请被微信支付驳回，请于application_rejected_detail字段查看驳回原因
示例值：UNDER_REVIEW

子商户入驻驳回详情

application_reject_detail

string(4096)

否

子商户入驻状态为REJECTED时返回；入驻申请被微信支付的审核人员驳回的原因，以json array形式展示每个被驳回的字段(field)及驳回原因(reason)
如申请被驳回，请登录微信支付商户平台，按要求修改申请信息后重新提交（暂不支持API）
示例值：[{"field":"contact_name","reason":"contact name is invalid."},{"field":"contact_phone","reason":"contact phone is invalid."}]

INVALID_REQUEST

请求错误

请使用HTTP POST 方式，检查后重新尝试。

请开发人员请求数据

INVALID_REQUEST

请求异常

XML格式异常，请检查格式，重新尝试

SIGNERROR

签名错误

签名校验失败，请检查签名数据，重新尝试。

INVALID_REQUEST

请求错误

请使用字符集UTF-8.

PARAM_ERROR

参数错误

参数错误，请检查重新尝试。
例如：参数超过限定长度。

请检查参数

PARAM_ERROR

参数错误

参数错误，请检查重新尝试。
例如：参数格式错误。

INVALID_REQUEST

请求错误

没有进件子商户的权限。

请检查权限

INVALID_REQUEST

请求错误

检索客户端证书序列号失败&\160；
来自客户端证书的可分辨名称（DN）字段失败&\160；
证书验证失败。
没有携带证书。请检查后重新尝试。

请检查证书

INVALID_REQUEST

请求错误

商户信息校验时发生系统错误。
输入字段包含不适当的术语。检查并再次输入。
输入字段包含不符合服务规则的不适当术语。检查并再次输入。
由于违规，权限被限制。有关详细信息，请联系客户服务。

请检查输入信息或联系微信支付

SYSTEMERROR

系统错误

系统错误

请联系微信支付技术支持