关于使用规则,请注意:


关于接口文档,请注意:



目录

查询付费套餐

查询付费套餐(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 开通短信套餐的手机号