0

0

随着更新潮流,把PHP字节小程序担保支付类也更新了!

藏色散人

藏色散人

发布时间:2021-07-16 15:23:31

|

4772人浏览过

|

来源于冯奎博客fengkui.net

转载

微信支付类更新结束,回头发现字节跳动也更新了支付,那么跟随着潮流,也把字节跳动支付类也更新了一下,新版使用最新版v1接口(担保支付简介),同时新增composer安装,便于集成框架使用(github地址

也可单独复制使用:

composer require fengkui/pay

(注:因业务需要,仅编写相关方法,尚未经过测试,仅供参考)

首先把配置文件填写完整:

// 支付相关配置
private static $config = array(
	'app_id'        => '', // App ID
	'salt'          => '', // 支付密钥值
	'notify_url'    => '', // 支付回调地址
	'thirdparty_id' => '', // 第三方平台服务商 id,非服务商模式留空
);

支付类封装相关方法:

Giiso写作机器人
Giiso写作机器人

Giiso写作机器人,让写作更简单

下载

立即学习PHP免费学习笔记(深入)”;

method 描述
createOrder 下单支付
queryOrder 订单查询
notifyOrder 订单回调验证
createRefund 订单退款
queryRefund 退款查询
settle 分账请求
querySettle 分账查询

使用方法:

 time(), // 订单编号
    'total_amount' => 1, // 订单金额(分)
    'body' => '测试商品', // 商品名称
];

$wechat = new fengkui\Pay\Bytedance($config);
$re = $wechat->createOrder($order);
die(json_encode($re)); // JSON化直接返回小程序客户端

如下代码是封装好的完整支付类文件(Bytedance.php), 可以根据自己需求随意修改,详细的使用方法后期会有文档:


 * @Date:   2020-05-13 17:02:49
 * @Last Modified by:   [FENG] <1161634940@qq.com>
 * @Last Modified time: 2021-06-15T17:06:18+08:00
 */
namespace fengkui\Pay;

use fengkui\Supports\Http;

/**
 * Bytedance 字节跳动支付
 * 小程序担保支付(V1)
 */
class Bytedance
{
    // 接口版本
    const EDITON = 'v1';

    // 统一下订单管理
    private static $ecpayUrl = 'https://developer.toutiao.com/api/apps/ecpay/';
    // 服务端预下单
    private static $createOrderUrl = 'https://developer.toutiao.com/api/apps/ecpay/v1/create_order';
    // 订单查询
    private static $queryOrderUrl = 'https://developer.toutiao.com/api/apps/ecpay/v1/query_order';
    // 退款
    private static $createRefundUrl = 'https://developer.toutiao.com/api/apps/ecpay/v1/create_refund';
    // 查询退款
    private static $queryRefundUrl = 'https://developer.toutiao.com/api/apps/ecpay/v1/query_refund';
    // 分账请求
    private static $settleUrl = 'https://developer.toutiao.com/api/apps/ecpay/v1/settle';
    // 查询分账
    private static $querySettleUrl = 'https://developer.toutiao.com/api/apps/ecpay/v1/query_settle';
    // 服务商进件
    private static $addMerchantUrl = 'https://developer.toutiao.com/api/apps/ecpay/saas/add_merchant';
    // 分账方进件
    private static $addSubMerchantUrl = 'https://developer.toutiao.com/api/apps/ecpay/saas/add_sub_merchant';

    // 支付相关配置
    private static $config = array(
        'app_id'        => '', // App ID
        'salt'          => '', // 支付密钥值
        'notify_url'    => '', // 支付回调地址
        'thirdparty_id' => '', // 第三方平台服务商 id,非服务商模式留空
    );

    /**
     * [__construct 构造函数]
     * @param [type] $config [传递支付相关配置]
     */
    public function __construct($config=NULL){
        $config && self::$config = array_merge(self::$config, $config);
    }

