自定义支付接入操作说明

云业务管理系统（国际版）

自定义支付接入操作说明

最后更新时间：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=_QlH5UGAp4bpcxiCyWVHYA&expires=1714153918)

![](https://upload.apayun.com/2019/05/5cefcd03b90d3.png?token=ERj7SE7bOK9hfp-sU-rovw&expires=1714153918)
 
**第二步**
 
创建的支付方式类需要继承libs/Niaoyun/Payment/PayInterface/Ipay.class.php接口并实现里面的pay()方法  (Ipay.class.php接口默认存在)
 
Ipay.class.php:

![](https://upload.apayun.com/2019/05/5cefce6100418.png?token=smodk6pCRkXMeY2woQjIlA&expires=1714153918)
 
Aapay.class.php
 
![](https://upload.apayun.com/2019/05/5cefcde2907bb.png?token=QoJ4EeM8QfMNIeyTHNMs3A&expires=1714153918)
 
pay方法接收一个数组参数$parameters格式如下:

|字段	|类型|	描述|
| ------------ | ------------ | ------------ |
|total_fee|	Float|	付款金额|
|out_trad_no|	String	|订单系统唯一订单号|
|body|	String	|订单名称|

**第三步**
 
Aapay.class.php 实现的pay方法实现你自己的支付方式返回结果格式分为两种如下:
 
**第一种：** 支付方式是类似微信扫码支付，并且返回的地址需要使用js去生成二维码，则需要返回如下结果:

```
[
'code'=>200,  //200表示成功,201 表示失败	
'code_url'=>$code_rul, //支付方式返回的是二维码数据，并需要使用js生成二维码的则用code_url字段，用于 iframe 页面（生成二维码的js平台已集成，不用另外开发）
'msg'=>'success'  //成功success，失败fail
 ]
 ```
 
**第二种：** 支付方式是类似支付宝的页面跳转,则需要返回如下结果:

```
 [
 'code'=>200,  //200表示成功,201 表示失败	
 'html_text'=>$html_text, //返回的是跳转链接则用html_text字段，用于新窗口打开的页面
 'msg'=>'success'  //成功success，失败fail
 ]
```

**第三种：** 支付方式是类似微信扫码支付，并且返回的地址是已生成好的二维码地址，则需要返回如下结果:

```
 [
 'code'=>200,  //200表示成功,201 表示失败	
 'qrcode_url'=>$qrcode_url, //返回的是已经生成好的二维码地址，则用qrcode_url字段，，用于 iframe 页面
 'msg'=>'success'  //成功success，失败fail
 ]
```
Pass：两者返回的字段名不一样
 
 **返回给前端的内容**
 用于二维码支付，根据type类型判断是否需要js生成二维码
 
 ```
 {
    "result":true,
    "total_fee":"10.00",  //价格
    "type":"2",       //0:代表qrcodeUrl字段需要js生成二维码；1：新窗口打开；2：qrcodeUrl字段为已经生成好的二维码
    "qrcodeUrl":"http://qrcodeUrl.test.com/xxxx",   //二维码地址
    "orderNo":"123456789"  //订单编号
}
 ```
 
 
#### 回调部分

**第一步**

在 app\ApiNotify\Controller\ 下创建回调php文件，比如：Aapay，则创建AapayNotifyController.class.php，继承并实现 app\ApiNotify\controller\PaymentNotifyController
.class.php 中的 checkSign 和 getPayStatus 这两个方法
 
![](https://upload.apayun.com/2019/05/5cefcdb426838.png?token=NOLwW3A4OKmNzcXotXV9Iw&expires=1714153918)
 
**第二步**
 
支付回调成功地址：`http://您的平台域名/ApiNotify/AapayNotify/notify`
 
备注：支付方式的图标放在 public/template/user/Zkeys/PC/static/css/ucModule/finance/img/ 下面，图标名字为支付方式名和创建的对应php文件类名一样

附思维导图流程截图:
 
![](https://upload.apayun.com/2019/05/5cefcd976abd3.png?token=fLPwfZRm9MPjFSMIADTbXA&expires=1714153918)

阿帕云引擎

云引擎受控端

云引擎控制器

云引擎开放API

文档首页

云业务管理系统（国际版）

18+

1000+

30+

5+