易支付插件开发

插件文件说明

支付插件目录：/plugins/payment/{插件名}/，插件英文名与目录名一致（如 alipay），主类文件：{Name}Plugin.php（首字母大写，如 AlipayPlugin.php）。

插件元数据文件info.json，里面定义了插件标识、名称、支付方式、配置等信息。

插件元数据说明

{
    "name": "baofu", //插件标识，必须和插件目录名称一致
    "title": "宝付支付", //插件名称
    "author": "官方", //插件作者，可空
    "link": "https://www.baofu.com/", //插件链接，可空
    "version": "1.0", //插件版本号
    "icon": "baofu.png", //插件小图标，可为http开头的url，可空
    "desc": "", //插件简介，可空
    "pay_types": ["alipay","wxpay","bank"], //插件包含的支付方式
    "trans_types": ["bank"], //插件包含的转账方式，可空
    "inputs": { //插件密钥配置的输入框，支持input、textarea、select、radio、upload输入框类型
        "appid": {
            "name": "商户号",
            "type": "input",
            "required": true,
            "note": ""
        },
        "appurl": {
            "name": "终端号",
            "type": "input",
            "required": true,
            "note": ""
        },
        "pfx_cert_path": {
            "name": "商户私钥证书",
            "type": "upload",
            "accept": ".pfx",
            "required": true,
            "note": ".pfx格式证书"
        },
        "appkey": {
            "name": "商户私钥证书密码",
            "type": "input",
            "required": true,
            "note": ""
        }
    },
    "select": null, //选择可用的支付方式，可空
    "note": "", //配置密钥页面说明，可空
    "bindwxmp": true, //是否允许绑定微信公众号
    "bindwxa": true //是否允许绑定微信小程序
}

插件代码开发说明

• 插件主类继承自app\common\BasePayment，父类有支付通道密钥变量$channel，可在插件内直接使用。

• public的方法可以直接通过地址栏访问，所有需要访问的插件方法都只有1个支付上下文入参PaymentContext $ctx，访问规则如下：

  http://你的域名/pay/方法名称/订单号/

  跳转支付接口的入口方法是submit，API接口支付的入口方法是mapi，这2个方法名称是系统固定的，submit方法不能没有，mapi方法可以没有。

  剩余的方法可以自行实现具体的支付、回调等页面。

• 支付上下文app\common\PaymentContext，属性有order、ordername、method、isMobile、mdevice

• 退款、查单接口只有一个订单信息入参$order

• 上传的证书，需要使用getCertFilePath方法获取证书文件路径。

插件方法返回值说明

返回值格式：

注：以上的“页面文件名称”，均为/public/template/pay/default/目录下的文件名，不包含后缀名。

旧版支付插件迁移说明

（可将下面的内容复制到md文件，放到项目根目录下，然后让AI Agent根据说明完成迁移）

• 新版支付插件目录：plugins/payment/{插件名}/，插件英文名与目录名一致（如 alipay），主类文件：{Name}Plugin.php（首字母大写，如 AlipayPlugin.php）。
• 旧版插件的元信息public static $info移动到插件同目录下 info.json，根据note说明判断若有需要手动上传的证书文件，全部改到inputs下的upload类型的字段，代码中使用getCertFilePath方法获取证书文件路径。
• 插件主类继承自app\common\BasePayment
• 插件父类BasePayment构造方法已经传入支付插件密钥参数$channel。若插件内有 require(PAY_ROOT.'inc/config.php')代码，改为在构造方法中根据 $channel 生成本插件所需配置数组（如 $this->alipayConfig）
• 禁止require或include其他文件，全部采用命名空间的方式引入其他类。
• 插件方法全部改用非静态方法。
• 支付、回调、应用网关等方法的入参为支付上下文app\common\PaymentContext，属性有order、ordername、method、isMobile、mdevice。插件方法内禁止使用global获取全局变量，改为从支付上下文获取；订单号常量TRADE_NO改成支付上下文中的$ctx->order['trade_no']；$conf变量改成用系统方法config_get()获取；$siteurl变量改成request()->siteurl；$clientip变量改成request()->clientip；$submit2变量改成defined('SUMBIT2')
• 插件中判断浏览器UA的代码统一修改，checkmobile()改成$ctx->isMobile，checkwechat()改成$ctx->mdevice==='wechat'，checkalipay()改成$ctx->mdevice==='alipay'，checkmobbileqq()改成$ctx->mdevice==='qq'，checkunionpay()改成$ctx->mdevice==='unionpay'，checkdouyin()改成$ctx->mdevice==='douyin'
• 退款、关闭订单方法的入参和原先一样，方法内删除if(empty($order))exit();判断代码。
• 转账方法的入参删除channel，方法内删除if(empty($channel) || empty($bizParam))exit();判断代码
• processNotify、processReturn、processTransfer、processProfitSharing改成调用父类的同名方法，processReturn方法调用前面加上return返回
• 原先调用\lib\Payment的lockPayData、updateOrder、updateOrderExt、updateOrderCombine、getSubOrders、processSubOrders、refundSubOrder、updateSubOrderSettle全部改成调用父类的同名方法
• ok方法删除
• 插件内用exit输出json的代码，改成return ['type' => 'json', 'data' =>原json数组]
• 插件方法代码内，命名空间\lib\替换成\app\lib，\lib\ProfitSharing\CommUtil替换成\app\logic\ProfitSharingLogic
• alipay_oauth、wechat_applet_oauth、alipay_mini_oauth公共方法均增加了第1个入参trade_no；alipaymini_jump_scheme、wxminipay_jump_path第1个参数改成了order数组；wxminipay_jump_scheme第2个参数改成了order数组
• 禁止直接使用 $_GET、$_POST，统一使用ThinkPHP的request方法：
  • request()->get('参数名') 或 request()->get('参数名', '默认值')
  • request()->post('参数名') 或 request()->post('参数名', '默认值')
  • request()->get() 或 request()->post()用于获取GET或POST数组
• 禁止直接使用$_SESSION，使用ThinkPHP的session方法：
  • 读取：session('key')
  • 写入：session('key', $value)
  • 判断存在：session('?key')
• 涉及数据库查询的$DB全局变量，都改成用ThinkPHP的查询构造器
• 新版插件代码需符合PHP8规范。