thoth-pharaoh/ecpay-express

綠界物流服務

v2.0.1 2023-10-06 12:17 UTC

Requires

• php: ^8.0
• illuminate/support: >=9.0

Requires (Dev)

• orchestra/testbench: ^7.0

MIT

• Nick Zhang

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(逆物流通知)