    /**
     * [createOrder 下单支付]
     * @param  [type] $order [description]
     * @return [type]        [description]
     * $order = array(
     *      'body'         => '', // 产品描述
     *      'total_amount' => '', // 订单金额(分)
     *      'order_sn'     => '', // 订单编号
     * );
     */
    public static function createOrder($order)
    {
        $config = self::$config;
        $params = [
            'app_id'        => $config['app_id'], // 是 小程序 AppID
            'out_order_no'  => (string)$order['order_sn'], // 是 开发者侧的订单号, 同一小程序下不可重复
            'total_amount'  => $order['total_amount'], // 是 支付价格; 接口中参数支付金额单位为[分]
            'subject'       => $order['body'], // 是 商品描述; 长度限制 128 字节,不超过 42 个汉字
            'body'          => $order['body'], // 是 商品详情
            'valid_time'    => 3600 * 2, // 是 订单过期时间(秒); 最小 15 分钟,最大两天
            // 'sign'          => '', // 是 开发者对核心字段签名, 签名方式见文档附录, 防止传输过程中出现意外
            // 'cp_extra'      => '', // 否 开发者自定义字段,回调原样回传
            // 'notify_url'    => $config['notify_url'], // 否 商户自定义回调地址
            // 'thirdparty_id' => '', // 否 第三方平台服务商 id,非服务商模式留空
            'disable_msg'   => 1, // 否 是否屏蔽担保支付的推送消息,1-屏蔽 0-非屏蔽,接入 POI 必传
            // 'msg_page'      => '', // 否 担保支付消息跳转页
            // 'store_uid'     => '', // 否 多门店模式下,门店 uid
        ];
        !empty($order['cp_extra']) && $params['cp_extra'] = $order['cp_extra'];
        !empty($config['notify_url']) && $params['notify_url'] = $config['notify_url'];
        !empty($config['thirdparty_id']) && $params['thirdparty_id'] = $config['thirdparty_id'];
        if (!empty($config['msg_page'])) {
            $params['disable_msg'] = 0;
            $params['msg_page'] = $config['msg_page'];
        }

        $params['sign'] = self::makeSign($params);
        // dump($params);die;
        $url = self::$createOrderUrl;
        $response = Http::post($url, json_encode($params));
        $result = json_decode($response, true);
        return $result;
    }

    /**
     * [queryOrder 订单查询]
     * @param  [type] $orderSn [开发者侧的订单号, 不可重复]
     * @return [type]          [description]
     */
    public static function queryOrder($orderSn)
    {
        $config = self::$config;
        $params = [
            'app_id' => $config['app_id'], // 小程序 AppID
            'out_order_no' => (string)$orderSn, // 开发者侧的订单号, 不可重复
            // 'sign' => '', // 开发者对核心字段签名, 签名方式见文档, 防止传输过程中出现意外
            // 'thirdparty_id' => '', // 服务商模式接入必传	第三方平台服务商 id,非服务商模式留空
        ];

        !empty($config['thirdparty_id']) && $params['thirdparty_id'] = $config['thirdparty_id'];
        $params['sign'] = self::makeSign($params);

        $url = self::$queryOrderUrl;
        $response = Http::post($url, json_encode($params));
        $result = json_decode($response, true);
        return $result;
    }

    /**
     * [notifyOrder 订单回调验证]
     * @return [array] [返回数组格式的notify数据]
     */
    public static function notifyOrder()
    {
        $data = $_POST; // 获取回调数据
        $config = self::$config;
        if (!$data || empty($data['msg']))
            die('暂无回调信息');

        $result = json_decode($data['msg'], true); // 进行签名验证
        // 判断签名是否正确  判断支付状态
        if ($result && $data['type']=='payment') {
            return $data;
        } else {
            return false;
        }
    }

