关于使用规则,请注意:
关于接口文档,请注意:
目录 |
查询付费套餐(1.0),具体如下:
接口调用请求说明
http请求方式: POST
{WebPath}/api/*****/SearchPayPackages
POST数据说明
POST数据示例如下:
{
userID:"10129580",
type:0,
payType:0
}
参数说明
| 参数 | 是否必须 | 说明 |
|---|---|---|
| userID | 是 | 当前登录用户ID |
| type | 是 | 类型,0一卡通付费套餐,1短信套餐 |
| payType | 是 | 付款类型,0正常购买,1升级 |
返回值说明
在调用接口后,会返回JSON数据包。正常时的返回JSON数据包示例:
{
"error": 0,
"data": {
"empName": "陈雅诺",
"selectType": 0,
"qrCode": "二维码地址",
"photo": "http://oss.zjzdy.net/APP/20170719/d7d8218421b235327690657175e6a0e5.jpg",
"cardNo": "335731330",
"wxAccount": "",
"alipayAccount": "",
"unionPayAccount": "",
"projectDescription":"",
"items": [
{
"id": "10000001",
"itemName": "A套餐-不含定位",
"itemPrice": "¥158元/年",
"itemValue": 158,
"description": "包含多监护人,进出校考勤,选课走班刷卡,答题卡,语音通话功能",
"details": [
{
"icon": "http://oss.zjzdy.net/APP/att.png",
"title": "进出校考勤",
"content": "每天上学到校、放学离校,都有及时的消息通知"
},
{
"icon": "http://oss.zjzdy.net/APP/clsAtt.png",
"title": "教室考勤/选修课考勤",
"content": "进出教室,选修课到课,近距离刷卡签到"
},
{
"icon": "http://oss.zjzdy.net/APP/FamilyPhone.png",
"title": "校园情亲电话(壁挂式)",
"content": "校园内亲情电话,与家长及时联系沟通"
},
{
"icon": "http://oss.zjzdy.net/APP/Answers.png",
"title": "答题器功能",
"content": "课堂答题,参与课堂互动"
}
]
},
{
"id": "10000002",
"itemName": "B套餐-含定位",
"itemPrice": "¥188元/年",
"itemValue": 188,
"description": "包含多监护人,进出校考勤,选课走班刷卡,答题卡,语音通话,学生定位功能",
"details": [
{
"icon": "http://oss.zjzdy.net/APP/att.png",
"title": "进出校考勤",
"content": "每天上学到校、放学离校,都有及时的消息通知"
},
{
"icon": "http://oss.zjzdy.net/APP/clsAtt.png",
"title": "教室考勤/选修课考勤",
"content": "进出教室,选修课到课,近距离刷卡签到"
},
{
"icon": "http://oss.zjzdy.net/APP/FamilyPhone.png",
"title": "校园情亲电话(壁挂式)",
"content": "校园内亲情电话,与家长及时联系沟通"
},
{
"icon": "http://oss.zjzdy.net/APP/Answers.png",
"title": "答题器功能",
"content": "课堂答题,参与课堂互动"
}
]
}
]
}
}
返回字段说明
| 字段 | 类型 | 说明 | |||
|---|---|---|---|---|---|
| error | int | 返回值:'0'表示成功,'1'表示失败 | |||
| message | string | 'error=1'时错误信息有值返回 | |||
| data | empName | string | 支付人姓名 | ||
| photo | string | 支付人头像 | |||
| cardNo | string | 支付人卡号 | |||
| selectType | int | 选择类型,0单选1多选 | |||
| qrCode | string | 二维码地址 | |||
| protocolUrl | string | 用户协议地址 | |||
| wxAccount | string | 收款方微信账户 | |||
| alipayAccount | string | 收款方支付宝账户 | |||
| unionPayAccount | string | 收款方银联账户 | |||
| projectDescription | string | 项目描述 | |||
| items | id | string | 支付项ID | ||
| itemName | string | 支付项名称 | |||
| itemPrice | string | 支付项价格字符串 | |||
| itemValue | decimal | 支付项金额 | |||
| description | string | 支付项描述 | |||
| details | icon | string | 图标 | ||
| title | string | 标题 | |||
| content | string | 内容 | |||
支付,具体如下:
接口调用请求说明
http请求方式: Post
{WebPath}/api/*****/PayMoney
Post数据说明
Post数据示例如下:
{
channel: "wx",
subject: "智慧校园一卡通",
body: "套餐B-带定位功能",
amount: 0.01,
userID: "10129580",
empName: "陈雅诺",
itemIDs: "10000002",
type:0
}
参数说明
| 参数 | 是否必须 | 说明 |
|---|---|---|
| channel | 是 | 支付使用的第三方支付渠道 |
| subject | 是 | 商品的标题 |
| body | 是 | 商品的描述 |
| amount | 是 | 订单总金额, 单位为对应币种的最小货币单位,例如:人民币为分(如订单总金额为 1 元,此处请填 100)。 |
| userID | 是 | 用户ID。 |
| empName | 是 | 姓名 |
| itemIDs | 是 | 付款项ID,付款项多选的情况下,多个付款项ID之间用逗号“,”分隔 |
| type | 是 | 类型,0正常购买,1升级,2续费 |
返回字段说明
成功:
{
"error":0,
"data":{
"recordIDs":"10000001",
"chargeData":{
"error":0,
"charge":{
"id":"ch_9Ka1a5Ta5yj9efHmjPrfvH08",
"object":"charge",
"created":1470976321,
"livemode":false,
"paid":false,
"refunded":false,
"app":"app_DKWLKKDu9eLODmnv",
"channel":"alipay_wap",
"order_no":"1234567896",
"client_ip":"127.0.0.1",
"amount":1,
"amount_settle":1,
"currency":"cny",
"subject":"短信支付",
"body":"一年的短信费用",
"extra":{
"success_url":"http://pay.zjzdy.net/api/charges/success",
"cancel_url":"http://pay.zjzdy.net/api/charges/cancel"
},
"time_paid":null,
"time_expire":1471062721,
"time_settle":null,
"transaction_no":null,
"refunds":{
"object":"list",
"url":"/v1/charges/ch_9Ka1a5Ta5yj9efHmjPrfvH08/refunds",
"has_more":false,
"data":[
]
},
"amount_refunded":0,
"failure_code":null,
"failure_msg":null,
"metadata":{
},
"credential":{
"object":"credential",
"alipay_wap":{
"channel_url":"https://mapi.alipay.com/gateway.do",
"_input_charset":"utf-8",
"body":"一年的短信费用",
"it_b_pay":"2016-08-13 12:32:01",
"notify_url":"https%3A%2F%2Fapi.pingxx.com%2Fnotify%2Fcharges%2Fch_9Ka1a5Ta5yj9efHmjPrfvH08",
"out_trade_no":"1234567896",
"partner":"2008808933961979",
"payment_type":"1",
"return_url":"http%3A%2F%2Fpay.zjzdy.net%2Fapi%2Fcharges%2Fsuccess",
"seller_id":"2008808933961979",
"service":"alipay.wap.create.direct.pay.by.user",
"subject":"短信支付",
"total_fee":"0.01",
"sign":"q2oEnkJxdmYRUfCkSPDRq279VZpXrno0iGVHT9Cf1mPoNAEUrRvXHIYJK5ap1D+gV8L/73VDBeX7DbLKS598Yv6gFKcBocI3hK+aZ2yrW5yo+lA7rfjbDSMHZAcqxU2LFTT2feoyoCqWw/pfmRWghrgv/JTYPCih2ZA7y7vsgak=",
"sign_type":"RSA"
}
},
"description":null
}
}
}
}
| 字段 | 类型 | 说明 | |||
|---|---|---|---|---|---|
| error | int | 返回值:'0'表示成功,'1'表示失败 | |||
| message | string | error=1 返回错误信息 | |||
| data | recordIDs | string | 付款记录ID | ||
| chargeData | string | ping++服务器返回的支付凭据,具体结构参考ping++开发者文档 | |||
支付,具体如下:
接口调用请求说明
http请求方式: Post
{WebPath}/api/*****/*****
Post数据说明
Post数据示例如下:
{ paySys:1,
subject: "智慧校园一卡通",
body: "标准版",
amount: "1",
userID: "10129580",
empName: "陈雅诺",
itemIDs: "10000002",
type:0
}
参数说明
| 参数 | 是否必须 | 说明 |
|---|---|---|
| paySys | 是 | 支付系统,1支付宝,2微信 |
| subject | 是 | 商品的标题 |
| body | 是 | 商品的描述 |
| amount | 是 | 订单总金额,单位为分 |
| userID | 是 | 用户ID。 |
| empName | 是 | 姓名 |
| itemIDs | 是 | 付款项ID,付款项多选的情况下,多个付款项ID之间用逗号“,”分隔 |
| type | 是 | 类型,0正常购买,1升级,2续费 |
返回字段说明
成功:
微信:
{
"error":0,
"data":{
"appid": "wx1452baeb83ea61a6",
"mch_id": "1387268302",
"nonce_str": "ChcxLedbSr0chv6b",
"prepay_id": "wx0409030890684835ded5bd4e1132951724",
"result_code": "SUCCESS",
"return_code": "SUCCESS",
"return_msg": "OK",
"sign": "25FF4316A1F823816CC1259DBCEED350",
"trade_type": "APP"
}
支付宝:
{
"error":0,
"data":app_id=2088421497429280&biz_content=%7b%22body%22%3a%22%e6%a0%87%e5%87%86%e7%89%88%22%2c%22out_trade_no%22%3a%22201809040904486360427451%22%2c%22product_code%22%3a%22QUICK_MSECURITY_PAY%22%2c%22subject%22%3a%22%e6%99%ba%e6%85%a7%e6%a0%a1%e5%9b%ad%e4%b8%80%e5%8d%a1%e9%80%9a%22%2c%22total_amount%22%3a%220%22%7d&charset=utf-8&format=json&method=alipay.trade.app.pay&sign_type=RSA2×tamp=2018-09-04+09%3a04%3a50&version=1.0&sign=VQcLxluY5m4HWJLi997wEX4XfP1Jwb88c8NVqP%2fnow5x%2bkAD6Oomxr%2bXxDhdH6z2qMLLSVB4UCtNiTiU642H4vQDx1yHs5gHzEcvcJzJwPCi8picfhwP9W6xMU2xYE9MMOuhqAOOVw5UatbH1lZmTQeb437OIrV7qze7UKR%2bU4g%3d
}
| 字段 | 类型 | 说明 | |||
|---|---|---|---|---|---|
| error | int | 返回值:'0'表示成功,'1'表示失败 | |||
| message | string | error=1 返回错误信息 | |||
| data | string | 预支付订单信息 | |||
获取付款成功信息,具体如下:
接口调用请求说明
http请求方式: Post
{WebPath}/api/*****/SearchSuccessData
Post数据说明
Post数据示例如下:
{
userID:"10129580",
orderNumber:"123456789"
}
参数说明
| 参数 | 是否必须 | 说明 |
|---|---|---|
| ids | 是 | 付款记录ID,多个ID之间逗号分隔 |
返回字段说明
成功:
{
"error":0
}
| 字段 | 类型 | 说明 | |||
|---|---|---|---|---|---|
| error | int | 返回值:'0'表示成功,'1'表示失败 | |||
| message | string | error=1 返回错误信息 | |||
| data | projectName | string | 项目名称 | ||
| itemName | string | 套餐名称 | |||
| payStartDate | string | 生效开始时间 | |||
| payEndDate | string | 到期时间 | |||
| empName | string | 姓名 | |||
| imei | string | 智慧校园卡卡号 | |||
| sim | string | sim卡卡号 | |||
| gradeName | string | 年级名称 | |||
| className | string | 班级名称 | |||
| mobile | string | 开通短信套餐的手机号 | |||