微信支付开发文档

接口版本号

version

是

String(32)

1.0

默认值1.0

商户号

mch_id

是

String(32)

1230000109

服务商的商户号

随机字符串

nonce_str

是

String(32)

ibuaiVcKdpRxkhJA

参考签名规则

签名类型

sign_type

是

String(128)

HMAC-SHA256

签名类型，仅支持HMAC-SHA256

签名

sign

是

String(64)

D675A1E471DBF7C0B1AC5883B5BDA9EF

参考签名规则

平台证书序列号

cert_sn

是

String(64)

5663476TEREGD45FH63GDFHFG657FCHBFG

用于对敏感信息进行加密的平台证书序列号，获取方法详见平台证书及序列号获取接口（接口返回参数"serial_no"即为平台证书序列号）

小微商户号

sub_mch_id

是

String(32)

1230000109

小微商户的商户号（小微申请状态需为待签约或完成）

主体类型

organization_type

是

String(32)

     2

2-企业
4-个体工商户
1708-其他组织

营业执照扫描件

 business_license_copy

是

String(256)

1. 请填写通过图片上传接口预先上传图片生成好的MediaID
2. 仅能上传1张图片

营业执照注册号

business_license_number

是

String(32)

123456789012345

1. 请填写营业执照上的营业执照注册号
2. 若主体类型为个体工商户或企业，注册号格式须为15位数字或 18位数字|大写字母

商户名称

merchant_name

是

String(110)

深圳腾讯科技有限公司

1. 请填写营业执照上的商户名称
2. 2~110个字符，支持括号
3. 个体工商户不能以“公司”结尾

注册地址

company_address

是

String(256)

深圳市腾讯
    大厦

256个字以内

经营者姓名/法定代表人

legal_person

是

String(256)

1. 请填写营业执照上的经营者/法人姓名
2. 必须与小微商户联系人相同
3. 该字段需进行加密处理，加密方法详见敏感信息加密说明。

营业期限

business_time

是

String(50)

["1970-01-01","长期"]

1. 请填写营业执照上的营业期限
2. 注意参照示例中的格式
3. 结束时间需大于开始时间
4. 有效期必须大于60天

营业执照类型

business_licence_type

是

String(32)

1762

1. 1762-已三证合一    1763-未三证合一
2. 若营业执照上的营业执照注册号为18位统一社会信用代码，请选择“已三证合一”，否则请选择“未三证合一”
3. 注意：参数为business_licence_type，这里为licence，非license

组织机构代码证照片

organization_copy

否

String(256)

1. 请填写通过图片上传接口预先上传图片生成好的MediaID
2. 仅能上传1张图片
3. 主体类型为企业其他组织 且 营业执照为未三证合一，必填

组织机构代码

organization_number

否

String(32)

1234567-1

1. 请填写组织机构代码证上的组织机构代码
2. 9或10位 数字|字母|连字符
3. 主体类型为企业其他组织 且 营业执照为未三证合一，必填

组织机构代码有效期限

organization_time

否

String(128)

["1970-01-01","长期"]

1. 请填写组织机构代码证上的组织机构代码有效期
2. 注意参照示例中的格式
3. 结束时间需大于开始时间
4. 有效期必须大于60天
5. 主体类型为企业其他组织 且 营业执照为未三证合一，必填

开户名称

account_name

否

String(50)

1. 请填写对公账户，开户名称必须与营业执照上的“商户名称”一致
2. 主体类型为企业其他组织时，必填
3. 该字段需进行加密处理，加密方法详见敏感信息加密说明

开户银行

account_bank

否

String(50)

工商银行

1. 详细参见开户银行对照表
2. 主体类型为企业其他组织时，必填

开户银行省市编码

bank_address_code

否

String(6)

11000

1. 至少精确到市,详细参见省市区编号对照表
2. 主体类型为企业其他组织时，必填

开户银行全称
（含支行）

bank_name

否

String(256)

深圳农村商业银行xxx支行

1. 17家直连银行无需填写，其他银行请务必填写
2. 需填写银行全称，如"深圳农村商业银行XXX支行"
3. 详细参见开户银行全称（含支行）对照表
4. 主体类型为企业其他组织 且 开户银行为非直连银行时，必填

银行卡号

account_number

否

String(50)

1. 数字，长度遵循系统支持的对公卡号长度要求
2. 主体类型为企业其他组织时，必填
3. 该字段需进行加密处理，加密方法详见敏感信息加密说明。

商户简称

merchant_shortname

是

String(50)

2~30个中文字符、英文字符、符号。将在支付完成页向买家展示，需与微信经营范围相关

费率结算规则ID

business

是

String(10)

详细参见费率结算规则对照表

特殊资质

qualifications

否

String(1280)

["xxx","xxx"]

1）视行业而定，详细参见费率结算规则对照表
2）注意示例中的格式
3）最多可上传5张照片，请填写通过图片上传接口预先上传图片生成好的MediaID

经营场景

business_scene

是

String(50) 

[1721]

1. 1721-线下
   

补充说明

business_addition_desc

否

String(512)

补充材料

business_addition_pics

否

String(1280)

["123","456"]

1. 最多可上传5张照片，请填写通过图片上传接口预先上传图片生成好的MediaID
2. 请使用JSON格式的数组

联系邮箱

contact_email

否

String(50)

123@qq.com