    /**
     * [createRefund 订单退款]
     * @param  [type] $order [订单相关信息]
     * @return [type]        [description]
     * $order = array(
     *      'order_sn'     => '', // 订单编号
     *      'refund_sn'    => '', // 退款编号
     *      'total_amount' => '', // 订单金额(分)
     *      'body'         => '', // 退款原因
     * );
     */
    public static function createRefund($order)
    {
        $config = self::$config;
        $params = [
            'app_id'        => $config['app_id'], // 是	小程序 id
            'out_order_no'  => (string)$order['order_sn'], // 是	商户分配订单号,标识进行退款的订单
            'out_refund_no' => (string)$order['refund_sn'], // 是	商户分配退款号
            'refund_amount' => $order['total_amount'], // 是	退款金额,单位[分]
            'reason'        => $order['body'] ?? '用户申请退款', // 是	退款理由,长度上限 100
            // 'cp_extra'      => '', // 否	开发者自定义字段,回调原样回传
            // 'notify_url'    => '', // 否	商户自定义回调地址
            // 'sign'          => '', // 是	开发者对核心字段签名, 签名方式见文档, 防止传输过程中出现意外
            // 'thirdparty_id' => '', // 否,服务商模式接入必传	第三方平台服务商 id,非服务商模式留空
            'disable_msg'   => 1, // 否	是否屏蔽担保支付消息,1-屏蔽
            // 'msg_page'      => '', // 否	担保支付消息跳转页
            // 'all_settle'    => '', // 否	是否为分账后退款,1-分账后退款;0-分账前退款。分账后退款会扣减可提现金额,请保证余额充足
        ];

        !empty($order['cp_extra']) && $params['cp_extra'] = $order['cp_extra'];
        !empty($order['all_settle']) && $params['all_settle'] = $order['all_settle'];
        !empty($config['thirdparty_id']) && $params['thirdparty_id'] = $config['thirdparty_id'];
        if (!empty($config['msg_page'])) {
            $params['disable_msg'] = 0;
            $params['msg_page'] = $config['msg_page'];
        }

        $params['sign'] = self::makeSign($params);

        $url = self::$queryOrderUrl;
        $response = Http::post($url, json_encode($params));
        $result = json_decode($response, true);
        return $result;
    }

    /**
     * [queryRefund 退款查询]
     * @param  [type] $refundSn [开发者侧的订单号, 不可重复]
     * @return [type]           [description]
     */
    public static function queryRefund($refundSn)
    {
        $config = self::$config;
        $params = [
            'app_id' => $config['app_id'], // 小程序 AppID
            'out_refund_no' => $refundSn, // 开发者侧的退款号
            // 'sign' => '', // 开发者对核心字段签名, 签名方式见文档, 防止传输过程中出现意外
            // 'thirdparty_id' => '', // 服务商模式接入必传	第三方平台服务商 id,非服务商模式留空
        ];

        !empty($config['thirdparty_id']) && $params['thirdparty_id'] = $config['thirdparty_id'];
        $params['sign'] = self::makeSign($params);

        $url = self::$queryRefundUrl;
        $response = Http::post($url, json_encode($params));
        $result = json_decode($response, true);
        return $result;
    }

    /**
     * [notifyRefund 退款回调验证]
     * @return [array] [返回数组格式的notify数据]
     */
    public static function notifyRefund()
    {
        $data = $_POST; // 获取回调数据
        $config = self::$config;
        if (!$data || empty($data['status']))
            die('暂无回调信息');

        $result = json_decode($data['msg'], true); // 进行签名验证
        // 判断签名是否正确  判断支付状态
        if ($result && $data['status']!='FAIL') {
            return $data;
        } else {
            return false;
        }
    }

    /**
     * [settle 分账请求]
     * @param  [type] $order [分账信息]
     * @return [type]        [description]
     * $order = array(
     *      'body'         => '', // 产品描述
     *      'total_amount' => '', // 订单金额(分)
     *      'order_sn'     => '', // 订单编号
     * );
     */
    public static function settle($order)
    {
        $config = self::$config;
        $params = [
            'app_id'        => $config['app_id'], // 是 小程序 AppID
            'out_order_no'  => (string)$order['order_sn'], // 是 商户分配订单号,标识进行结算的订单
            'out_settle_no' => (string)$order['settle_sn'], // 是 开发者侧的结算号, 不可重复
            'settle_desc'   => $order['body'], // 是	结算描述,长度限制 80 个字符
            // 'cp_extra'      => '', // 否	开发者自定义字段,回调原样回传
            // 'notify_url'    => '', // 否	商户自定义回调地址
            // 'sign'          => '', // 是	开发者对核心字段签名, 签名方式见文档, 防止传输过程中出现意外
            // 'thirdparty_id' => '', // 否,服务商模式接入必传	第三方平台服务商 id,非服务商模式留空
            // 'settle_params' => '', // 否,其他分账方信息,分账分配参数 SettleParameter 数组序列化后生成的 json 格式字符串
        ];

        !empty($order['cp_extra']) && $params['cp_extra'] = $order['cp_extra'];
        !empty($order['settle_params']) && $params['settle_params'] = $order['settle_params'];
        !empty($config['thirdparty_id']) && $params['thirdparty_id'] = $config['thirdparty_id'];
        $params['sign'] = self::makeSign($params);

        $url = self::$settleUrl;
        $response = Http::post($url, json_encode($params));
        $result = json_decode($response, true);
        return $result;
    }

