chowjiawei / tiktok-pay
tiktok 抖音-新交易系统 -泛知识 、非泛知识 支付系统
v1.0.0
2023-01-16 09:21 UTC
Requires
- php: ^7.0|^8.0
- ext-json: *
- ext-openssl: *
- guzzlehttp/guzzle: ^6.3|^7.0
- laravel/framework: ^6.0|^7.0|^8.0|^9.0
Requires (Dev)
This package is auto-updated.
Last update: 2024-10-19 06:42:49 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='失败原因,可省略');