接口介绍
H5支付接口, 本接口会返回一个链接,消费者用支付宝、微信直接打开这个链接可以进行支付。
参数简介
参数名 | 参数类型 | 参数介绍 | 是否必填 | 是否参与签名 |
---|---|---|---|---|
command | String(32) | 接口名,用于标识调用哪个接口,H5支付:open.pay.h5 | 是 | 否 |
operator_id | String(32) | 收银员的id,用于标识收款账户 | 是 | 是 |
app | String(32) | 接入商标识 | 是 | 是 |
version | Double | 接口版本号,默认值1.0,当前值只能为1.0和1.1会影响返回值,详情请见返回值部分 | 是 | 否 |
sign | String(32) | 签名,详见请求签名规则 | 是 | 否 |
local_order_no | String(64) | 接入方的本地订单号,接入方请保证这个订单号的唯一性, 采宝不进行唯一性校验,如果订单号不唯一,会影响查询结果 | 否 | 是 |
amount | Long | 订单总额,以分为单位 | 是 | 是 |
un_discount_amount | Long | 不参与优惠金额,以分为单位 | 否 | 是 |
timestamp | Long | 时间戳,值为当前时间距离19700101的毫秒数 | 是 | 是 |
subject | String(20) | 订单描述,小于20个汉字 | 否 | 是 |
confirm_way | String(20) | 提交方式,NORMAL(普通方式提交支付)、AUTO_PAY(自动提交支付) | 否 | 是 |
goods_list | String(4096) | 商品列表 | 否 | 是 |
notify_url | String(256) | 支付成功之后的回调地址,具体请参照:支付完成之后的通知 | 否 | 否 |
redirect_url | String(256) | 支付成功之后的跳转页面 | 否 | 否 |
device_create_ip | String(32) | 发起支付服务器或终端IP地址,格式为8.8.8.8 | 否 | 是 |
expire_in | Long | 生成的链接的时效时间(单位为秒),取值范围为60(一分钟)至86400(一天) | 否 | 否 |
wx_hospital_scene | String(64) | 微信医疗场景 | 否 | 否 |
goods_list 介绍
goods_list是商品列表信息, 传入此值后会自动统计商品的销量等信息,并且会被放入订单中。 格式为json格式, 举例如下:
[
{
"goods_id":"", ## 商品id,可空
"goods_num":"", ## 商品编号,这个值用于传入到微信、支付宝等, 用于支持单品券的核销,可空
"goods_name":"", ## 商品名称,可空
"sell_amount":"", ## 卖出数量,不可为空
"goods_price":"", ## 商品单价,不可为空
"goods_sku_id":"" ## 卖出的sku的id,可空
},
{
"goods_id":"", ## 商品id,可空
"goods_num":"", ## 商品编号,这个值用于传入到微信、支付宝等, 用于支持单品券的核销,可空
"goods_name":"", ## 商品名称,可空
"sell_amount":"", ## 卖出数量,不可为空
"goods_price":"", ## 商品单价,不可为空
"goods_sku_id":"" ## 卖出的sku的id,可空
},
{
"goods_id":"", ## 商品id,可空
"goods_num":"", ## 商品编号,这个值用于传入到微信、支付宝等, 用于支持单品券的核销,可空
"goods_name":"", ## 商品名称,可空
"sell_amount":"", ## 卖出数量,不可为空
"goods_price":"", ## 商品单价,不可为空
"goods_sku_id":"" ## 卖出的sku的id,可空
}
......
]
返回值说明
参数名 | 所属结构 | 返回值类型 | 返回值说明 | 特殊备注 |
---|---|---|---|---|
success | result | boolean | 标识这次请求是否成功 | 请不要用这个值来判断收银是否成功。 |
errorCode | result | String | 错误码 | |
errorMsg | result | String | 错误码的详细说明 | |
url | data | String | 生成的h5链接 | 参与签名 |
localOrderNo | data | String | 本地订单号 | 参与签名 |
cbOrderNo | data | String(64) | 采宝的订单号,最长64位 | 参与签名 |
totalAmount | data | Long | 收款总额,分为单位 | 参与签名 |
paymentChannel | data | int | 支付渠道 | 参与签名,具体取值请参照:名词解释 |
sign | data | String | 签名值 | 具体参照: 接口返回值的安全校验规则 |
timestamp | data | String | 时间戳 | 参与签名 |
subject | data | String | 订单主题 | 只有version大于等于1.1时才会返回 |
paymentWay | data | String | 付款方式 | 只有version大于等于1.1时才会返回,具体取值参照:名词解释 |
返回值示例
{
"result": {
"success": false,
"errorCode":"10",
"errorMsg": "command参数为空"
}
"data":{
"url":"" ##h5的链接,参与签名
"localOrderNo":"",##本地订单号,参与签名
"cbOrderNo":"",##采宝的订单号,参与签名
"totalAmount":"",##订单金额,参与签名
"paymentChannel":""##支付渠道,1支付宝,2微信,3百度钱包,4翼支付,参与签名
,"sign":"" ## 签名值
,"timestamp":"" ## 时间戳,参与签名
##===========以下字段只有version大于等于1.1时才会返回========
,"subject":"" ##订单主题
,"paymentWay":""## 付款方式
}
}