README

版本匹配

安装

使用 composer 进行安装

composer require thoth-pharaoh/ecpay-express

导出 Config

php artisan vendor:publish --tag=express-config --force

添加 .env 支付工具必要环境参数

EXPRESS_URL="https://logistics-stage.ecpay.com.tw/Express/v2/"
EXPRESS_MERCHANT_ID="2000132"
EXPRESS_HASH_KEY="5294y06JbISpM5x9"
EXPRESS_HASH_IV="v77hoKGq4kWxNNIS"
EXPRESS_VISION="1.0.0"

使用方法

首先引入门面

use Pharaoh\Express\Facades\Express;

注册物流相关路由

class RouteServiceProvider extends ServiceProvider
{
    /**
     * Define your route model bindings, pattern filters, etc.
     *
     * @return void
     */
    public function boot()
    {
        // 註冊物流相關路由
        Express::routes();
    }
}

• 生成一段测试数据（B2C）
• 获取开启物流选择页链接
• 更新临时物流订单
• 建立正式物流订单
• 建立打印运单链接
• (B2C) 7-ELEVEN 逆向物流订单
• (B2C) 全家逆向物流订单
• 宅配逆向物流订单
• 特店进行物流订单查询操作
• (B2C) 7-ELEVEN-更新出货日、门店
• (C2C)7-ELEVEN、全家、OK - 更新门店
• 取消订单(7-EVEVEN 超商 C2C)

生成一段测试数据（B2C）

$express = Express::createTestData($type);

$type 内容说明

获取开启物流选择页链接

$express = Express::createLogistics($data);

$data 内容说明(array格式)

更新临时物流订单

$express = Express::updateTempTrade($data);

$data 内容说明(array格式)

建立正式物流订单

$express = Express::createByTempTrade($tempLogisticsId);

$tempLogisticsId 内容说明

建立打印运单链接

$express = Express::createTradeDocument($data);

$data 内容说明(array格式)

(B2C) 7-ELEVEN 逆向物流订单

$express = Express::returnUniMartCVS($data);

$data 内容说明(array格式)

(B2C) 全家逆向物流订单

$express = Express::returnFamiCVS($data);

$data 内容说明(array格式)与 7-ELEVEN 逆向物流订单 相同

宅配逆向物流订单

$express = Express::returnHome($data);

$data 内容说明(array格式)

特店进行物流订单查询操作

$express = Express::queryLogisticsTradeInfo($data);

$data 内容说明(array格式)

(B2C) 7-ELEVEN-更新出货日、门店

$express = Express::updateShipmentInfo($data);

$data 内容说明(array格式)

(C2C)7-ELEVEN、全家、OK - 更新门店

$express = Express::updateStoreInfo($data);

$data 内容说明(array格式)

取消订单(7-EVEVEN 超商 C2C)

$express = Express::cancelC2COrder($data);

$data 内容说明(array格式)

物流状态通知事件

use Pharaoh\Express\Events\ServerReplyEvent;

class EventServiceProvider extends ServiceProvider
{
    ServerReplyEvent::class => [
        ServerReplyListener::class
    ]
}

物流状态通知处理任务请在项目中的 ServerReplyListener 实现type有两种 temp_trade_reply(货态通知) 及 return_trade_reply(逆向物流通知)