盗墓笔记小说全集,玄幻小说排行榜完本,有声小说下载

云業(yè)務(wù)管理系統(tǒng)（國內(nèi)版）

自定義支付說明

最后更新時(shí)間：2023-01-17 14:11:22

#### PC端

##### 支付部分

**第一步**

在libs/Niaoyun/Payment 目錄下新建要接入的支付方式php文件,比如要接入Aapay支付則新建Aapay.class.php,若存在需要引入的SDK文件則也在該目錄下新建文件夾存放，如下Aapay支付

![](https://upload.apayun.com/2020/09/5f4db0c60fbf0.png?token=etYuig_OK2l7GOMtd_hp4g&expires=1731673315)

**第二步**

創(chuàng)建的支付方式類需要繼承l(wèi)ibs/Niaoyun/Payment/PayInterface/Ipay.class.php接口類并實(shí)現(xiàn)里面的 `pay()` 、 `getConfigAdmin()` 以及 `getConfig()` 接口 (Ipay.class.php接口默認(rèn)存在)

Ipay.class.php:

![](https://upload.apayun.com/2020/09/5f58925fcfdd3.png?token=e40KvEnH0T8D_NUJk742EQ&expires=1731673315)

Aapay.class.php

![](https://upload.apayun.com/2020/12/5fd80f63ab823.png?token=1BUJr_m-T0cpey1Ouhde3A&expires=1731673315)

其中 `getConfigAdmin` 用于獲取接口配置項(xiàng)，并展示與【平臺(tái)后臺(tái)】-【系統(tǒng)】-【全局設(shè)置】-【充值】中，便于管理員修改接口信息

支付參數(shù)配置以實(shí)際接口為準(zhǔn)，示例如下圖：

![](https://upload.apayun.com/2020/09/5f4dbc8b600b3.png?token=_8PfVt0LUVLi0vrSMJDTPA&expires=1731673315)

獲取平臺(tái)配置數(shù)據(jù)

![](https://upload.apayun.com/2020/09/5f4dbcae0a267.png?token=8E9xnibssr6cfDWWKoveeQ&expires=1731673315)

平臺(tái)參數(shù)配置位置：【后臺(tái)】-【系統(tǒng)】-【全局設(shè)置】-【充值】

![](https://upload.apayun.com/2020/09/5f4dbcc51fde9.png?token=dO6MS0wvG4wEaA-ryQ9L6A&expires=1731673315)

`getPayName` 方法為自定義支付名稱，不實(shí)現(xiàn)該方法將用默認(rèn)值。例：

![](https://upload.apayun.com/2020/12/5fd813127f37a.png?token=OMqrLSFAKnFuitt6EK3kog&expires=1731673315)

![](https://upload.apayun.com/2020/12/5fd813349d018.jpg?token=ADiBH4sQtwrPqZnmRizyHQ&expires=1731673315)

`pay` 方法接收一個(gè)數(shù)組參數(shù)$parameters格式如下:

| 字段        | 類型   | 描述               |
| ----------- | ------ | ------------------ |
| total_fee   | Float  | 付款金額           |
| out_trad_no | String | 訂單系統(tǒng)唯一訂單號(hào) |
| body        | String | 訂單名稱           |

**第三步**

Aapay.class.php 實(shí)現(xiàn)的pay方法實(shí)現(xiàn)你自己的支付方式返回結(jié)果格式分為兩種如下:

**第一種：**

支付方式是類似微信掃碼支付，并且返回的地址需要使用js去生成二維碼，則需要返回如下結(jié)果:

```php
[
    'code'=>200,  //200表示成功,201 表示失敗	
    'code_url'=>$code_rul, //支付方式返回的是二維碼數(shù)據(jù)，并需要使用js生成二維碼的則用code_url字段，用于 iframe 頁面（生成二維碼的js平臺(tái)已集成，不用另外開發(fā)）
    'msg'=>'success'  //成功success，失敗fail
 ]
```

**第二種：**

支付方式是類似支付寶的頁面跳轉(zhuǎn),則需要返回如下結(jié)果:

```php
 [
     'code'=>200,  //200表示成功,201 表示失敗	
     'html_text'=>$html_text, //返回的是跳轉(zhuǎn)鏈接則用html_text字段，用于新窗口打開的頁面
     'msg'=>'success'  //成功success，失敗fail
 ]
```

**第三種：**

支付方式是類似微信掃碼支付，并且返回的地址是已生成好的二維碼地址，則需要返回如下結(jié)果:

```php
 [
     'code'=>200,  //200表示成功,201 表示失敗	
     'qrcode_url'=>$qrcode_url, //返回的是已經(jīng)生成好的二維碼地址，則用qrcode_url字段，，用于 iframe 頁面
     'msg'=>'success'  //成功success，失敗fail
 ]
```

Pass：兩者返回的字段名不一樣

**返回給前端的內(nèi)容**
    用于二維碼支付，根據(jù)type類型判斷是否需要js生成二維碼

```json
 {
    "result":true,
    "total_fee":"10.00",  //價(jià)格
    "type":"2",       //0:代表qrcodeUrl字段需要js生成二維碼；1：新窗口打開；2：qrcodeUrl字段為已經(jīng)生成好的二維碼
    "qrcodeUrl":"http://qrcodeUrl.test.com/xxxx",   //二維碼地址
    "orderNo":"123456789"  //訂單編號(hào)
}
 ```

##### 回調(diào)部分

**第一步**

在 `app\ApiNotify\Controller\` 下創(chuàng)建回調(diào)php文件，比如：Aapay，則創(chuàng)建`AapayNotifyController.class.php`，繼承并實(shí)現(xiàn) `app\ApiNotify\controller\PaymentNotifyController`
.class.php 中的 checkSign 和 getPayStatus 這兩個(gè)方法

![](https://upload.apayun.com/2020/09/5f589229b85a6.png?token=G-oyDP1fYQUR1H83uWge5w&expires=1731673315)

![](https://upload.apayun.com/2020/10/5f8cf4e0d5f3c.png?token=vy0SEHp6m2Bgatbs1DpUpg&expires=1731673315)

![](https://upload.apayun.com/2020/10/5f8cf45fb665a.png?token=2iIFD3bnSjvFT5fuaJotzQ&expires=1731673315)

**第二步**

支付回調(diào)成功地址：`http://您的平臺(tái)域名/ApiNotify/AapayNotify/notify`

備注：

支付方式的圖標(biāo)放在 public/template/user/Zkeys/PC/static/css/ucModule/finance/img/ 下面，圖標(biāo)名字為支付方式名和創(chuàng)建的對(duì)應(yīng)php文件類名一樣

附思維導(dǎo)圖流程截圖:

![](https://upload.apayun.com/2019/05/5cefcd976abd3.png?token=Mmd5iXluY1ZzO-O31zkYww&expires=1731673315)

#### 手機(jī)版

#####  支付部分

**第一步**

在libs/Niaoyun/Payment 目錄下新建要接入的支付方式php文件,比如要接入Xunhupay支付則新建Xunhupay.class.php,若存在需要引入的SDK文件則也在該目錄下新建文件夾存放，如下Xunhupay支付

![](https://upload.apayun.com/2021/01/60063bdc65e9f.png?token=ooEz_wCHS3WD6BIMRQtbLg&expires=1731673315)

**第二步**

創(chuàng)建的支付方式類需要繼承l(wèi)ibs/Niaoyun/Payment/PayInterface/Ipay.class.php接口類并實(shí)現(xiàn)里面的 `wapPay()` 、 `getConfigAdmin()` 以及 `getConfig()` 接口 (Ipay.class.php接口默認(rèn)存在)

`getPayName()` 接口可以實(shí)現(xiàn)，實(shí)現(xiàn)則支付時(shí)候顯示為自定義名稱，否則顯示為類名

Ipay.class.php:

![](https://upload.apayun.com/2021/01/60063bc0eb94f.png?token=QlvSyqAzLQAi3Fqo8JyrWw&expires=1731673315)

Xunhupay.class.php

![](https://upload.apayun.com/2021/01/60063bb831f68.png?token=2Iwg1LbL9c76t6BiVktnQw&expires=1731673315)

未實(shí)現(xiàn)getPayName()方法，則默認(rèn)為類名

![](https://upload.apayun.com/2021/01/60063bab47062.png?token=JNN7QBEElQ74BHiS6P_FaQ&expires=1731673315)

實(shí)現(xiàn)getPayName()方法，則為自定義名稱

![](https://upload.apayun.com/2021/01/60063ba2660e0.png?token=KJMvzvDT-qyJ8Lf3xKYC8A&expires=1731673315)

其中支付參數(shù)配置如下，`configAdmin` 中的鍵必須在 `config` 中存在，如不需要在后臺(tái)配置的參數(shù)，`configAdmin` 中可以省略，如apiurl在config中存在，在`configAdmin`中不存在， `getConfigAdmin` 用于獲取接口配置項(xiàng)，并在【平臺(tái)后臺(tái)】-【系統(tǒng)】-【全局設(shè)置】-【充值】中展示，便于管理員修改接口信息

支付參數(shù)配置以實(shí)際接口為準(zhǔn)，示例如下圖：

![](https://upload.apayun.com/2021/01/60063b9a10f5f.png?token=21OJfl8I0KdW2BKL_UKUqA&expires=1731673315)

平臺(tái)參數(shù)配置位置：【后臺(tái)】-【系統(tǒng)】-【全局設(shè)置】-【充值】

![](https://upload.apayun.com/2021/01/60063b88e7834.png?token=5_TfqRZpmhXTiHz0cD15gw&expires=1731673315)

`wapPay` 方法接收一個(gè)數(shù)組參數(shù)$parameters格式如下:

**第三步**

wapPay方法實(shí)現(xiàn)你自己的支付方式，返回結(jié)果格式分為兩種如下（大多數(shù)為第一種）

第一種(也是主流的方式)：

支付方式是類似微信H5支付，**進(jìn)行URL重定向**,則需要返回如下結(jié)果:

```
 [
 'code'=>200,  //200表示成功,400 表示失敗  
 'type'=>'redirect',  
 'url'=>$url, //返回的是即將跳轉(zhuǎn)的RUL地址
 'msg'=>'success'  //成功success，失敗fail
 ]
```

偽代碼示例如下：

![](https://upload.apayun.com/2021/01/60063b7bd9ea5.png?token=KZHmSv7dK-jGfJLQ9lNDWw&expires=1731673315)

第二種：

支付方式返回的是一個(gè)html頁面:

```php
[
    'code'=>200,  //200表示成功,400 表示失敗
    'type'=> 'html', //固定類型，表示返回的是html頁面    
    'html'=>$html,//支付方式返回的是一個(gè)新的html自動(dòng)跳轉(zhuǎn)頁面
    'msg'=>'success'  //成功success，失敗fail
]
```

偽代碼示例如下：

![](https://upload.apayun.com/2021/01/60063b6cec92b.png?token=ON_9SGFFcNT9zTSEaH4r4g&expires=1731673315)

##### 回調(diào)部分

**第一步**

在 `app\ApiNotify\Controller\` 下創(chuàng)建回調(diào)php文件，比如：Xunhupay，則創(chuàng)建`XunhupayNotifyController.class.php`，繼承并實(shí)現(xiàn) `app\ApiNotify\controller\PaymentNotifyController` .class.php 中的 checkSign 和 getPayStatus 這兩個(gè)方法。這2個(gè)方法參數(shù)獲取的是` I('request.') `，如果獲取不到，請(qǐng)用其他正確方式，如$raw = file_get_contents('php://input'); （不同平臺(tái)回調(diào)方式不一樣）

![](https://upload.apayun.com/2021/01/60063b59774e6.png?token=T5OLYGJfNlHzZeXIzJHf3A&expires=1731673315)

![](https://upload.apayun.com/2021/01/60063b4c8eb28.png?token=lqGAt2bFr528xOaOQBXmpg&expires=1731673315)

![](https://upload.apayun.com/2021/01/60063b3ed9e5b.png?token=Bt97QnPEESASkJ5bgdC3YQ&expires=1731673315)

**第二步**

支付回調(diào)成功地址：`http://您的平臺(tái)域名/ApiNotify/{自定義支付類名} + Notify/notify`
如：`http://www.example.com/ApiNotify/XunhupayNotify/notify`

備注：

支付方式的圖標(biāo)放在 template\User\Zkeys\Mobile\Static\css\ucMobile\finance\img 下面，圖標(biāo)名字為支付方式名和創(chuàng)建的對(duì)應(yīng)php文件類名一樣，如Xunhupay.png。建議大小是40px * 40px

阿帕云引擎

云引擎受控端

云引擎控制器

云引擎開放API

文檔首頁

云業(yè)務(wù)管理系統(tǒng)（國內(nèi)版）

自定義支付說明

18+

1000+

30+

5+