辰东,好看的小说,完美世界有声小说

云業(yè)務(wù)管理系統(tǒng)（國(guó)際版）

自定義支付接入操作說(shuō)明

最后更新時(shí)間：2019-06-25 11:47:26

#### 支付部分
**第一步**

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

![](https://upload.apayun.com/2019/05/5cefccfc6b100.png?token=3ATKI-OmyJDpjepXR-cn3Q&expires=1731671708)

![](https://upload.apayun.com/2019/05/5cefcd03b90d3.png?token=6-zK139AzIzTzdxu57Qo5A&expires=1731671708)
 
**第二步**
 
創(chuàng)建的支付方式類(lèi)需要繼承l(wèi)ibs/Niaoyun/Payment/PayInterface/Ipay.class.php接口并實(shí)現(xiàn)里面的pay()方法  (Ipay.class.php接口默認(rèn)存在)
 
Ipay.class.php:

![](https://upload.apayun.com/2019/05/5cefce6100418.png?token=vPxim8IfhvGVFV_JKswx2w&expires=1731671708)
 
Aapay.class.php
 
![](https://upload.apayun.com/2019/05/5cefcde2907bb.png?token=q-YROppWiiUFMG3-Uqb5Xw&expires=1731671708)
 
pay方法接收一個(gè)數(shù)組參數(shù)$parameters格式如下:

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

**第三步**
 
Aapay.class.php 實(shí)現(xiàn)的pay方法實(shí)現(xiàn)你自己的支付方式返回結(jié)果格式分為兩種如下:
 
**第一種：** 支付方式是類(lèi)似微信掃碼支付，并且返回的地址需要使用js去生成二維碼，則需要返回如下結(jié)果:

```
[
'code'=>200,  //200表示成功,201 表示失敗	
'code_url'=>$code_rul, //支付方式返回的是二維碼數(shù)據(jù)，并需要使用js生成二維碼的則用code_url字段，用于 iframe 頁(yè)面（生成二維碼的js平臺(tái)已集成，不用另外開(kāi)發(fā)）
'msg'=>'success'  //成功success，失敗fail
 ]
 ```
 
**第二種：** 支付方式是類(lèi)似支付寶的頁(yè)面跳轉(zhuǎn),則需要返回如下結(jié)果:

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

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

```
 [
 'code'=>200,  //200表示成功,201 表示失敗	
 'qrcode_url'=>$qrcode_url, //返回的是已經(jīng)生成好的二維碼地址，則用qrcode_url字段，，用于 iframe 頁(yè)面
 'msg'=>'success'  //成功success，失敗fail
 ]
```
Pass：兩者返回的字段名不一樣
 
 **返回給前端的內(nèi)容**
 用于二維碼支付，根據(jù)type類(lèi)型判斷是否需要js生成二維碼
 
 ```
 {
    "result":true,
    "total_fee":"10.00",  //價(jià)格
    "type":"2",       //0:代表qrcodeUrl字段需要js生成二維碼；1：新窗口打開(kāi)；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/2019/05/5cefcdb426838.png?token=01WSyc4irSfZ8yfm1lE2Ng&expires=1731671708)
 
**第二步**
 
支付回調(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文件類(lèi)名一樣

附思維導(dǎo)圖流程截圖:
 
![](https://upload.apayun.com/2019/05/5cefcd976abd3.png?token=NIvZwxNAkN9h8OYF08la5g&expires=1731671708)

阿帕云引擎

云引擎受控端

云引擎控制器

云引擎開(kāi)放API

文檔首頁(yè)

云業(yè)務(wù)管理系統(tǒng)（國(guó)際版）

自定義支付接入操作說(shuō)明

18+

1000+

30+

5+