挂件展现
说明 #01
用户访问商户页面时,商户页面通过加载缴款服务挂件提供thirdpay_widget.js接口,调用thirdpay_widget.init()方法。将要显示挂件位置的“Div”的id、商户号、金额、挂件类型、商户后端生成charge对象的URL等参数传递给缴款服务挂件,缴款服务挂件通过页面渲染展现对应的可视化挂件。
thirdpay_widget.js为我方提供的挂件地址: 测试环境为: http://debug.epayservice.cn/thirdpay/resources/widget/js/thirdpay_widget.js 正式环境为: http://api.epayservice.cn/thirdpay/resources/widget/js/thirdpay_widget.js:
缴款挂件接口 #02
属性 | 描述 | 类型 | 是否必填 | 补充 |
---|---|---|---|---|
container | 显示挂件位置div的id | String | 是 | |
merchant_no | 商户号 | String | 是 | |
merchant_order_no | 商户订单号 | String | 是 | |
amount | 订单金额 | Integer | 是 | 单位 分 |
widget_param | 控件参数 | String | 否 | |
subject | 商品标题 | String | 否 | |
body | 商品描述 | String | 否 | |
charge_url | 创建Charge对象的 URL | String | 是 | |
charge_param | 透传参数 | String | 否 | |
device_type | 设备类型 | String | 是 | pc、phone |
effective_time | 有效时间 | String | 否 | 1m~15d,m-分钟,h-小时,d-天 默认当天1c,24点失效 |
version_no | 版本编码 | String | 是 | 1.0旧接口、1.1新接口 |
widget_param参数(直联) #03
属性 | 描述 | 类型 | 是否必填 | 补充 |
---|---|---|---|---|
nontax_amt | 非税金额合计 | Integer | 否 | 单位 分 |
other_amt | 其他金额合计 | Integer | 否 | 单位 分 |
引入js #03
调用js接口 #02
$(document).ready(function() {
thirdpay_widget.init({
container : container_id,
//挂件在当前页面放置的控件ID
merchant_no : merchant_no,
//分配的商户号
merchant_order_no : 'order1234567890',
//订单在商户系统中的订单号
amount : 1000,
//订单价格,单位:人民币 分
widget_param : {a: "a"},
//控件参数,常用来传递缴款服务所需定义的内容,如,
非税paycode直缴或传入相关缴费信息生成缴款书
subject : '商品标题',
// 商品标题,该参数最长为 32 个 Unicode 字符(商户根据自己的需求可选择传或不传)
body : '商品描述',
// 商品描述信息,该参数最长为 100 个 Unicode 字符(商户根据自己的需求可选择传或不传)
charge_url : 'http://localhost:8081/MerchantDemo/createCharge',
//商户服务端创建Charge字符串的 url
charge_param:{a:"a",b:"b"},
//(可选,用户自定义参数,若存在自定义参数则会通过 POST 方法透传给 charge_url)
device_type: 'pc',
effective_time : '1h ',
//有效时间,取值范围:1m~15d。m-分钟,h-小时,d-天,
1c-当天(1c-当天的情况下,无论交易何时创建,都在0点关闭)
version_no: '1.1'
});
});
关于我们
北京博思致新互联网科技有限责任公司成立于2016年,是行业领先的收缴服务提供商。
政付通小程序