统一支付接口(通道说明) ¶

提示

不同的支付通道在进行支付时会有一些差异，此处列出了支付通道使用时的一些差异和特殊点。

微信支付 ¶

特殊说明 ¶

微信直连商户无法限制使用支付方式

通道支付参数 ¶

参数	名称	类型	描述
openIdType	OpenId类型	String	服务商模式下分为用户服务标识 sp 用户子标识 sub，默认为用户服务标识，直连商户不需要传输

PayBody数据说明 ¶

支付方式	描述	实例
扫码支付	返回的是一个URL链接, 可以直接进行支付
wap支付	返回的是一个URL链接, 可以直接进行支付
Jsapi	返回的是个Map结构的Json字符串, 需要根据参数调起支付
App	返回的是个Map结构的Json字符串, 需要根据参数调起支付

Jsapi返回结构 ¶

字段	名称	备注
appid	应用id	微信开放平台审核通过的移动应用AppID 。
timeStamp	时间戳	时间戳，标准北京时间，时区为东八区, 自1970年1月1日 0点0分0秒以来的秒数
nonceStr	随机字符串
package	预支付ID拼接值	JSAPI下单接口返回的prepay_id参数值进行拼接, 格式如：prepay_id=***
signType	签名类型	默认为RSA
paySign	签名	使用字段AppID、timeStamp、nonceStr、package计算得出的签名值

小程序返回结构 ¶

字段	名称	备注
appid	应用id	微信开放平台审核通过的移动应用AppID 。
partnerid	商户号mchid	请填写商户号mchid对应的值。
prepayid	交易会话ID	微信返回的支付交易会话ID，该值有效期为2小时
package	package	暂填写固定值Sign=WXPay
nonceStr	随机字符串
timeStamp	时间戳	时间戳，标准北京时间，时区为东八区, 自1970年1月1日 0点0分0秒以来的秒数
sign	签名	使用字段AppID、timeStamp、nonceStr、prepayid计算得出的签名值注意：取值RSA格式

支付宝 ¶

特殊说明 ¶

微信直连商户无法限制使用支付方式

通道支付参数 ¶

参数	名称	类型	描述
opAppId	小程序应用ID	String	商户实际经营主体的小程序应用的appid，也即最终唤起收银台支付所在的小程序的应用id, 商户需要先在产品管理中心绑定该小程序appid，否则下单会失败
buyerId	买家支付宝用户ID	String	新商户建议使用buyer_open_id替代该字段。对于新商户，buyer_id字段未来计划逐步回收，存量商户可继续使用

PayBody数据说明 ¶

支付方式	描述	实例
电脑/扫码支付/wap支付	返回的是一个URL链接, 可以直接进行支付
App	返回的是一个签名字符串, 通过签名字符串调起支付
Jsapi	返回的是支付宝交易号, 使用支付宝交易号调起支付
App支付	返回签名字符串，见下方说明

App支付 ¶

返回的是一个签名字符串: app_id=2017060101317939&biz_content=%7B%22time_expire%22%3A%222016-12-31+10%3A05%3A00%22%2C%22extend_params%22%3A%22%22%2C%22query_options%22%3A%22%5B%5C%22hyb_amount%5C%22%2C%5C%22enterprise_pay_info%5C%22%5D%22%2C%22subject%22%3A%22%E5%A4%A7%E4%B9%90%E9%80%8F%22%2C%22product_code%22%3A%22QUICK_MSECURITY_PAY%22%2C%22body%22%3A%22Iphone6+16G%22%2C%22passback_params%22%3A%22merchantBizType%253d3C%2526merchantBizNo%253d2016010101111%22%2C%22specified_channel%22%3A%22pcredit%22%2C%22goods_detail%22%3A%22%22%2C%22merchant_order_no%22%3A%2220161008001%22%2C%22enable_pay_channels%22%3A%22pcredit%2CmoneyFund%2CdebitCardExpress%22%2C%22out_trade_no%22%3A%2270501111111S001111119%22%2C%22ext_user_info%22%3A%22%22%2C%22total_amount%22%3A%229.00%22%2C%22timeout_express%22%3A%2290m%22%2C%22disable_pay_channels%22%3A%22pcredit%2CmoneyFund%2CdebitCardExpress%22%2C%22agreement_sign_params%22%3A%22%22%7D&charset=UTF-8&format=json&method=alipay.trade.app.pay&sign=ERITJKEIJKJHKKKKKKKHJEREEEEEEEEEEE&sign_type=RSA2&timestamp=2014-07-24+03%3A07%3A50&version=1.0