    /**
     * [querySettle 分账查询]
     * @param  [type] $settleSn [开发者侧的订单号, 不可重复]
     * @return [type]          [description]
     */
    public static function querySettle($settleSn)
    {
        $config = self::$config;
        $params = [
            'app_id' => $config['app_id'], // 小程序 AppID
            'out_settle_no' => $settleSn, // 开发者侧的分账号
            // 'sign' => '', // 开发者对核心字段签名, 签名方式见文档, 防止传输过程中出现意外
            // 'thirdparty_id' => '', // 服务商模式接入必传	第三方平台服务商 id,非服务商模式留空
        ];

        !empty($config['thirdparty_id']) && $params['thirdparty_id'] = $config['thirdparty_id'];
        $params['sign'] = self::makeSign($params);

        $url = self::$querySettleUrl;
        $response = Http::post($url, json_encode($params));
        $result = json_decode($response, true);
        return $result;
    }

    /**
     * [notifySettle 分账回调验证]
     * @return [array] [返回数组格式的notify数据]
     */
    public static function notifySettle()
    {
        $data = $_POST; // 获取回调数据
        $config = self::$config;
        if (!$data || empty($data['status']))
            die('暂无回调信息');

        $result = json_decode($data['msg'], true); // 进行签名验证
        // 判断签名是否正确  判断支付状态
        if ($result && $data['status']!='FAIL') {
            return $data;
        } else {
            return false;
        }
    }

    /**
     * [addMerchant 服务商进件]
     * @param [type]  $accessToken [授权码兑换接口调用凭证]
     * @param [type]  $componentId [小程序第三方平台应用]
     * @param integer $urlType     [链接类型:1-进件页面 2-账户余额页]
     */
    public static function addMerchant($accessToken, $componentId, $urlType=1)
    {
        $params = [
            'component_access_token' => $accessToken, // 是	授权码兑换接口调用凭证
            'thirdparty_component_id' => $componentId, // 是	小程序第三方平台应用 id
            'url_type' => $urlType, // 是	链接类型:1-进件页面 2-账户余额页
        ];

        $url = self::$addMerchantUrl;
        $response = Http::post($url, json_encode($params));
        $result = json_decode($response, true);
        return $result;
    }

    /**
     * [addSubMerchant 分账方进件]
     * @param [type]  $thirdpartyId [小程序第三方平台应用]
     * @param [type]  $merchantId   [商户 id,用于接入方自行标识并管理进件方。由服务商自行分配管理]
     * @param integer $urlType      [链接类型:1-进件页面 2-账户余额页]
     */
    public static function addSubMerchant($thirdpartyId, $merchantId, $urlType=1)
    {
        $params = [
            'thirdparty_id' => $thirdpartyId, // 是	小程序第三方平台应用 id
            'sub_merchant_id' => $merchantId, // 是	商户 id,用于接入方自行标识并管理进件方。由服务商自行分配管理
            'url_type' => $urlType, // 是	链接类型:1-进件页面 2-账户余额页
            // 'sign' => '', // 开发者对核心字段签名, 签名方式见文档, 防止传输过程中出现意外
        ];

        $params['sign'] = self::makeSign($params);

        $url = self::$addSubMerchantUrl;
        $response = Http::post($url, json_encode($params));
        $result = json_decode($response, true);
        return $result;
    }

    /**
     * [success 通知状态]
     */
    public static function success()
    {
        $array = ['err_no'=>0, 'err_tips'=>'success'];
        die(json_encode($array));
    }

