中国银联开放平台

文档中心

接口列表

综合支付平台

银联人脸支付申请退款

支付宝服务窗统一下单

微信公众号&小程序初始化请求

微信APP原生态预下单

关闭订单

统一下单

授权码查询

退款查询

申请退款

撤销订单

查询订单

提交刷卡支付

获取token

综合支付平台

查看产品

更新时间：2022-02-17

微信公众号&小程序初始化请求

接口描述

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

请求方式

POST

生产调用地址

https://openapi.unionpay.com/upapi/unifiedTrade/jspay?token=[token]&sign=[sign]&ts=[ts]

测试调用地址

https://openapi.unionpay.com/upapi/unifiedTradeTest/jspay?token=[token]&sign=[sign]&ts=[ts]

URL请求参数

中文名称	英文名称	域类型	请求要求	备注
产品token	token	string	M-必填
签名信息	sign	string	M-必填	详细签名算法可参考附录“签名样例代码”部分或参考网站“技术指南”板块第3条。
时间戳	ts	long	M-必填	单位毫秒，对于Java一般使用System.currentTimeMillis()获取

请求报文体参数

中文名称	英文名称	域类型	域长度	默认值	请求要求	备注
原生JS	is_raw	string	1	1	M-必填	值为1，必填
是否小程序支付	is_minipg	string	1		O-选填	值为1，表示小程序支付；不传或值不为1，表示公众账号内支付，非必填
商户订单号	out_trade_no	string	32		M-必填	同一门店下唯一。商户系统内部订单号,32个字符内，可包含字母,确保在商户系统唯一，必填
设备号	device_info	string	32		O-选填	非必填
操作员	op_user_id	string	32	商户号	O-选填	操作员帐号，非必填
商品描述	body	string	127		M-必填	必填
附加信息	attach	string	127		O-选填	商品附加信息，可做扩展参数
总金额	total_fee	int			M-必填	总金额，以分为单位，不允许包含任何字、符号，必填
分账信息	split_info	string	1	N	O-选填	Y：分账，N：不分账非必填
用户openid	sub_openid	string	128		M-必填	微信用户关注商家公众号的openid（注：使用测试号时此参数置空，即不要传这个参数，使用正式商户号时才传入，参数名是sub_openid，必填
公众账号或小程序ID	sub_appid	string	32		M-必填	当发起公众号支付时，值是微信公众平台基本配置中的AppID(应用ID)；当发起小程序支付时，值是对应小程序的AppID，必填
终端IP	mch_create_ip	string	16		O-选填	订单生成的机器IP
电子发票	need_receipt	boolean			O-选填	需要和微信公众平台的发票功能联合，传入true时，微信支付成功消息和支付详情页将出现开票入口[新增need_receipt【适用于微信】]，非必填
通知地址	notify_url	string	255		M-必填	接收平台通知的URL，需给绝对路径，255字符内格式，确保平台能通过互联网访问该地址，必填
订单生成时间	time_start	string	14		O-选填	订单生成时间，格式为yyyyMMddHHmmss,如2009年12月25日9点10分10秒表示为20091225091010。时区为GMT+8beijing。该时间取自商户服务器。注：订单生成时间与超时时间需要同时传入才会生效，非必填
订单超时时间	time_expire	string	14		O-选填	订单超时时间，格式为yyyyMMddHHmmss,如2009年12月25日9点10分10秒表示为20091225091010。时区为GMT+8beijing。该时间取自商户服务器。注：订单生成时间与超时时间需要同时传入才会生效，非必填
商品标记	goods_tag	string	32		O-选填	商品标记，微信平台配置的商品标记，用于优惠券或者满减使用，非必填
限制信用卡	limit_credit_pay	string	1		O-选填	限定用户使用时能否使用信用卡，值为1，禁用信用卡，值为0或者不传此参数则不禁用，非必填
随机字符串	nonce_str	string	32		M-必填	随机字符串，不长于32位，必填
接口类型	service	string	32	pay.weixin.jspay	M-必填	必填
签名	sign	string	32		M-必填	MD5签名结果，详见【附录3.9：“安全规范”】，必填
版本号	version	string	8	2.0	O-选填	非必填
字符集	charset	string	8	UTF-8	O-选填	可选值UTF-8，默认值UTF-8，非必填
签名方式	sign_type	string	8	MD5	O-选填	签名类型，非必填
品牌号	brand_id	string	16		M-必填	由平台分配，必填
门店编号	op_shop_id	string	16		M-必填	必填
业务类型	buss_type	string	2	00	O-选填	非必填

同步应答参数

中文名称	英文名称	域类型	域长度	请求要求	备注
应答码	respCd	string	4	M-必填	应答码
应答消息	respMsg	string		M-必填	应答消息
应答报文	data	map		M-必填	应答报文

示例代码

请求样例报文
应答样例报文

{
"time_expire":"20091225191010",
   "nonce_str":"SF88d5c8986bd0deb6423c92c948",
   "time_start":"20191225091010",
   "sign":"F53145E553092CE52E4CAA4D2B49A91C",
   "op_shop_id":"sfstore1",
   "sub_appid":"122379987",
   "body":"测试商品",
   "notify_url":"http://wap.tenpay.com/tenpay.asp",
   "version":"2.0",
   "mch_create_ip":"172.21.8.135",
   "brand_id":"sfbrand1",
   "sub_openid":"11421112",
   "buss_type":"00",
   "out_trade_no":"UP6765935216888988a",
   "service":"pay.weixin.jspay",
   "total_fee":"1",
   "sign_type":"MD5",
   "is_raw":"1"
}

复制

提示信息

提示