豫唐支付组件是为 Z-BlogPHP 系统开发的一款集成式支付接口插件，由豫唐网络开发维护。插件将支付宝官方支付、微信官方支付以及四方个人支付三种主流支付通道整合为统一的调用入口，开发者只需通过一个函数即可发起不同类型的支付订单，无需自行对接各家支付平台的 SDK 与签名逻辑。插件适用于会员充值、文章付费阅读、虚拟商品销售等需要在线收款的场景，能够帮助站点快速搭建起完整的交易闭环。

目前已集成支付：

支付宝：官方当面付、官方电脑网站支付、官方手机网站、四方接口

微信：官方 Native 支付、四方接口

注意：四方支付平台有风险，自行评估风险。

更新日志：豫唐支付组件 - 版本更新说明

支持的支付通道与适用场景

插件支持两类支付通道：

官方支付与四方个人支付。官方支付包括支付宝的电脑网站支付、手机网站支付、当面付以及微信的 Native 支付，这一类通道费率较低、稳定性好，但需要个体工商户或企业资质才能在支付宝开放平台和微信支付商户平台申请开通。

四方个人支付则面向尚未办理营业执照的个人站长，无需企业资质即可开通收款，但需要支付开户费用并承担双重费率扣费，适合金额较小、频次不高的收款场景，使用前请自行评估四方支付平台的资金与合规风险。

各通道的适用场景简要说明如下：

支付宝电脑网站支付（pagepay）：适用于 PC 端站点收款，用户在电脑浏览器中完成付款

支付宝手机网站支付（wappay）：适用于移动端站点收款，用户在手机浏览器中完成付款

支付宝当面付（f2fpay）：适用于线下扫码收款场景，个人可申请但建议少额少量使用

微信 Native 支付：适用于 PC 端站点收款，生成二维码由用户微信扫码完成付款

四方个人支付：适用于未办理营业执照的个人站长，支持支付宝与微信两种收款方式

开发者调用方式

接入豫唐支付组件已封装好所有代码，只需要直接挂接口使用即可。

发起支付时只需要操作如下代码：

$parameter = array(

    "out_trade_no" => '', //订单号，需保证唯一

    "subject" => '',     //订单标题

    "total_fee" => '',   //订单金额

    "body" => '',        //商品简介

    "show_url" => '',    //商品链接

);

$type = 支付类型id;

ytecn_payapi($parameter, $type);

支付类型编号按通道划分如下：

• 12：支付宝手机网站支付（wappay）

• 13：支付宝电脑网站支付（pagepay）

• 14：支付宝当面付（f2fpay）

• 15：支付宝四方接口

• 21：微信 Native 扫码支付

• 22：微信四方接口

插件内置三个扩展接口方便开发者自定义业务流程：

• Filter_Plugin_YtecnPayReturn_Succeed：支付成功后的同步通知处理

• Filter_Plugin_YtecnPayReturn_Failed：支付失败后的同步通知处理

• Filter_Plugin_YtecnPayNotice_Succeed：支付结果的异步通知处理

接口回调时会传入订单参数与支付类型标识，开发者可在回调函数中完成订单状态更新、积分发放、权限开通等后续业务逻辑。

交易测试与调试方法

配置页面下方提供了「交易测试」入口，无需编写代码即可验证各支付通道是否配置正确。点击对应通道的「交易测试」链接，插件会以 2 元的测试金额发起一笔真实订单，跳转到对应支付页面。若参数填写有误，支付平台会返回具体的错误码与提示信息，根据提示对照配置项排查即可。建议在正式上线前逐一测试所启用的通道，确保商户号、密钥、证书等参数完整无误。开发模式下，Z-BlogPHP 会输出详细错误信息，有助于快速定位问题。

风险提示与使用须知

使用本插件前请注意以下事项：

• 支付宝当面付虽可供个人使用，但建议仅用于少额少量收款场景，避免因高频或大额交易触发风控

• 微信 Native 支付、JSAPI 支付、H5 支付以及支付宝网站支付、手机支付均需个体工商户或企业资质才能申请

• 四方个人收款接口涉及开户费与双重费率扣费，且属于四方支付通道，资金安全与合规性需使用者自行评估

• 插件内置的二维码生成功能依赖本地 JavaScript 库，无需调用外部 API 即可生成微信支付二维码，兼顾了隐私与稳定性

使用本插件即视为已知悉上述风险并自行承担相应责任。