    /**
     * [makeSign 生成秘钥]
     * @param  [type] $data [加密数据]
     * @return [type]       [description]
     */
    public static function makeSign($data) {
        $config = self::$config;
        $rList = array();
        foreach($data as $k => $v) {
            if ($k == "other_settle_params" || $k == "app_id" || $k == "sign" || $k == "thirdparty_id")
                continue;
            $value = trim(strval($v));
            $len = strlen($value);
            if ($len > 1 && substr($value, 0,1)=="\"" && substr($value,$len, $len-1)=="\"")
                $value = substr($value,1, $len-1);
            $value = trim($value);
            if ($value == "" || $value == "null")
                continue;
            array_push($rList, $value);
        }
        array_push($rList, $config['salt']);
        sort($rList, 2);
        return md5(implode('&', $rList));
    }

}
推荐学习:《PHP视频教程

相关专题

更多
Java编译相关教程合集
Java编译相关教程合集

本专题整合了Java编译相关教程,阅读专题下面的文章了解更多详细内容。

11

2026.01.21

C++多线程相关合集
C++多线程相关合集

本专题整合了C++多线程相关教程,阅读专题下面的的文章了解更多详细内容。

4

2026.01.21

无人机驾驶证报考 uom民用无人机综合管理平台官网
无人机驾驶证报考 uom民用无人机综合管理平台官网

无人机驾驶证(CAAC执照)报考需年满16周岁,初中以上学历,身体健康(矫正视力1.0以上,无严重疾病),且无犯罪记录。个人需通过民航局授权的训练机构报名,经理论(法规、原理)、模拟飞行、实操(GPS/姿态模式)及地面站训练后考试合格,通常15-25天拿证。

16

2026.01.21

Python多线程合集
Python多线程合集

本专题整合了Python多线程相关教程,阅读专题下面的文章了解更多详细内容。

1

2026.01.21

java多线程相关教程合集
java多线程相关教程合集

本专题整合了java多线程相关教程,阅读专题下面的文章了解更多详细内容。

4

2026.01.21

windows激活码分享 windows一键激活教程指南
windows激活码分享 windows一键激活教程指南

Windows 10/11一键激活可以通过PowerShell脚本或KMS工具实现永久或长期激活。最推荐的简便方法是打开PowerShell(管理员),运行 irm https://get.activated.win | iex 脚本,按提示选择数字激活(选项1)。其他方法包括使用HEU KMS Activator工具进行智能激活。

2

2026.01.21

excel表格操作技巧大全 表格制作excel教程
excel表格操作技巧大全 表格制作excel教程

Excel表格操作的核心技巧在于 熟练使用快捷键、数据处理函数及视图工具,如Ctrl+C/V(复制粘贴)、Alt+=(自动求和)、条件格式、数据验证及数据透视表。掌握这些可大幅提升数据分析与办公效率,实现快速录入、查找、筛选和汇总。

6

2026.01.21

毒蘑菇显卡测试网站入口 毒蘑菇测试官网volumeshader_bm
毒蘑菇显卡测试网站入口 毒蘑菇测试官网volumeshader_bm

毒蘑菇VOLUMESHADER_BM测试网站网址为https://toolwa.com/vsbm/,该平台基于WebGL技术通过渲染高复杂度三维分形图形评估设备图形处理能力,用户可通过拖动彩色物体观察画面流畅度判断GPU与CPU协同性能;测试兼容多种设备,但中低端手机易卡顿或崩溃,高端机型可能因发热降频影响表现,桌面端需启用独立显卡并使用支持WebGL的主流浏览器以确保准确结果

25

2026.01.21

github中文官网入口 github中文版官网网页进入
github中文官网入口 github中文版官网网页进入

github中文官网入口https://docs.github.com/zh/get-started,GitHub 是一种基于云的平台,可在其中存储、共享并与他人一起编写代码。 通过将代码存储在GitHub 上的“存储库”中,你可以: “展示或共享”你的工作。 持续“跟踪和管理”对代码的更改。

7

2026.01.21

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
PHP课程
PHP课程

共137课时 | 9万人学习

JavaScript ES5基础线上课程教学
JavaScript ES5基础线上课程教学

共6课时 | 9.1万人学习

PHP新手语法线上课程教学
PHP新手语法线上课程教学

共13课时 | 0.9万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号