PHPackages chadpeng/laravel-ecpay - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [Payment Processing](/categories/payments) 4. / 5. chadpeng/laravel-ecpay ActiveLibrary[Payment Processing](/categories/payments) chadpeng/laravel-ecpay ====================== ecpay library for laravel 1.5(5y ago)038MITPHPPHP >=7.2 Since Jun 9Pushed 5y ago1 watchersCompare [ Source](https://github.com/ChadPeng/laravel-ecpay-package)[ Packagist](https://packagist.org/packages/chadpeng/laravel-ecpay)[ RSS](/packages/chadpeng-laravel-ecpay/feed)WikiDiscussions master Synced yesterday READMEChangelogDependencies (1)Versions (7)Used By (0) Laravel ECPay ============= [](#laravel-ecpay) Laravel ECPay 為串接綠界的非官方套件 系統需求 ---- [](#系統需求) - PHP >= 7.2 - Laravel >= 6.0 安裝 -- [](#安裝) `composer require ChadPeng/laravel-ecpay` 環境設定 ---- [](#環境設定) `php artisan vendor:publish --tag=ecpay` 這裡會將設定檔 ecpay.php 複製一份到 config 的目錄下。 ### .env 裡加入 [](#env-裡加入) ``` ECPAY_MERCHANT_ID= ECPAY_HASH_KEY= ECPAY_HASH_IV= ECPAY_INVOICE_HASH_KEY= ECPAY_INVOICE_HASH_IV= ``` 用法 -- [](#用法) ### 基本用法 [](#基本用法) - 產品資料單筆時可簡單只傳送 ItemName 及 TotalAmount ``` use ChadPeng\ECPay\Checkout; class CheckoutController extends Controller { protected $checkout; public function __construct(Checkout $checkout) { $this->checkout = $checkout; } public function sendOrder() { $formData = [ 'UserId' => 1, // 用戶ID , Optional 'ItemDescription' => '產品簡介', 'ItemName' => 'Product Name', 'TotalAmount' => '2000', 'PaymentMethod' => 'Credit', // ALL, Credit, ATM, WebATM ]; return $this->checkout->setPostData($formData)->send(); } ``` ### 需要分期付款時 [](#需要分期付款時) - 加上 withInstallment(分期期數) - 信用卡分期可用參數為:3,6,12,18,24 - ex： 3,6 範例 承上，在 return 時，加上 withInstallment 即可 ``` return $this->checkout->setPostData($formData)->withInstallment('3,6')->send(); ``` ### 定期定額扣款 [](#定期定額扣款) - 加上 withPeriodAmount($periodAmt) ##### 範例 [](#範例) ``` 承上，加上參數，帶入 withPeriodAmount 即可 ``` ``` ... $periodAmt = [ 'PeriodAmount' => 2550, 'PeriodType' => 'M', 'Frequency' => '1', 'ExecTimes' => 10, 'PeriodReturnURL' ]; return $this->checkout->setPostData($formData)->withPeriodAmount($periodAmt)->send(); ``` ### 需要開立發票時 [](#需要開立發票時) - 加上 withInvoice($invData) 即可。 - 開立發票時，產品內容必須要符合即定格式傳送，不能只帶 ItemName 及 TotalAmount - 測試開立發票時，MerchantID 請設 2000132 ##### 範例 [](#範例-1) ``` use ChadPeng\ECPay\Checkout; class CheckoutController extends Controller { protected $checkout; public function __construct(Checkout $checkout) { $this->checkout = $checkout; } public function sendOrder() { $items[0] = [ 'name' => '產品333', 'qty' => '3', 'unit' => '個', 'price' => '150' ]; $formData = [ 'itemDescription' => '產品簡介', 'items' => $items, 'paymentMethod' => 'Credit', 'userId' => 1 ]; $invData = [ 'Items' => $items, 'UserId' => 1, 'CustomerName' => 'User Name', 'CustomerAddr' => 'ABC 123', 'CustomerEmail' => 'email@address' ]; return $this->checkout->setPostData($formData)->withInvoice($invData)->send(); } ``` ### 查詢訂單 [](#查詢訂單) ``` use ChadPeng\ECPay\QueryTradeInfo; class QueryTradeController extends Controller { protected $queryTradeInfo; public function __construct(QueryTradeInfo $queryTradeInfo) { $this->queryTradeInfo = $queryTradeInfo; } public function queryInfo($orderId) { return $this->queryTradeInfo->getData($orderId)->query(); } } ``` ### 查詢發票 [](#查詢發票) ``` use ChadPeng\ECPay\QueryInvoice; class QueryInvoiceController extends Controller { protected $queryInvoice; public function __construct(QueryInvoice $queryInvoice) { $this->queryInvoice = $queryInvoice; } public function queryInvInfo($orderId) { return $this->queryInvoice->getData($orderId)->query(); } } ``` ### 開立發票 [](#開立發票) ``` use ChadPeng\ECPay\Invoice; use ChadPeng\ECPay\Constants\ECPayDonation; use ChadPeng\ECPay\Services\StringService; class InvoiceController extends Controller { public function __construct(Invoice $invoice) { $this->invoice = $invoice; } public function issueInvoice() { $itemData[] = [ 'name' => 'product name', 'qty' => 1, 'unit' => 'piece', 'price' => 5000 ]; $invData = [ 'UserId' => 1, 'Items' => $itemData, 'CustomerName' => 'User Name', 'CustomerEmail' => 'email@address.com', 'CustomerPhone' => '0912345678', 'OrderId' => StringService::identifyNumberGenerator('O'), 'Donation' => ECPayDonation::Yes, 'LoveCode' => 168001, 'Print' => 0, 'CarruerType' => 1 ]; return $this->invoice->setPostData($invData)->query(); } } ``` #### 套件中有設定和綠界溝通用的route及基本處理方法，如果要有自己的處理邏輯要用自己寫好的route，擔心和套件原設定的route衝突時 [](#套件中有設定和綠界溝通用的route及基本處理方法如果要有自己的處理邏輯要用自己寫好的route擔心和套件原設定的route衝突時) - 在 app/Http/Providers/AppServiceProvider 的 register 加入 ``` ECPay::ignoreRoutes(); ``` #### 如果要用自己傳送資料的頁面 [](#如果要用自己傳送資料的頁面) - 方法一： 在 .env 裡使用 ECPAY\_SEND\_FORM 的環境變數來指定。 - 方法二： 直接指定 ECPay::$sendForm 的值來指定。 ### 所有文件列的參數基本上都可用，參數用法請參考綠界串接文件 [](#所有文件列的參數基本上都可用參數用法請參考綠界串接文件) - 回傳參數的背景通知(ReturnURL)，套件裡有預設的網址，但只止於通知，如果要有寫入資料庫的設計，要再設計自己的回傳通知網址。 - OrderResultURL 為結帳完返回自已站台的網址，不能與 ReturnURL 相同。 ### Health Score 24 — LowBetter than 32% of packages Maintenance20 Infrequent updates — may be unmaintained Popularity7 Limited adoption so far Community7 Small or concentrated contributor base Maturity54 Maturing project, gaining track record Bus Factor1 Top contributor holds 100% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~17 days Total 6 Last Release 2077d ago ### Community Maintainers ![](https://www.gravatar.com/avatar/f26443d7ae58af6a48977189d6bfef4420426c18dc0fe18eb1f65ab6eb9d3c25?d=identicon)[chadpeng](/maintainers/chadpeng) --- Top Contributors [![ChadPeng](https://avatars.githubusercontent.com/u/36324992?v=4)](https://github.com/ChadPeng "ChadPeng (5 commits)") --- Tags laravelpaymentecpay ### Embed Badge ![Health badge](/badges/chadpeng-laravel-ecpay/health.svg) ``` [![Health](https://phpackages.com/badges/chadpeng-laravel-ecpay/health.svg)](https://phpackages.com/packages/chadpeng-laravel-ecpay) ``` ### Alternatives [tsaiyihua/laravel-ecpay ecpay library for laravel 6416.3k](/packages/tsaiyihua-laravel-ecpay)[evryn/laravel-toman A simple stable Laravel package to handle popular payment gateways in Iran including ZarinPal and IDPay. 1079.9k](/packages/evryn-laravel-toman)[tsaiyihua/laravel-linepay linepay library for laravel 102.9k](/packages/tsaiyihua-laravel-linepay) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)