挂件收缴接口说明(手机挂件)
挂件展现说明 #01
用户访问商户手机页面时,商户页面通过加载缴款服务挂件提供thirdpay_widget.js接口,调用thirdpay_widget.init()方法。将要显示挂件位置的“Div”的class、触发显示收缴方式的按钮的class、商户号、金额、挂件类型、 商户后端生成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.1 |
widget_param参数(非税生成缴款) #03
属性 | 描述 | 类型 | 是否必填 | 补充 |
---|---|---|---|---|
businessNo | 业务单号,执收单位业务单号 | String | 是 | 不可重复 |
businessType | 业务类型 | String | ||
agencyCode | 执收单位编码 | String | 是 | |
date | 填制日期 | String | 是 | 填制日期 |
payerName | 缴款人名称 | String | 是 | |
payerTel | 缴款人手机号 | String | 否 | |
payerAccName | 缴款人户名 | String | 否 | |
payerAccNo | 缴款人账号 | String | 否 | |
payerBank | 缴款人开户银行 | String | 否 | |
payerBankId | 缴款人所属银行 | String | 否 | |
payerCertificate | 缴款人证件号 | String | 否 | |
payeeAccAssignType | 账户给定方式 | String | 是 | 1财政设置2单位指定3子账号 |
payeeAccName | 收款人全称 | String | 否 | 账户给定方式为2时必填 |
payeeAccNo | 收款人账号 | String | 否 | 账户给定方式为2时必填 |
payeeAccBankName | 收款人开户银行 | String | 否 | 账户给定方式为2时必填 |
totalAmt | 缴款金额合计 | Integer | 是 | 单位 分 |
other_amt | 其他金额合计 | Integer | 否 | 单位 分 |
author | 开票人 | String | 是 | |
effectiveDate | 有效日期 | String | 否 | YYYY-MM-DD |
memo | 备注 | String | 否 | 备注 |
itemDetails | 收费项目明细内容 | List | 是 | 见下方表格 |
details收费项目明细:
属性 | 描述 | 类型 | 是否必填 | 补充 |
---|---|---|---|---|
itemCode | 项目编码 | String | 是 | |
itemName | 项目名称 | String | 是 | |
unit | 项目执收单位 | String | 是 | |
number | 执收数量 | Integer | 是 | |
std | 执收标准 | Integer | 是 | 单位 分 |
amt | 项目执收金额 | Integer | 是 | 单位 分 |
Demo #04
引入js
调用js接口
$(document).ready(function() {
$(".buttonClass").click(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'
});
});
});
跳转缴款查询页面说明 #05
缴款服务后端返回跳转查询页面的表单,商户端自动提交表单即可跳转到我方查询缴款页面。
关于我们
北京博思致新互联网科技有限责任公司成立于2016年,是行业领先的收缴服务提供商。
公司动态
其它信息
联系我们
获取方案