参考支付宝APP接入文档进行调起支付

Jsapi支付 ¶

返回的是支付宝交易号trade_no，然后根据据官方说明拉起支付：支付宝拉起控件

云闪付 ¶

特殊说明 ¶

通道支付参数 ¶

PayBody数据说明 ¶

乐刷 ¶

特殊说明 ¶

可以使用限制使用支付方式

支付方式 ¶

乐刷通道提供简易支付和付款码支付可以对应到系统中的扫码支付和付款码支付，其他的都属于其他支付类型，见下方列表

编码	支付方式
wx_miniapp	微信小程序
wx_jsapi	微信jsapi
alipay_native	支付宝Native
alipay_JSAPI	支付宝小程序
alipay_JSAPI	支付宝JSAPI
union_native	云闪付Native
union_jsapi	云闪付JSAPI

通道支付参数 ¶

参数	名称	类型	描述
appId	微信小程序appid	String
qrCodeUrl	二维码地址	String	扫码进入的二维码地址，如码牌地址，合法形式为http/https地址
userAuthCode	用户授权码	String	用户前端跳转银联地址返回的用户授权码

PayBody数据说明 ¶

支付方式	描述
扫码支付	返回的是一个URL链接, 可以直接进行支付
微信小程序	返回的是一个URL链接, 可以直接进行支付
微信jsapi	参考微信支付Jsapi参数说明
支付宝Native	回的是一个URL链接, 可以直接进行支付
支付宝小程序	返参考微信小程序支付参数说明
支付宝JSAPI	返回的是个Map结构的Json字符串, 需要根据参数调起支付
云闪付Native	返回的是一个URL链接, 可以直接进行支付
云闪付JSAPI	银联JS支付直接返回URL，用云闪付打开此链接即可调起支付

微信小程序 ¶

参考微信小程序支付参数说明

json

{
    "appId": "wx69e931b913fc8e79",
    "timeStamp": "1664423199",
    "nonceStr": "ce481477de0b443faf16ad3a57f103be",
    "package": "prepay_id=wx29114639182713c7c051c5dcf998b50000",
    "signType": "RSA",
    "paySign": "qXoFd3ItmQjShScIl/+/nOvqGQc9RsPv4z/8ssZFlL8OH7IUK+2k2riP/TjvJ4dNUlGQdiJQOod4Mm//t+zKWXxgP9oHvHNGAhFjMob9EqTGgwDs2h3EGUZSuZmby6Jq4CE48klRbPteMW4Ds8SQoDGSpHCekF5svQ5EMej7PDmTG6mWLu3AwWAOzBgVHElfPX8Fpl/4BoJdwX3VqJczvp+cEaZpopY3vCWbMKurZrJUACZqmGq+gF3/ncZwN1j8Dir11NmSu9qNoCVX3kavcK2o70FBLSvWKgG+X53Z40iREXNW4g4vjL3kRBqgg88v41/wCBTdEuzRq9Te2cHP9Q=="
}

微信jsapi ¶

参考微信支付Jsapi参数说明

json

{
  "appId": "wx457df64656d1d334",
  "timeStamp": "1664417302",
  "nonceStr": "4a3fffc2d76f490683e4202d12d5a817",
  "package": "prepay_id=wx2910082246955079df1221a463fa630000",
  "signType": "RSA",
  "paySign": "QmRSq9olh5ioN8HjAV9oKUnmUJsY/f8mv3YsC4sFeTXF73TtGns2kLfV2X8Of+Ogq2z2uOUXKhT2gHFMr+BKvsSmMX5qcznfpz8wO6USJuIRd3pk5/tDAc5sNstMc5IeZdUU0lmsgMvHxxiUoWCdbHL5/xGQnr0Bci3VM9FqOFUFMGHb2UrS9PtsklA/hTBU9NvvRx6zoixbqrLunvnEvCN2hdRK5Hx0nVh5W/1TP9Hl5ZQpa8IfncpNi9K4piAptUwqSr+lUbonsb6z/QCTox1V0av6xcw4HKS7GbQKB635/jn5ry8IAzbfyXMSi5FoyxxIbj6InAzQfyaYlEFqHQ=="
}

