接口类型

service

是

String(32)

接口类型：pay.weixin.jspay

版本号

version

否

String(8)

版本号，version默认值是2.0

字符集

charset

否

String(8)

可选值 UTF-8 ，默认为 UTF-8

签名方式

sign_type

否

String(8)

签名类型，取值范围：

MD5（默认）；

SM3；

商户号

mch_id

是

String(15)

商户号，由平台分配

原生JS

is_raw

是

String(1)

值为1

是否小程序支付

is_minipg

否

String(1)

值为1，表示小程序支付；不传或值不为1，表示公众账号内支付

商户订单号

out_trade_no

是

String(32)

商户系统内部的订单号 ,32个字符内、 可包含字母,确保在商户系统唯一

设备号

device_info

否

String(32)

终端设备号

收银员

op_user_id

否

String(32)

操作员帐号,默认为商户号

门店编号

op_shop_id

否

String(32)

商品描述

body

是

String(127)

商品描述

用户openid

sub_openid

是

String(128)

微信用户关注商家公众号的openid（注：使用测试号时此参数置空，即不要传这个参数，使用正式商户号时才传入，参数名是sub_openid，具体请看文档最后注意事项第7点）

公众账号或小程序ID

sub_appid

是

String(32)

当发起公众号支付时，值是微信公众平台基本配置中的AppID(应用ID)；当发起小程序支付时，值是对应小程序的AppID

附加信息

attach

否

String(127)

商户附加信息，可做扩展参数

总金额

total_fee

是

Int

总金额，以分为单位，不允许包含任何字、符号

电子发票

need_receipt

否

boolean

需要和微信公众平台的发票功能联合，传入true时，微信支付成功消息和支付详情页将出现开票入口[新增need_receipt【适用于微信】]

终端IP

mch_create_ip

是

String(16)

订单生成的机器 IP

通知地址

notify_url

是

String(255)

接收平台通知的URL，需给绝对路径，255字符内格式如:http://wap.tenpay.com/tenpay.asp，确保平台能通过互联网访问该地址

订单生成时间

time_start

否

String(14)

订单生成时间，格式为yyyyMMddHHmmss，如2009年12月25日9点10分10秒表示为20091225091010。时区为GMT+8 beijing。该时间取自商户服务器。注：订单生成时间与超时时间需要同时传入才会生效。

订单超时时间

time_expire

否

String(14)

订单失效时间，格式为yyyyMMddHHmmss，如2009年12月27日9点10分10秒表示为20091227091010。时区为GMT+8 beijing。该时间取自商户服务器。注：订单生成时间与超时时间需要同时传入才会生效。

商品标记

goods_tag

否

String(32)

商品标记，微信平台配置的商品标记，用于优惠券或者满减使用

终端信息

terminal_info

否

String

商户侧受理终端信息，字段详

细说明参考统一被扫其他扩展字段说明。

随机字符串

nonce_str

是

String(32)

随机字符串，不长于 32 位

是否限制信用卡

limit_credit_pay

否

String(32)

限定用户使用时能否使用信用卡，值为1，禁用信用卡；值为0或者不传此参数则不禁用

签名

sign

是

String(32)

MD5签名结果，详见“安全规范”

授权交易机构

sign_agentno

否

String(12)

授权交易的服务商机构代码，商户授权给服务商交易的情况下必填，签名使用服务商的密钥

连锁商户号

groupno

否

String(15)

连锁商户为其下门店发交易的情况必填，签名使用连锁商户的密钥

公众账号ID

appid

否

String(32)

服务商公众号APPID

版本号

version

是

String(8)

版本号，version默认值是2.0。

授权交易机构

sign_agentno

否

String(12)

授权交易的服务商机构代码，商户授权给服务商交易的情况下必填，签名使用服务商的密钥

连锁商户号

groupno

否

String(15)

连锁商户为其下门店发交易的情况必填，签名使用连锁商户的密钥

字符集

charset

是

String(8)

可选值 UTF-8 ，默认为 UTF-8。

签名方式

sign_type

否

String(8)

签名类型，取值范围：

MD5（默认）；

SM3；

返回状态码

status

是

String(16)

0表示成功，非0表示失败此字段是通信标识，非交易标识，交易是否成功需要查看 result_code 来判断

返回信息

message

否

String(128)

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

返回信息

message

否

String(128)

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

以下字段在 status 为 0的时候有返回

业务结果

result_code

是

String(16)

0表示成功，非0表示失败

商户号

mch_id

是

String(15)

商户号，由平台分配

设备号

device_info

否

String(32)

终端设备号

随机字符串

nonce_str

是

String(32)

随机字符串，不长于 32 位

错误代码

err_code

否

String(32)

参考错误码

错误代码描述

err_msg

否

String (128)

结果信息描述

签名

sign

是

String(32)

MD5签名结果，详见“安全规范”

以下字段在 status 和 result_code 都为 0的时候有返回

动态口令

token_id

是

String(64)

授权口令

原生态js支付信息或小程序支付信息

pay_info

是

String

原生态js支付：is_raw为1时返回，json格式的字符串，作用于原生态js支付时的参数
  小程序支付：is_minipg为1时返回，json格式的字符串，作用于小程序支付时的参数