- 1.支付商户号绑定
- 1.1 添加商户
- 1.2 根据企业ID获取商户信息
- 1.3 更新商户
- 2.PC端支付
- 2.1 消费订单（PC端）
- 3.APP支付（原生）
- 3.1 消费订单（支付宝）
- 3.2 消费订单（微信）
- 4.订单查询和退款
- 4.1 判断订单是否可以支付
- 4.2 获取订单详情
- 4.3 退款订单
- 5.电子钱包
- 5.1 园区平台方开通电子钱包（需要先开通银雁支付）（需要平台方登陆）
- 5.1.1园区新建钱包
- 5.1.2园区开通钱包
- 5.2 园区平台方查询钱包账户（需要平台方登陆）
- 5.3 园区企业方开通电子钱包（需要企业方登陆）
- 5.4 园区企业方查询钱包账户（需要企业方登陆）
- 5.5 园区个人开通电子钱包（需要个人方登陆）
- 5.6 园区个人查询钱包账户（需要个人方登陆）
- 5.7 园区个人充值
- 5.8 园区个人消费订单
- 5.9 园区个人消费订单密码确认
- 5.10 园区个人消费免密码确认
- 5.11 园区个人转账订单
- 5.12 园区个人转账订单短信确认
- 5.13 园区个人转账订单短信重复确认
- 5.14 园区个人消费订单退单退款
- 5.15 园区订单详情获取
- PS:
- 1.订单状态
- 2.内部feign调用（以及钱包接口sign方法）
- 3.钱包流程参考
- 4.订单状态通过MQ获取
- 4.1开发者后台订阅套件
- 4.2开发者后端配置订阅
1.支付商户号绑定
包括绑定支付平台的唯一的资金存款户，一个商户收款户。
1.1 添加商户
接口地址：https://pai.flyrise.cn/pay-gateway-api/yinyan/merchant
请求方式：POST
请求数据类型：application/json
接口参数：
{
"enterpriseId": "1309331342667943936",
"enterpriseName": "珠海南方软件园发展有限公司",
"isDeleted": 0,
"mchCusId": "M9200046", // 线下跟银雁平台签约，获取唯一资金存款户和商户收款户
"mchStatus": "1",
"parkId": "1309331342667943937",
"tenantId": "1309331342667943937"
}返回结果：
{
"code": "200",
"data": {
"id": "1457895018103029761",
"tenantId": "1309331342667943937",
"parkId": "1309331342667943937",
"enterpriseId": "1309331342667943936",
"enterpriseName": "珠海南方软件园发展有限公司",
"mchCusId": "M9200046",
"mchStatus": "1",
"createBy": "1309331342693109760",
"createTime": "2021-11-09T02:17:13.000+0000",
"updateBy": "1309331342693109760",
"updateTime": "2021-11-09T02:17:13.000+0000",
"isDeleted": null
},
"time": 1636424233448,
"msg": "操作成功",
"annex": null,
"success": true
}1.2 根据企业ID获取商户信息
接口地址：https://pai.flyrise.cn/pay-gateway-api/yinyan/merchant/get
请求方式：GET
请求数据类型：application/x-www-form-urlencoded
接口参数：
enterpriseId=1309331342667943936&parkId=1309331342667943937返回结果：
{
"code": "200",
"data": {
"id": "1457895018103029761",
"tenantId": "1309331342667943937",
"parkId": "1309331342667943937",
"enterpriseId": "1309331342667943936",
"enterpriseName": "珠海南方软件园发展有限公司",
"mchCusId": "M9200046",
"mchStatus": "1",
"createBy": "1309331342693109760",
"createTime": "2021-11-09T02:17:13.000+0000",
"updateBy": "1309331342693109760",
"updateTime": "2021-11-09T02:17:13.000+0000",
"isDeleted": null
},
"time": 1636530221494,
"msg": "操作成功",
"annex": null,
"success": true
}1.3 更新商户
接口地址：https://pai.flyrise.cn/pay-gateway-api/yinyan/merchant
请求方式：PUT
请求数据类型：application/json
接口参数：
{
"id": "1457895018103029761",
"mchStatus": "0" //停用
}返回结果：
{
"code": "200",
"data": {
"id": "1457895018103029761",
"tenantId": "1309331342667943937",
"parkId": "1309331342667943937",
"enterpriseId": "1309331342667943936",
"enterpriseName": "珠海南方软件园发展有限公司",
"mchCusId": "M9200046",
"mchStatus": "0",
"createBy": "1309331342693109760",
"createTime": "2021-11-09T02:17:13.000+0000",
"updateBy": "1309331342693109760",
"updateTime": "2021-11-10T07:46:13.000+0000",
"isDeleted": null
},
"time": 1636530372813,
"msg": "操作成功",
"annex": null,
"success": true
}2.PC端支付
2.1 消费订单（PC端）
接口地址：https://pai.flyrise.cn/pay-gateway-api/yinyan/order/consume
请求方式：POST
请求数据类型：application/json
接口参数：
{
"amount": 5, //金额单位为分,测试环境：个人支付金额要1元以下，企业支付要0.1元以下
"bizGoodsNo": "1234", //商品唯一号
"bizOrderNo": "12365", //订单唯一号
"goodsDesc": "xx企业12月账单",
"goodsName": "12月账单",
"orderType": "1", //消费
"parkId": "1309331342667943937",
"payMethod": "01", //网银
"payerId": "1309331342667943936",//付款者ID
"payeeId": "1309331342667943936",//收款者ID
"source": 2 //pc
}返回结果：
{
"code": "200",
"data": {
"payInfo": null,
"payUrl": "https://unipay-cashier-uat.huafagroup.com/cashier/pc?orderNo=3004602eb2486aa4e1e73af456405c28",
"payMethod": null,
"bizOrderNo": "3153151",
"tradeNo": "3004602eb2486aa4e1e73af456405c28"
},
"time": 1636442630744,
"msg": "操作成功",
"annex": null,
"success": true
}3.APP支付（原生）
3.1 消费订单（支付宝）
接口地址：https://pai.flyrise.cn/pay-gateway-api/yinyan/order/consume
请求方式：POST
请求数据类型：application/json
接口参数：
{
"amount": 5, //金额单位为分,测试环境：个人支付金额要1元以下，企业支付要0.1元以下
"bizGoodsNo": "1234", //商品唯一号
"bizOrderNo": "1230981", //订单唯一号
"goodsDesc": "xx企业12月账单",
"goodsName": "12月账单",
"orderType": "1", //消费
"parkId": "1309331342667943937",
"payMethod": "03", //支付宝
"payerId": "1309331342667943936", //付款者ID
"payeeId": "1309331342667943936",//收款者ID
"source": 1 //手机
}返回结果：
{
"code": "200",
"data": {
"payInfo": "{\"tradeReq\":\"alipay_sdk=alipay-sdk-java-3.7.110.ALL&app_id=2021001197607606&biz_content=%7B%22total_amount%22%3A%220.05%22%2C%22subject%22%3A%221234%22%2C%22out_trade_no%22%3A%22C2021110917283408800000088%22%2C%22app_auth_token%22%3A%22%22%7D&charset=UTF-8&format=json&method=alipay.trade.app.pay¬ify_url=https%3A%2F%2Funipay-channel-uat.huafagroup.com%2Fchannel%2Falipay%2Ftrade%2FA0000002%2F&sign=dtWTjjyTxXqsMagXc6Jys8S43fnk3%2F12k%2B2Hk3w6eJu55XE9Av6ccJC4o2iek9KF6j%2BTFPyyBd7zErLCkA3RDIL5byT8Frt2iayItmEYCvoZQ4KClWjz9BcBsPkvPXcX67rNK0vlXG2eojZ%2Bu7LgZ0ZXC3nfA3sKD1Jy6jn6td%2BeLgsoL74mxItnunk6nLDSiaygGaVCM4mlKToEDZdS9JQnyV3lT%2FNmQGH3AJwlb5XuJKBtwQpOmf6aEM8t%2FQtljiJJ77Ryfl%2FZrVfFCMGZYwdu%2BXFUCh89wdocWOd0zyUJ9ieUq5xMNcYhHajTnMQhx79skCVe1EQ3oHc%2B4XAjwQ%3D%3D&sign_type=RSA2×tamp=2021-11-09+17%3A28%3A34&version=1.0\"}",
"payUrl": null,
"payMethod": null,
"bizOrderNo": "1230981",
"tradeNo": "617981782987177984"
},
"time": 1636450114337,
"msg": "操作成功",
"annex": null,
"success": true
}3.2 消费订单（微信）
接口地址：https://pai.flyrise.cn/pay-gateway-api/yinyan/order/consume
请求方式：POST
请求数据类型：application/json
接口参数：
{
"amount": 5, //金额单位为分,测试环境：个人支付金额要1元以下，企业支付要0.1元以下
"bizGoodsNo": "1234", //商品唯一号
"bizOrderNo": "123098", //订单唯一号
"goodsDesc": "xx企业12月账单",
"goodsName": "12月账单",
"orderType": "1", //消费
"parkId": "1309331342667943937",
"payMethod": "02", //微信
"payerId": "1309331342667943936",//付款者ID
"payeeId": "1309331342667943936",//收款者ID
"source": 1 //手机
}返回结果：
{
"code": "200",
"data": {
"payInfo": "{\"appid\":\"wx1568173e9bdc2bf2\",\"partnerid\":\"1603564538\",\"prepayid\":\"wx0917245894324143c6f35aea8bb2120000\",\"package\":\"Sign=WXPay\",\"noncestr\":\"wf4hwjuxl4up49gvj9bcf1ydgtz03737\",\"timestamp\":\"1636449899\",\"sign\":\"5333945F537BEF182A1EDA29ADF04351\"}",
"payUrl": null,
"payMethod": null,
"bizOrderNo": "123098",
"tradeNo": "617981560106057728"
},
"time": 1636449899419,
"msg": "操作成功",
"annex": null,
"success": true
}4.订单查询和退款
4.1 判断订单是否可以支付
接口地址：https://pai.flyrise.cn/pay-gateway-api/yinyan/order/checkOrderCanPay
请求方式：GET
请求数据类型：application/x-www-form-urlencoded
接口参数：
parkId=1309331342667943937&payeeId=1309331342667943936&payerId=1309331342667943936返回结果：
{
"code": "200",
"data": true,
"time": 1636531301487,
"msg": "操作成功",
"annex": null,
"success": true
}4.2 获取订单详情
接口地址：https://pai.flyrise.cn/pay-gateway-api/yinyan/order/getDetail
请求方式：GET
请求数据类型：application/x-www-form-urlencoded
接口参数：
orderNo=1234&parkId=1309331342667943937
返回结果：
{
"code": "200",
"data": {
"id": "1457914131835736066",
"tenantId": "1309331342667943937",
"parkId": "1309331342667943937",
"orgid": null,
"cusid": "M9200005",
"returl": null,
"notifyurl": null,
"goodsid": "1223",
"goodsinf": "xx企业12月账单",
"trxamt": "100",
"orderid": "1234",
"randomstr": "vqv1biyi",
"gateid": null,
"paytype": "1",
"validtime": null,
"limitpay": null,
"trxid": null,
"paytime": "17:24:04",
"trxstatus": "P05",
"errmsg": "617893363627917312",
"payUrl": "https://unipay-cashier-uat.huafagroup.com/cashier/pc?orderNo=9392d3a0f6b6e812bdb857378960a244",
"payInfo": "9392d3a0f6b6e812bdb857378960a244",
"createBy": "1309331342693109760",
"createTime": "2021-11-09T03:33:10.000+0000",
"updateBy": "1309331342693109760",
"updateTime": "2021-11-09T09:24:05.000+0000",
"isDeleted": null
},
"time": 1636530995895,
"msg": "操作成功",
"annex": null,
"success": true
}4.3 退款订单
接口地址：https://pai.flyrise.cn/pay-gateway-api/yinyan/order/refund
请求方式：POST
请求数据类型：application/json
接口参数：
{
"amount": 10, //金额单位为分
"bizOrderNo": "12340", //退款订单号
"bizUserId": "1309331342667943936",
"orderType": "2", //退款
"oriBizOrderNo": "1234", //原订单号
"parkId": "1309331342667943937",
"source": 2 //pc
}返回结果：
{
"code": "500",
"data": null,
"time": 1636530934908,
"msg": "退款结果异常",
"annex": {
"applicationName": "pai-pay-yinyan",
"bizExceptionClassName": "cn.flyrise.pay.yinyan.exception.PayYinyanBizException",
"errorMsg": "退款结果异常"
},
"success": false
}5.电子钱包
5.1 园区平台方开通电子钱包（需要先开通银雁支付）（需要平台方登陆）
5.1.1园区新建钱包
接口地址：https://pai.flyrise.cn/pay-gateway-api/wallet
请求方式：POST
请求数据类型：application/json
接口参数：
{
"name": "园付通",
"parkId": "1309331342667943937",
"protocol": "<h1 id=\"k2iwp\" style=\"text-align:center;\"><p><b><span style=\"mso-bidi-font-size:10.5pt;font-family:宋体;mso-ascii-font-family:Helvetica;mso-hansi-font-family:Helvetica;mso-bidi-font-family:宋体;color:#333333;mso-font-kerning:0pt\">园圈平台服务协议</span></b><span></span></p><p style=\"mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;text-align:left;mso-pagination:widow-orphan\"><span style=\"mso-bidi-font-size:10.5pt;font-family:宋体;mso-ascii-font-family:Helvetica;mso-hansi-font-family:Helvetica;mso-bidi-font-family:宋体;color:#333333;mso-font-kerning:0pt\">欢迎您使用园圈平台服务！</span><span></span></p><p><span style=\"mso-bidi-font-size:10.5pt;font-family:宋体;mso-ascii-font-family:Helvetica;mso-hansi-font-family:Helvetica;mso-bidi-font-family:宋体;color:#333333;mso-font-kerning:0pt\">《园圈平台服务协议》（以下简称</span><span>“</span><span style=\"mso-bidi-font-size:10.5pt;font-family:宋体;mso-ascii-font-family:Helvetica;mso-hansi-font-family:Helvetica;mso-bidi-font-family:宋体;color:#333333;mso-font-kerning:0pt\">本协议</span><span>”</span><span style=\"mso-bidi-font-size:10.5pt;font-family:宋体;mso-ascii-font-family:Helvetica;mso-hansi-font-family:Helvetica;mso-bidi-font-family:宋体;color:#333333;mso-font-kerning:0pt\">）由您与园圈共同缔结，本协议具有合同效力。为使用园圈平台的服务，您应当阅读并遵守本协议。请您务必审慎阅读、充分理解各条款内容，特别是免除或者减轻我们责任的条款、管辖与法律适用条款，以及开通或使用某项服务的单独协议。限制、免责条款可能以黑体加粗形式提示您注意。除非您已阅读并接受本协议所有条款，否则您无权使用园圈提供的服务。您使用园圈的服务即视为您已阅读并同意上述协议的约束。如果您未满</span><span>18</span><span style=\"mso-bidi-font-size:10.5pt;font-family:宋体;mso-ascii-font-family:Helvetica;mso-hansi-font-family:Helvetica;mso-bidi-font-family:宋体;color:#333333;mso-font-kerning:0pt\">周岁，请在法定监护人的陪同下阅读本协议，并特别注意未成年人使用条款。</span></h2>",
"remark": ""
}返回结果：
{
"code":"200",
"data":{
"id":"1420583628445790209",
"tenantId":"1309331342667943937",
"parkId":"1309331342667943937",
"name":"园付通通园付通园付通园付",
"remark":"",
"protocol":"<h1 id=\"k2iwp\" style=\"text-align:center;\"><p><b><span style=\"mso-bidi-font-size:10.5pt;font-family:宋体;mso-ascii-font-family:Helvetica;mso-hansi-font-family:Helvetica;mso-bidi-font-family:宋体;color:#333333;mso-font-kerning:0pt\">园圈平台服务协议</span></b><span></span></p><p style=\"mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;text-align:left;mso-pagination:widow-orphan\"><span style=\"mso-bidi-font-size:10.5pt;font-family:宋体;mso-ascii-font-family:Helvetica;mso-hansi-font-family:Helvetica;mso-bidi-font-family:宋体;color:#333333;mso-font-kerning:0pt\">欢迎您使用园圈平台服务！</span><span></span></p><p><span style=\"mso-bidi-font-size:10.5pt;font-family:宋体;mso-ascii-font-family:Helvetica;mso-hansi-font-family:Helvetica;mso-bidi-font-family:宋体;color:#333333;mso-font-kerning:0pt\">《园圈平台服务协议》（以下简称</span><span>“</span><span style=\"mso-bidi-font-size:10.5pt;font-family:宋体;mso-ascii-font-family:Helvetica;mso-hansi-font-family:Helvetica;mso-bidi-font-family:宋体;color:#333333;mso-font-kerning:0pt\">本协议</span><span>”</span><span style=\"mso-bidi-font-size:10.5pt;font-family:宋体;mso-ascii-font-family:Helvetica;mso-hansi-font-family:Helvetica;mso-bidi-font-family:宋体;color:#333333;mso-font-kerning:0pt\">）由您与园圈共同缔结，本协议具有合同效力。为使用园圈平台的服务，您应当阅读并遵守本协议。请您务必审慎阅读、充分理解各条款内容，特别是免除或者减轻我们责任的条款、管辖与法律适用条款，以及开通或使用某项服务的单独协议。限制、免责条款可能以黑体加粗形式提示您注意。除非您已阅读并接受本协议所有条款，否则您无权使用园圈提供的服务。您使用园圈的服务即视为您已阅读并同意上述协议的约束。如果您未满</span><span>18</span><span style=\"mso-bidi-font-size:10.5pt;font-family:宋体;mso-ascii-font-family:Helvetica;mso-hansi-font-family:Helvetica;mso-bidi-font-family:宋体;color:#333333;mso-font-kerning:0pt\">周岁，请在法定监护人的陪同下阅读本协议，并特别注意未成年人使用条款。</span></h2>",
"isDeleted":0,
"status":0,
"createBy":"1309331342693109760",
"createTime":"2021-08-13T06:36:33.000+0000",
"updateBy":"1309331342693109760",
"updateTime":"2021-10-18T02:25:45.000+0000"
},
"time":1648805922274,
"msg":"操作成功",
"annex":null,
"success":true
}5.1.2园区开通钱包
接口地址：https://pai.flyrise.cn/pay-gateway-api/wallet/account/park/createAccount
请求方式：POST
请求数据类型：application/json
接口参数：
{
"enterpriseId": "1309331342667943936",//运营平台企业id
"enterpriseName": "开发测试企业",
"parkId": "1309331342667943937",//园区id
"password": "123456",//钱包密码
"payChannel": "4",//银雁平台
"walletId": "1420583628445790209"//上面获取园区钱包id
}返回结果：
{
"code": "200",
"data": {
"parkId": "1309331342667943937",
"parkName": "开发测试园区",
"walletId": "1420583628445790209",
"walletName": "园付通通园付通园付通园付",
"userId": "1309331342667943936",
"name": "开发测试企业",
"type": "0",
"bindPhone": "13247168875",
"deviceCode": null,
"payChannel": "4",
"balance": "99",
"balanceId": "1426021511476211714",
"status": 1,
"createTime": "2021-08-13T09:20:57.000+0000"
},
"time": 1637227779991,
"msg": "操作成功",
"annex": null,
"success": true
}5.2 园区平台方查询钱包账户（需要平台方登陆）
接口地址：https://pai.flyrise.cn/pay-gateway-api/wallet/account/park/getAccount
请求方式：GET
请求数据类型：application/x-www-form-urlencoded
接口参数：
parkId=1309331342667943937返回结果：
{
"code": "200",
"data": {
"parkId": "1309331342667943937",
"parkName": "开发测试园区",
"walletId": "1420583628445790209",
"walletName": "园付通通园付通园付通园付",
"userId": "1309331342667943936",
"name": "开发测试企业",
"type": "0",
"bindPhone": "13247168875",
"deviceCode": null,
"payChannel": "4",
"balance": "99",
"balanceId": "1426021511476211714",
"status": 1,
"createTime": "2021-08-13T09:20:57.000+0000"
},
"time": 1637227893115,
"msg": "操作成功",
"annex": null,
"success": true
}5.3 园区企业方开通电子钱包（需要企业方登陆）
接口地址：https://pai.flyrise.cn/pay-gateway-api/wallet/account/enterprise/createAccount
请求方式：POST
请求数据类型：application/json
接口参数：
{
"bindPhone": "18507568764",//绑定手机号
"parkId": "1309331342667943937",//园区id
"password": "123456",//钱包密码
"payChannel": "0",//钱包
"walletId": "1420583628445790209"//上面获取园区钱包id
}返回结果：
{
"code": "200",
"data": {
"parkId": "1309331342667943937",
"parkName": "开发测试园区",
"walletId": "1420583628445790209",
"walletName": "园付通通园付通园付通园付",
"userId": "1309331342667943936",
"name": "开发测试企业",
"type": "0",
"bindPhone": "13247168875",
"deviceCode": null,
"payChannel": "4",
"balance": "99",
"balanceId": "1426021511476211714",
"status": 1,
"createTime": "2021-08-13T09:20:57.000+0000"
},
"time": 1637228035869,
"msg": "操作成功",
"annex": null,
"success": true
}5.4 园区企业方查询钱包账户（需要企业方登陆）
接口地址：https://pai.flyrise.cn/pay-gateway-api/wallet/account/enterprise/getAccount
请求方式：GET
请求数据类型：application/x-www-form-urlencoded
接口参数：
parkId=1309331342667943937返回结果：
{
"code": "200",
"data": {
"parkId": "1309331342667943937",
"parkName": "开发测试园区",
"walletId": "1420583628445790209",
"walletName": "园付通通园付通园付通园付",
"userId": "1309331342667943936",
"name": "开发测试企业",
"type": "0",
"bindPhone": "13247168875",
"deviceCode": null,
"payChannel": "4",
"balance": "99",
"balanceId": "1426021511476211714",
"status": 1,
"createTime": "2021-08-13T09:20:57.000+0000"
},
"time": 1637228120567,
"msg": "操作成功",
"annex": null,
"success": true
}5.5 园区个人开通电子钱包（需要个人方登陆）
接口地址：https://pai.flyrise.cn/pay-gateway-api/wallet/account/person/createAccount
请求方式：POST
请求数据类型：application/json
接口参数：
{
"bindPhone": "13012345678",
"deviceCode": "13012345678",// 绑定的设备编码
"parkId": "1309331342667943937",
"password": "123456", //钱包密码
"type": "2",// 账户类型;0：运营方，1：企业，2：员工
"walletId": "1420583628445790209" //上面获取园区钱包id
}返回结果：
{
"code": "200",
"data": {
"parkId": "1309331342667943937",
"parkName": "开发测试园区",
"walletId": "1420583628445790209",
"walletName": "园付通通园付通园付通园付",
"userId": "1309331342693109760",
"name": "测试管理员1",
"type": "2",
"bindPhone": "13012345678",
"deviceCode": "34U5AW5EYNTLCPPXJO5VPP426FVR2A",
"payChannel": "0",
"balance": "3",
"balanceId": "1426019938985504770",
"status": 0,
"createTime": "2021-08-13T03:17:02.000+0000"
},
"time": 1637288463820,
"msg": "操作成功",
"annex": null,
"success": true
}5.6 园区个人查询钱包账户（需要个人方登陆）
接口地址：https://pai.flyrise.cn/pay-gateway-api/wallet/account/person/getAccount
请求方式：GET
请求数据类型：application/x-www-form-urlencoded
接口参数：
parkId=1309331342667943937返回结果：
{
"code": "200",
"data": {
"parkId": "1309331342667943937",
"parkName": "开发测试园区",
"walletId": "1420583628445790209",
"walletName": "园付通通园付通园付通园付",
"userId": "1309331342693109760",
"name": "测试管理员1",
"type": "2",
"bindPhone": "13012345678",
"deviceCode": "34U5AW5EYNTLCPPXJO5VPP426FVR2A",
"payChannel": "0",
"balance": "3",
"balanceId": "1426019938985504770",
"status": 0,
"createTime": "2021-08-13T03:17:02.000+0000"
},
"time": 1637300694201,
"msg": "操作成功",
"annex": null,
"success": true
}5.7 园区个人充值
接口地址：https://pai.flyrise.cn/pay-gateway-api/wallet/order/deposit
请求方式：POST
请求数据类型：application/json
接口参数：
{
"amount": 1, //金额（单位为分）
"bizOrderNo": "1111", //雪花算法生成id
"bizUserId": "1309331342693109760", //用户id
"goodsName": "电子钱包用户管理员1充值30.00元",
"orderType": "4", //订单类型;1：消费订单，2：退款订单，3：提现订单，4：充值订单，5：转账订单
"parkId": "1442748371519823872",
"payMethod": "02", // 支付方式;01:网银，02:微信扫码，03：支付宝扫码，04：微信小程序
"source": 1, //访问终端类型 1 mobile 2 PC
"sign": "85CD5F825DB835111B1A02B5DB47799AB46D6958", //见PS.2中sign生成方法
"validTime": 30 //订单支付时效（单位为分钟）,
"appId":"2021001166627183",
"walletId": "1420583628445790209"
}
返回结果：
{
"code":"200",
"data":{
"payInfo":"{\"appid\":\"wx1568173e9bdc2bf2\",\"partnerid\":\"1603564538\",\"prepayid\":\"wx1913455870075513f12bcae636ea1a0000\",\"package\":\"Sign=WXPay\",\"noncestr\":\"j68chb3swyj08ln701sjgab6tamrguf9\",\"timestamp\":\"1637300758\",\"sign\":\"DACDF1694BC7991FDFF75AF8DFE07518\"}",
"payUrl":null,
"payMethod":"02",
"bizOrderNo":"0133520350031018",
"tradeNo":"621550336221429760"
},
"time":1637300758843,
"msg":"操作成功",
"annex":null,
"success":true
}5.8 园区个人消费订单
接口地址：https://pai.flyrise.cn/pay-gateway-api/wallet/order/consume
请求方式：POST
请求数据类型：application/json
接口参数：
{
"amount": 1,//金额（单位为分）
"bizOrderNo": "6866637844044058625", //雪花算法生成id
"payeeId": "1309331342693109760", //收款人id
"payerId": "1309331342667943936", //付款人id
"goodsName": "商品1637133022184",
"walletId": "1420583628445790209", //钱包id
"orderType": "1", //订单类型;1：消费订单，2：退款订单，3：提现订单，4：充值订单，5：转账订单
"fee":0,
"parkId": "1309331342667943937",
"payMethod": "05", //支付方式;01:网银，02:微信扫码，03：支付宝扫码，04：微信小程序，99其他,05为钱包支付
"source": 2, // 访问终端类型 1 mobile 2 PC
"sign": "85CD5F825DB835111B1A02B5DB47799AB46D6958", //见PS.2中sign生成方法
"validTime": 30
}返回结果：
{
"code":"200",
"data":{
"payInfo":null,
"payUrl":null,
"payMethod":"05",
"bizOrderNo":"6866645265302949888",
"tradeNo":"1460879626915094529"
},
"time":1637135824424,
"msg":"操作成功",
"annex":null,
"success":true
}5.9 园区个人消费订单密码确认
接口地址：https://pai.flyrise.cn/pay-gateway-api/wallet/order/payByPwd
请求方式：POST
请求数据类型：application/x-www-form-urlencoded
接口参数：
parkId=1309331342667943937&orderNo=1309331342667943936&password=1309331342667943936返回结果：
{
{
"code": "200",
"data": {
"amount": 0,
"bizOrderNo": "6866645265302949888",
"buyerBizUserId": "",
"orderNo": "1460879626915094529",
"payDatetime": "",
"status": ""
},
"time":1637135824424,
"msg":"操作成功",
"annex":null,
"success":true
}5.10 园区个人消费免密码确认
接口地址：https://pai.flyrise.cn/pay-gateway-api/wallet/order/payByDeviceCode
请求方式：POST
请求数据类型：application/x-www-form-urlencoded
接口参数：
parkId=1309331342667943937&orderNo=1309331342667943936&deviceCode=1309331342667943936返回结果：
{
"code": "200",
"data": {
"amount": 0,
"bizOrderNo": "6866645265302949888",
"buyerBizUserId": "",
"orderNo": "1309331342667943936",
"payDatetime": "",
"status": ""
},
"time":1637135824424,
"msg":"操作成功",
"annex":null,
"success":true
}5.11 园区个人转账订单
接口地址：https://pai.flyrise.cn/pay-gateway-api/wallet/order/transfer
请求方式：POST
请求数据类型：application/json
接口参数：
{
"amount": 1,
"backUrl": "",
"bizOrderNo": "4891651622186923",
"extendInfo": "",
"fee": 0,
"frontUrl": "",
"orderType": "5",
"parkId": "1309331342667943937",
"payeeId": "1309421702194794496",
"payerId": "1309331342693109760",
"sign": "18389C3F3BA227750883F85CD2614F7C48B57462",
"source": 1,
"summary": "",
"validTime": 30,
"walletId": "1420583628445790209"
}返回结果：
{
"code":"200",
"data":{
"payInfo":null,
"payUrl":null,
"payMethod":"05",
"bizOrderNo":"4924825871116260",
"tradeNo":null
},
"time":1637301939499,
"msg":"操作成功",
"annex":null,
"success":true
}5.12 园区个人转账订单短信确认
接口地址：https://pai.flyrise.cn/pay-gateway-api/wallet/order/payByBackSMS
请求方式：POST
请求数据类型：application/x-www-form-urlencoded
接口参数：
orderNo=4924825871116260&parkId=1309331342667943937&verificationCode=111111返回结果：
{
"code":"200",
"data":{
"payStatus":"success",
"payFailMessage":null,
"bizUserId":"1309331342693109760",
"bizOrderNo":"4924825871116260"
},
"time":1637301950496,
"msg":"操作成功",
"annex":null,
"success":true
}5.13 园区个人转账订单短信重复确认
接口地址：https://pai.flyrise.cn/pay-gateway-api/wallet/order/resendPaySMS
请求方式：POST
请求数据类型：application/x-www-form-urlencoded
接口参数：
orderNo=4924825871116260&parkId=1309331342667943937返回结果：
{
"code": "200",
"data": {
"bizOrderNo": "4924825871116260",
"orderNo": "1461576384214646786",
"phone": ""
},
"time": 1637302387162,
"msg": "操作成功",
"annex": null,
"success": true
}5.14 园区个人消费订单退单退款
接口地址：https://pai.flyrise.cn/pay-gateway-api/wallet/order/refund
请求方式：POST
请求数据类型：application/json
接口参数：
{
"amount": 1,
"backUrl": "",
"bizOrderNo": "12112121",
"bizUserId": "",
"extendInfo": "1309331342693109760",
"fee": 0,
"frontUrl": "",
"orderType": "2",
"oriBizOrderNo": "4924825871116260",
"parkId": "1309331342667943937",
"sign": "18389C3F3BA227750883F85CD2614F7C48B57462",
"source": 1,
"summary": "",
"validTime": 30
}返回结果：
{
"code":"200",
"data":{
"payInfo":null,
"payUrl":null,
"payMethod":"05",
"bizOrderNo":"4924825871116260",
"tradeNo":null
},
"time":1637301939499,
"msg":"操作成功",
"annex":null,
"success":true
}5.15 园区订单详情获取
接口地址：https://pai.flyrise.cn/pay-gateway-api/wallet/order
请求方式：GET
请求数据类型：application/x-www-form-urlencoded
接口参数：
parkId=1309331342667943937&orderNo=4924825871116260返回结果：
{
"code": "200",
"data": {
"id": "1461576384543559681",
"tenantId": "1309331342667943937",
"parkId": "1309331342667943937",
"suiteId": "cn.flyrise.pai.pay.wallet",
"payerId": "1309331342693109760",
"payerName": null,
"payeeId": "1309421702194794496",
"payeeName": null,
"bizOrderNo": "4924825871116260",
"oriOrderNo": "",
"amount": 1,
"fee": 0,
"tradeStatus": "1",
"backUrl": null,
"frontUrl": null,
"goodsNo": "",
"goodsName": "给陈冕转账: ￥ 0.01元",
"goodsDesc": "",
"appId": "2021001166627183",
"openId": "",
"walletId": "1420583628445790209",
"payChannel": "3",
"payMethod": "05",
"orderType": "5",
"source": 1,
"summary": "",
"approvalStatue": 99,
"payStatus": "1",
"payOnline": "1",
"payTime": "2021-11-19T06:05:51.000+0000",
"businessTime": "2021-11-19T06:05:39.000+0000",
"notifyStatus": "1",
"tradeTime": "2021-11-19T06:05:51.000+0000",
"tradeNo": null,
"failMessage": null,
"isDeleted": 0,
"status": 0,
"createBy": "1309331342693109760",
"createTime": "2021-11-19T06:05:40.000+0000",
"updateBy": "1309331342693109760",
"updateTime": "2021-11-19T06:05:51.000+0000"
},
"time": 1637302480359,
"msg": "操作成功",
"annex": null,
"success": true
}PS:
1.订单状态
| Code | Message |
|---|---|
| P01 | 待支付 |
| P02 | 支付中 |
| P03 | 支付成功 |
| P04 | 支付失败 |
| P05 | 已关闭 |
2.内部feign调用（以及钱包接口sign方法）
引用下面的包:
<dependency>
<groupId>cn.flyrise</groupId>
<artifactId>pai-pay-common</artifactId>
<version>1.3.25</version>
</dependency>具体的开放的内容接口跟文档外部接口名称是对应的
sign生成方法（钱包使用：充值、消费、退款、转账）：
consumeOrderVO.setSign(SignUtil.generatePaySign(consumeOrderVO));
3.钱包流程参考
4.订单状态通过MQ获取
4.1开发者后台订阅套件
4.2开发者后端配置订阅
参考：消息订阅能力
对象
public class PayOrderNotifyVO implements Serializable {
private static final long serialVersionUID = 1L;
/**
* 园区ID
*/
@NotNull(message = "园区ID不能为空")
@ApiModelProperty("园区ID")
private String parkID;
@ApiModelProperty("业务编号")
private String bizOrderId;
/**
* 订单编号
*/
@NotNull(message = "订单编号不能为空")
@ApiModelProperty("订单编号")
private String bizOrderNo;
@ApiModelProperty("原订单编号")
private String oriBizOrderNo;
/**
* 订单类型;1：消费订单，2：退款订单，3：提现订单，4：充值订单，5：转账订单
*/
@ApiModelProperty("订单类型")
private String orderType;
/**
* 支付方式;01:网银，02:微信扫码，03：支付宝扫码，04：微信小程序05：余额支付
*/
@ApiModelProperty("支付方式")
private String payMethod = "01";
/**
* 交易状态;0、交易中，1、交易成功，2、交易失败
*/
@NotNull(message = "交易状态不能为空")
@ApiModelProperty("交易状态;0、交易中，1、交易成功，2、交易失败")
private String tradeStatus;
/**
* 交易失败原因
*/
@ApiModelProperty("交易失败原因")
private String failMessage;
/**
* 支付状态; 0:等待支付,1:支付成功,2:支付失败,3:支付处理中,4:其他支付
*/
@NotNull(message = "支付状态不能为空")
@ApiModelProperty("支付状态; 0:等待支付,1:支付成功,2:支付失败,3:支付处理中,4:其他支付")
private String payStatus;
/**
* 支付时间
*/
@ApiModelProperty("支付时间")
private Date payTime;
/**
* 交易时间,支付服务请求第三方支付接口时间
*/
@ApiModelProperty("交易时间,支付服务请求第三方支付接口时间")
private Date tradeTime;
/**
* 渠道交易流水号；针对收银宝相关支付渠道返回，对应收银宝交易单号trxid字段：微信小程序支付（单、集团）;收银宝刷卡支付（单、集团）;收银宝扫码支付（单、集团，包括支付宝、微信、银联）;收银宝JS支付（单、集团，包括支付宝、微信、QQ钱包、银联）
*/
@ApiModelProperty("渠道交易流水号；针对收银宝相关支付渠道返回，对应收银宝交易单号trxid字段：微信小程序支付（单、集团）;收银宝刷卡支付（单、集团）;收银宝扫码支付（单、集团，包括支付宝、微信、银联）;收银宝JS支付（单、集团，包括支付宝、微信、QQ钱包、银联）")
private String tradeNo;
public String getOriBizOrderNo() {
return oriBizOrderNo;
}
public void setOriBizOrderNo(String oriBizOrderNo) {
this.oriBizOrderNo = oriBizOrderNo;
}
public String getOrderType() {
return orderType;
}
public void setOrderType(String orderType) {
this.orderType = orderType;
}
public String getPayMethod() {
return payMethod;
}
public void setPayMethod(String payMethod) {
this.payMethod = payMethod;
}
public String getParkID() {
return parkID;
}
public void setParkID(String parkID) {
this.parkID = parkID;
}
public String getBizOrderNo() {
return bizOrderNo;
}
public void setBizOrderNo(String bizOrderNo) {
this.bizOrderNo = bizOrderNo;
}
public String getTradeStatus() {
return tradeStatus;
}
public void setTradeStatus(String tradeStatus) {
this.tradeStatus = tradeStatus;
}
public String getFailMessage() {
return failMessage;
}
public void setFailMessage(String failMessage) {
this.failMessage = failMessage;
}
public String getPayStatus() {
return payStatus;
}
public void setPayStatus(String payStatus) {
this.payStatus = payStatus;
}
public Date getPayTime() {
return payTime;
}
public void setPayTime(Date payTime) {
this.payTime = payTime;
}
public Date getTradeTime() {
return tradeTime;
}
public void setTradeTime(Date tradeTime) {
this.tradeTime = tradeTime;
}
public String getTradeNo() {
return tradeNo;
}
public void setTradeNo(String tradeNo) {
this.tradeNo = tradeNo;
}
public String getBizOrderId() {
return bizOrderId;
}
public void setBizOrderId(String bizOrderId) {
this.bizOrderId = bizOrderId;
}
}
文档更新时间: 2022-12-16 17:26 作者：曾小虎
