Download the PHP package ycs77/laravel-newebpay without Composer
On this page you can find all versions of the php package ycs77/laravel-newebpay. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download ycs77/laravel-newebpay
More information about ycs77/laravel-newebpay
Files in ycs77/laravel-newebpay
Package laravel-newebpay
Short Description A library of connecting newebpay's API service.
License MIT
Homepage https://github.com/ycs77/laravel-newebpay
Informations about the package laravel-newebpay
Laravel NewebPay - 藍新金流
Fork from treerful/laravel-newebpay
Laravel NewebPay 為針對 Laravel 所寫的藍新金流(智付通)金流串接套件。
主要實作項目:
- NewebPay MPG - 多功能收款
- NewebPay Query - 單筆交易查詢
- NewebPay Cancel - 信用卡取消授權
- NewebPay Close - 信用卡請退款
- NewebPay Period - 信用卡定期定額委託
- NewebPay Period Alter Status - 修改委託狀態
- NewebPay Period Alter Amt - 修改委託內容
版本需求
- PHP 支援 8.1 以上
- Laravel 版本 9 以上
安裝
發布設置檔案
註冊藍新金流商店
首先先到藍新金流的網站上註冊帳號 (測試時需註冊測試帳號) 和建立商店。然後在「商店資料設定」中啟用需要使用的金流功能 (測試時可以盡量全部啟用),並複製商店串接 API 的商店代號、HashKey
和 HashIV
。
設定 .env
的商店代號和 HashKey 等:
更多設定需開啟 config/newebpay.php
修改。
測試用帳號
測試環境僅接受以下的測試信用卡號:
- 4000-2211-1111-1111 (一次付清+分期付款)
- 4003-5511-1111-1111 (紅利折抵)
測試卡號有效月年及卡片背面末三碼,可任意填寫。
更多詳細資訊請參考藍新金流 API 文件。
MPG 多功能付款
發送付款請求頁面
首先先建立一個頁面,和一個「付款」按鈕:
routes/web.php
resources/views/pay.blade.php
Inertia.js 可以參考以下:
routes/web.php
resources/js/pages/Pay.vue
然後建立送出付款的路由:
基本上一般交易可直接在 config/newebpay.php
做設定,裡面有詳細的解說,但若遇到特殊情況,可依據個別交易設定:
付款請求回傳結果
送出付款之後當然是要建立回傳的路由,如果是信用卡之類的付款方式,可以付款後直接跳轉回本網站的,可以只設定 callback:
如果是 ATM 的付款方式,需要透過幕後回傳的,可以只設定 notify:
回傳結果可以使用各個方法來取得需要的資料:
但如果兩個同時設定的話,進行部分交易時兩個 API 都會發送訊息,這時就要各司其職,callback 只設定返回給用戶的訊息,而 notify 只負責處理交易的邏輯:
設定好之後可以在 config/newebpay.php
裡設定網址:
還要把這些路徑排除 CSRF 檢查:
app/Http/Middleware/VerifyCsrfToken.php
ATM/超商條碼/超商代碼取號
預設會直接導向到藍新金流的取號頁面,沒有特別需求不需要自己做。但如果要自訂取號頁面的話,也是可以自己客製調整:
在 config/newebpay.php
裡設定網址:
然後要把路徑排除 CSRF 檢查:
app/Http/Middleware/VerifyCsrfToken.php
單筆交易查詢
從訂單編號和該筆交易的金額來查詢交易詳情:
信用卡取消授權
在尚未請款時可以發動取消信用卡交易:
信用卡請/退款
設定信用卡請款、取消請款、退款、取消退款:
或是也可以使用同一個 API 端點來執行請/退款:
信用卡定期定額委託
發送建立委託請求頁面
首先先建立一個頁面,和一個「訂閱」按鈕:
routes/web.php
resources/views/subscribe.blade.php
Inertia.js 可以參考以下:
routes/web.php
resources/js/pages/Subscribe.vue
然後建立送出付款的路由:
建立委託請求回傳結果
設定建立委託完成後,將頁面導向回原本的網站頁面:
以及設定每期委託授權結果通知:
設定好之後可以在 config/newebpay.php
裡設定網址:
記得要把這些路徑排除 CSRF 檢查:
app/Http/Middleware/VerifyCsrfToken.php
授權週期
若於週期內需授權多次,請以建立多次委託方式執行。
設定此委託於固定天期制授權,輸入數字為間隔天數 2~999。以授權日期隔日起算,以下為每隔 40 天授權一次:
設定此委託於每週授權,輸入數字為 1~7,代表每週一至週日。以下為每週日授權一次:
設定此委託於每月授權,輸入數字為 1~31,每月的第幾天執行委託,若當月沒該日期則由該月的最後一天做為扣款日。以下為每月 20 日授權一次:
設定此委託於每年授權,輸入每年的幾月幾日執行委託。以下為每年 3 月 4 日授權一次:
授權期數
設定授權委託的期數。以下為每月 4 日授權,共授權 6 次,為期 6 個月:
立即執行十元授權
設定立即執行十元授權,以驗證信用卡:
立即執行委託金額授權
設定立即執行委託金額授權:
不檢查信用卡資訊,不授權
設定刷卡完之後,不檢查信用卡資訊,也不執行授權:
但需要設定首期授權日:
修改委託狀態
修改委託狀態需要傳入訂單編號、委託單號和委託狀態:
委託狀態可以修改成 PeriodStatus::SUSPEND
(暫停) 和 PeriodStatus::TERMINATE
(終止) 兩種狀態,設定成暫停之後還可以改成 PeriodStatus::RESTART
(啟用),但只要終止委託後就無法再次啟用了。
暫停後再次啟用的委託將於最近一期開始授權。委託暫停後再啟用總期數不變,扣款時間將向後展延至期數滿期。
修改委託內容
修改委託內容需要傳入訂單編號、委託單號,和設定要修改成的委託觸發週期和授權次數:
參考
贊助
如果我維護的套件有幫助到你,可以考慮贊助我~ 我會很感謝你~ 而且還可以顯示您的大頭貼在我的主要專案中。
License
Under the MIT LICENSE
All versions of laravel-newebpay with dependencies
guzzlehttp/guzzle Version >=7.2
illuminate/config Version >=9.0
illuminate/contracts Version >=9.0
illuminate/log Version >=9.0
illuminate/support Version >=9.0
ycs77/laravel-recover-session Version ^1.1