全部文档 / 【微信】公众号&小程序支付 / 初始化请求API
初始化请求API

业务功能

初始化JSAPI请求,通过生成pay_info来进行交互验证。

交互模式

请求:后台请求交互模式

返回结果+通知:后台请求交互模式+后台通知交互模式

请求参数列表

请求urlhttps://qra.95516.com/pay/gateway

POST XML 内容体进行请求

字段名

变量名

必填

类型

说明

接口类型

service

String(32)

接口类型:pay.weixin.jspay

版本号

version

String(8)

版本号,version默认值是2.0

字符集

charset

String(8)

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

签名方式

sign_type

String(8)

签名类型,取值:MD5默认:MD5

商户号

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,如2009122591010秒表示为20091225091010。时区为GMT+8 beijing。该时间取自商户服务器。注:订单生成时间与超时时间需要同时传入才会生效。

订单超时时间

time_expire

String(14)

订单失效时间,格式为yyyyMMddHHmmss,如2009122791010秒表示为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)

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

 

返回结果

数据按XML的格式实时返回

字段名

变量名

必填

类型

说明

公众账号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默认:MD5

返回状态码

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_raw1时返回,json格式的字符串,作用于原生态js支付时的参数
 
小程序支付:is_minipg1时返回,json格式的字符串,作用于小程序支付时的参数