JSAPI下单

支持微信公众号支付、微信小程序支付、支付宝JS支付等使用jsapi支付的场景。

请求接口

openplt/jx/pay/trans/jsapipay

公共参数

请求参数

参数	必填	类型	说明
payment	是	String(16)	支付方式. 支付方式
appId	否	String(32)	微信支付时必填，商户公众号或小程序的appid
openId	否	String(32)	微信支付时必填，商户公众号或小程序appid下获取的用户openid
userId	否	String(32)	支付宝支付时必填，支付宝的用户userid
amount	是	Number	支付金额，单位：元
outTradeNo	是	String(32)	业务订单号，业务方保证唯一
subject	是	String(127)	商品名或订单简要描述
clientIp	是	String(32)	客户端IP
timeStart	否	String(20)	订单生成时间，格式为：yyyy-MM-dd HH:mm:ss，不传默认为当前时间
timeExpire	否	String(20)	订单失效时间，格式为：yyyy-MM-dd HH:mm:ss，建议：最短失效时间间隔大于1分钟
currency	否	String(16)	货币类型，默认人民币：CNY
limitCredit	否	int	是否限制使用信用卡，1为限制，0或不传为不限制，默认为0
attach	否	String(127)	附加信息，会跟订单信息一起原样返回
goodsTag	否	String(32)	商品标记，优惠券或单品营销使用
goodsDetails	否	JsonArray	商品详情，Json数组结构，做单品优惠时传入。goodsDetails结构
isMiniapp	否	String(1)	是否来自小程序，app_id为小程序时传"Y"，默认为"N"（公众号jsapi支付）
notifyUrl	否	String(256)	支付回调地址URL，不带参数

content请求示例

:::: tabs ::: tab 微信公众号支付

{
  "payment": "WXPAY",
  "amount": "20.00",
  "out_trade_no": "20241212180000001",
  "subject": "云商品",
  "client_ip": "61.144.11.222",
  "notify_url": "http://p.abc.com/callback/20241212180000001/",
  "app_id": "wxf636efh567hg4356",
  "open_id": "o-MYE42l80oelYMDE34nYD456Xoy",
  "goods_tag": "item_water12"
}

::: ::: tab 微信小程序支付

{
  "payment": "WXPAY",
  "amount": "20.00",
  "out_trade_no": "20241212193056001",
  "subject": "小程序商品A",
  "client_ip": "61.144.11.222",
  "notify_url": "http://p.abc.com/callback/20241212193056001/",
  "app_id": "wxf636efh567hg4356",
  "open_id": "o-MYE42l80oelYMDE34nYD456Xoy",
  "is_miniapp": "Y"
}

::: ::: tab 支付宝JS支付

{
  "payment": "ALIPAY",
  "amount": "20.00",
  "out_trade_no": "20241212194089001",
  "subject": "ZFB商品B",
  "client_ip": "61.144.11.222",
  "notify_url": "http://p.abc.com/callback/20241212194089001/",
  "user_id": "InfaYerGz4iC0rnrtOXeiUAr"
}

::: ::::

响应参数

名称	必填	类型	说明
payNo	是	String	聚合支付订单号，'600'开头
payment	是	String	支付方式，WXPAY为微信，ALIPAY为支付宝，UNIONPAY为银联云闪付
amount	是	Number	支付金额，单位：元
status	是	int	支付状态。参见支付状态值枚举
payTime	否	String	支付时间，格式"yyyy-MM-dd HH:mm:ss"
wxJsInfo	否	Json	payment为微信时返回的支付信息，可原封不动返回前端唤起支付控件
aliJsInfo	否	Json	payment为支付宝时返回的支付信息，可原封不动返回前端唤起支付控件

js_info支付信息说明

当支付方式为WXPAY时，返回wx_js_info：

名称	必填	类型	说明
appId	是	String	发起微信支付的AppId
timestamp	是	String	时间戳
nonceStr	是	String	随机字符串
package	是	String	"prepay_id=xxxx"
signType	是	String	签名类型
paySign	是	String	支付签名
prepayId	否	String	用于package，非必传

当支付方式为ALIPAY时，返回ali_js_info：

名称	类型	说明
tradeNo	String	唤起支付宝钱包的交易号

当支付方式为UNIONPAY时，暂无返回

result返回值示例

列举各场景下的必传参数，可作参考。

:::: tabs ::: tab payment为WXPAY

{
  "pay_no": "60086150032145781",
  "payment": "WXPAY",
  "amount": "20.00",
  "status": 101,
  "pay_time": "2024-12-12 18:00:02",
  "wx_js_info": {
    "app_id": "wxf636efh567hg4356",
    "timestamp": "1733997603",
    "nonce_str": "p2zioujhlwe823sz",
    "package": "prepay_id=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
    "sign_type": "MD5",
    "pay_sign": "892015b7ce6746cf9f2ea26acaff68f9"
  }
}

::: ::: tab payment为ALIPAY

{
  "pay_no": "60086150032145781",
  "payment": "ALIPAY",
  "amount": "20.00",
  "status": 101,
  "pay_time": "2024-12-12 18:00:02",
  "ali_js_info": {
    "trade_no": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
  }
}

::: ::::

JSAPI下单

请求接口​

公共参数​

请求参数​

content请求示例​

响应参数​

js_info支付信息说明​

result返回值示例​