支付宝小程序 ¶

参数	名称	类型	描述
trade_no	交易订单号	String	用于拉起支付宝支付

json

{
    "tradeNO": "2022092922001483011417110378"
}

支付宝JSAPI ¶

参数	名称	类型	描述
trade_no	交易订单号	String	用于拉起支付宝支付

json

{
    "tradeNO": "2022092922001483011417110378"
}

随行付 ¶

特殊说明 ¶

可以使用限制使用支付方式

支付方式 ¶

主扫和被扫方式对应到系统中的扫码支付和付款码支付，其他的都属于其他支付类型，见下方列表

编码	支付方式
ALIPAY	聚合支付-支付宝
WECHAT_JSAPI	聚合支付-微信jsapi
WECHAT_MINIAPP	聚合支付-微信小程序
UNIONPAY	聚合支付-银联
YZF	聚合支付-翼支付
CASHIER	小程序收银台

通道支付参数 ¶

参数	名称	类型	描述
payWay	支付方式	String	02 微信公众号/支付宝生活号/银联js支付/支付宝小程序/翼支付，03 微信小程序
subAppid	微信子公众号	String	小程序必传，仅微信使用
openId	用户唯一标识	String
appletSource	收银台类型	String	00 小程序支付插件，01 半屏小程序收银台

PayBody数据说明 ¶

支付方式	描述
扫码支付	返回的是一个URL链接, 可以直接进行支付
聚合支付-支付宝	返回的是一个交易号
聚合支付-微信jsapi	返回格式和使用方式参考微信Jsapi支付参数说明
聚合支付-微信小程序	返回格式和使用方式参考微信小程序支付参数说明
聚合支付-银联	返回的是银联重定向跳转地址
聚合支付-翼支付	返回的是一个翼支付APP的收银台地址
小程序收银台	返回的是一个URL链接, 可以直接进行支付

聚合支付-支付宝 ¶

返回支付宝流水号（对应trade_no），根据官方说明拉起支付：支付宝拉起控件

参数	名称	类型	描述
key	订单标识	String	当收银台类型为00时返回
amt	金额（单位元）	String	当收银台类型为00时返回
appId	可被拉起支付的小程序APPID	String	当收银台类型为01时返回
path	小程序带参路径	String	当收银台类型为01时返回

json

{
  "amt": "0.01",
  "key": "9199243b5c154c8692b0f418e1f1bde6",
  "path": "pages/home/pay/pay?key=c1748a9c72c7409db3015884bc6e1f6e&appletSource=01&name=商户名称&amt=0.01",
  "appId": "wx999999999999999c"
}

汇付天下(AdaPaY) ¶

特殊说明 ¶

可以使用限制使用支付方式

支付方式 ¶

汇付动态二维码支付对应系统中的扫码支付，其余的支付方式都为其他支付类型，见下方列表

支付方式	描述
alipay	支付宝App支付
alipay_qr	支付宝正扫
alipay_wap	支付宝H5支付
alipay_lite	支付宝小程序支付
alipay_pub	支付宝生活号支付
alipay_scan	支付宝反扫
wx_pub	微信公众号支付
wx_lite	微信小程序支付
wx_scan	微信反扫
union	(未支持)银联云闪付(云闪付入驻)
union_qr	(未支持)银联云闪付正扫(云闪付入驻)
union_wap	(未支持)银联云闪付H5支付(云闪付入驻)
union_scan	(未支持)银联云闪付反扫(云闪付入驻)
union_online	(未支持)银联H5支付
union_online	(未支持)银联统一收银台支付

通道支付参数 ¶

参数	名称	类型
buyerId	买家的支付宝用户 id	String
buyerLogonId	买家支付宝账号	String
openId	用户标识	String

PayBody数据说明 ¶

支付方式	描述
支付宝App支付	目前返回内容和支付宝正扫一致，待排查
支付宝正扫	返回的是一个URL链接, 可以直接进行支付
支付宝H5支付	目前返回内容和支付宝正扫一致，待排查
支付宝小程序支付	返回的是个Map结构的Json字符串, 需要根据参数调起支付
支付宝生活号支付	返回的是个Map结构的Json字符串, 需要根据参数调起支付
微信公众号支付	返回格式和使用方式参考微信Jsapi支付参数说明
微信小程序支付	返回格式和使用方式参考微信小程序支付参数说明