chowjiawei/tiktok-pay

tiktok 抖音-新交易系统 -泛知识 、非泛知识 支付系统

v1.0.0 2023-01-16 09:21 UTC

This package is auto-updated.

Last update: 2024-05-19 05:49:58 UTC


README

如发现bug 请直接提issue或者直接提pr,造成的不便请谅解。

TitTok-Pay

抖音-中国 (交易系统支付接入)

JetBrains 支持的项目

非常感谢 Jetbrains 为我提供了从事这个和其他开源项目的许可。

目录

安装说明

环境要求 laravel框架适用

  • php => ^7 | ^8
  • guzzlehttp/guzzle => ^6.3"
  • laravel/framework => ~5.5|~6.0|~7.0|~8.0|~9.0

使用composer安装最新版

composer require chowjiawei/tiktok-pay

发布配置文件

  • 使用工具包请运行Artisan命令

php artisan vendor:publish --provider="Chowjiawei\TikTokPay\Providers\TikTokPayServiceProvider"

抖音新交易系统 -泛知识

tiktok-pay.php 配置文件中选项,需要配置完全才可以使用

$tikTokPay=app('TikTokPayIndustryTradingOld');

返回数据均未做处理 详情查看抖音文档  数据让各位尽情发挥
  • 查询订单
$tikTokPay->query('站内订单号,非抖音侧订单号');
  • 发起退款 (单个订单单个订单项)
$tikTokPay->refund('站内订单号,非抖音侧订单号');
  • 发起退款 (单个订单多个订单项)
        $item= [
            [
                "item_order_id" => '',
                "refund_amount" => (int)$price
            ],
            [
                "item_order_id" => '',
                "refund_amount" => (int)$price
            ],
        ];

$tikTokPay->refundByItems('站内订单号,非抖音侧订单号',$item);
  • 同意退款
$tikTokPay->agreeRefund('站内订单号,非抖音侧订单号');
  • 查询退款
$tikTokPay->queryRefund('站内订单号,非抖音侧订单号');
  • 发起分账
$tikTokPay->createSettle("站内订单号,非抖音侧订单号", "分账描述 可为空");
  • 查询分账
$tikTokPay->querySettle("站内订单号,非抖音侧订单号", "分账描述 可为空");
  • 设置回调配置

config中配置完成后 $settingData可以不传

如果需要再次自定义或者扩展更多糊掉参数 可以传详细参数 更多参数参考抖音

$settingData = [
 'create_order_callback' => "", 
 'refund_callback' => "",
 'pay_callback' => "",
 ];

$tikTokPay->setCallBackConfig(array $settingData=[]);
  • 查询回调配置
$tikTokPay->getSettingReturn();
  • 支付回调
$tikTokPay->return($request);  //控制器内 直接将接受的Request $request 传入return方法,即可自动验签,并返回接收参数

返回 `status` 正确为`true` 附带 `data`数据    错误为 `false`

如果业务处理失败 需要手动返回抖音成功

$tikTokPay->returnSuccess(); 

如果业务处理失败 需要手动返回抖音失败

$tikTokPay->returnError($result='失败原因,可省略'); 
  • 预下单回调
$tikTokPay->returnPreCallback($request);  //控制器内 直接将接受的Request $request 传入return方法,即可自动验签,并返回接收参数

如果业务处理失败 需要手动返回抖音成功

$tikTokPay->returnSuccess(); 

如果业务处理失败 需要手动返回抖音失败

$tikTokPay->returnError($result='失败原因,可省略'); 

建议将数组内数据 存起来 后续退款等操作都需要用 抖音不支持二次查询某些字段

如果需要退款 必须存储 item_order_id_list 获取如下:

$itemOrderId = json_decode($extendItem['msg'], true)['goods'][0]['item_order_id_list'][0];
  • 退款回调
$tikTokPay->refundReturn($request); 

如果业务处理失败 需要手动返回抖音成功

$tikTokPay->returnSuccess(); 

如果业务处理失败 需要手动返回抖音失败

$tikTokPay->returnError($result='失败原因,可省略'); 
  • 接收分账回调
$tikTokPay->settleCallback($request); 

如果业务处理失败 需要手动返回抖音成功

$tikTokPay->returnSuccess(); 

如果业务处理失败 需要手动返回抖音失败

$tikTokPay->returnError($result='失败原因,可省略');