Download the PHP package carllee1983/newebpay without Composer
On this page you can find all versions of the php package carllee1983/newebpay. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download carllee1983/newebpay
More information about carllee1983/newebpay
Files in carllee1983/newebpay
Package newebpay
Short Description 藍新金流 SDK - NewebPay Payment Gateway SDK for PHP
License MIT
Homepage https://github.com/CarlLee1983/newebpay
Informations about the package newebpay
藍新金流 PHP SDK
藍新金流(NewebPay)PHP SDK,提供簡潔易用的 API 整合藍新金流支付服務。
藍新金流 (NewebPay) PHP SDK
專為現代 PHP 開發者打造的藍新金流全方位整合方案
優雅的語法 • 完整的 Type Hinting • Laravel 深度整合
✨ 核心特色
- 🚀 全面支援:涵蓋信用卡、ATM、超商代碼/條碼、LINE Pay、台灣 Pay、Apple Pay 等主流支付。
- 🛡️ 安全可靠:內建完整的 AES-256-CBC 加解密驗證機制,確保交易安全。
- 💎 Laravel 整合:提供 Service Provider 與 Facades,與 Laravel 生態系完美融合。
- 📦 開箱即用:簡單直覺的 Fluent API 設計,讓參數設定變得清晰易讀。
- ✅ 品質保證:高覆蓋率的單元測試 (100+ tests),確保每次交易都精確無誤。
📋 系統需求與相容性
本套件支援 PHP 7.4 及以上版本,並針對各 Laravel 版本進行了最佳化:
| Laravel 版本 | PHP 最低需求 | 支援狀態 |
|---|---|---|
| Laravel 11.x | PHP 8.2+ | ✅ 完美支援 |
| Laravel 10.x | PHP 8.1+ | ✅ 完美支援 |
| Laravel 9.x | PHP 8.0+ | ✅ 完美支援 |
| Laravel 8.x | PHP 7.4+ | ✅ 完美支援 |
🚀 快速安裝
使用 Composer 即可輕鬆安裝:
📖 快速上手
我們提供兩種使用風格,您可自由選擇最適合的一種。
⚡ 風格一:Laravel Facade (推薦)
最簡潔的現代化寫法,適合 Laravel 開發者。
1. 設定環境變數 (.env)
2. 建立交易
進階用法 (指定支付方式)
🛠️ 風格二:原生 PHP 物件導向
適合非 Laravel 專案或需要細膩控制時使用。
💳 支援支付方式一覽
| 用途 | 類別 | 對應方法 | 備註 |
|---|---|---|---|
| 信用卡一次付清 | CreditPayment |
->creditCard() |
預設啟用 |
| 信用卡分期 | CreditInstallment |
->creditInstallment() |
支援 3/6/12/18/24/30 期 |
| WebATM | WebAtmPayment |
->webAtm() |
需搭配讀卡機 |
| ATM 轉帳 | AtmPayment |
->atm() |
產生虛擬帳號 |
| 超商代碼 | CvsPayment |
->cvs() |
Kiosk 操作列印 |
| 超商條碼 | BarcodePayment |
->barcode() |
手機出示條碼 |
| LINE Pay | LinePayPayment |
->linePay() |
行動支付 |
| 玉山 Wallet | EsunWalletPayment |
->esunWallet() |
電子錢包 |
| 台灣 Pay | TaiwanPayPayment |
->taiwanPay() |
行動支付 |
| BitoPay | BitoPayPayment |
->bitoPay() |
加密貨幣支付 |
| 超商取貨付款 | CvscomPayment |
->cvscom() |
物流整合 |
| Fula 付啦 | FulaPayment |
->fula() |
BNPL 先買後付 |
| TWQR | TwqrPayment |
->twqr() |
通用 QR Code |
| 全支付方式 | AllInOnePayment |
->allInOne() |
一次啟用多種選擇 |
(完整列表請參閱 Wiki 或原始碼)
🔔 處理回調 (Webhook)
當交易狀態變更時,藍新金流會通知您的伺服器。SDK 提供了優雅的封裝來驗證這些請求。
📢 事件監聽 (Events)
在 Laravel 應用程式中,您也可以透過監聽事件來處理支付結果,讓程式碼更乾淨解耦。
1. 定義監聽器
2. 註冊監聽器 (EventServiceProvider)
🧪 測試 (Testing)
我們提供了 NewebPay::fake() 讓您在測試中輕鬆模擬支付請求,無需實際發送 HTTP 請求。
🔎 交易查詢與退款
查詢訂單
信用卡退款
💻 前後端分離整合 (Vue / React)
由於藍新金流需要 Form Post 跳轉,在 SPA (Single Page Application) 中,建議由後端產生 API 回傳表單參數,前端再動態建立表單提交。
後端 (Laravel Example)
前端 (Javascript Example)
🐳 Docker 開發環境
為了確保環境一致性,我們提供了完整的 Docker 開發環境配置。
📄 授權協議
本專案採用 MIT License 開源授權,您可以安心使用於商業專案中。