PHPackages jetfueltw/biwpay-php - 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. jetfueltw/biwpay-php AbandonedArchivedLibrary[Payment Processing](/categories/payments) jetfueltw/biwpay-php ==================== biwpay payment gateway php package v1.0.1(8y ago)0173Apache-2.0PHPPHP >=5.6.4 Since Jan 30Pushed 8y agoCompare [ Source](https://github.com/jetfueltw/biwpay-php)[ Packagist](https://packagist.org/packages/jetfueltw/biwpay-php)[ RSS](/packages/jetfueltw-biwpay-php/feed)WikiDiscussions master Synced today READMEChangelog (2)Dependencies (3)Versions (3)Used By (0) 介紹 -- [](#介紹) 全球付 PHP 版本封裝。 安裝 -- [](#安裝) 使用 Composer 安裝。 ``` composer require jetfueltw/biwpay-php ``` 使用方法 ---- [](#使用方法) ### 掃碼支付下單 [](#掃碼支付下單) 使用微信支付、QQ錢包、支付寶掃碼支付，下單後返回支付網址，請自行轉為 QR Code。 ``` $merchantId = 'XXXXXXXXXXXXXXX'; // 商家號 $secretKey = 'XXXXXXXXXXXXXXX'; // MD5 密鑰 $tradeNo = '20180109023351XXXXX'; // 商家產生的唯一訂單號 $channel = Channel::WECHAT; // 支付通道，支援微信支付、QQ錢包、支付寶 $amount = 1.00; // 消費金額 (元) $notifyUrl = 'https://XXX.XXX.XXX'; // 交易完成後異步通知接口 $returnUrl = 'https://XXX.XXX.XXX'; // 交易完成後會跳轉到這個頁面 ``` ``` $payment = new DigitalPayment(merchantId, secretKey); $result = $payment->order($tradeNo, $channel, $amount, $notifyUrl, $returnUrl); ``` ``` Result: [ 'mer_no' => 'XXXXXXXXXXXXXXX'; // 商家號 'mer_order_no' => '20180109023351XXXXX'; // 商家產生的唯一訂單號 'order_no' => 'XXXXXXXXXXXXX'; // 平台訂單號 'auth_result' => 'SUCCESS'; // 回應成功 'trade_result' => 'X'; //0 未支付；1 支付成功 2 支付失敗；3 預支付成功 'error_msg' =>'XXXXXXXXXX'; //返回錯誤信息 'trade_return_msg' =>'XXXXXXX', // auth_result=SUCCESS 並且 trade_result=3將會返回對應二維碼url 'mer_return_msg' => 'XXXXXXXXXX'; //商户返回信息说明 'sign_type' => 'MD5'; // 'sign' = > 'XXXXXXXXXXXXXXXXXXXXXXXXXX'; //簽名 ]; ``` ### 掃碼支付交易成功通知 [](#掃碼支付交易成功通知) 消費者支付成功後，平台會發出 HTTP POST 請求到你下單時填的 $notifyUrl，商家在收到通知並處理完後必須回應 `SUCCESS`。 - 商家必需正確處理重複通知的情況。 - 能使用 `NotifyWebhook@successNotifyResponse` 返回成功回應。 - 務必使用 `NotifyWebhook@verifyNotifyPayload` 驗證簽證是否正確。 - 通知的消費金額單位為 `元`。 ``` Post Data: [ 'trade_result' => 'X'; // 交易結果; 0 未支付 1 支付成功 'mer_no' => 'XXXXXXXXXXXXXXX'; // 商家號 'mer_return_msg' => 'XXXXXXXX'; // 商戶返回信息說明 'mer_order_no' => '20180109023351XXXXX'; // 商家產生的唯一訂單號 'notify_type' => 'back_notify'; // 通知類型 'currency' => 1; //幣種 'trade_amount' => '1.00'; //交易金額 單位為元 'order_date' => '2018-01-16 20:13:29'; // 訂單時間 'pay_date' => '2018-01-16 22:13:29'; // 支付時間 'order_no' => 'XXXXXXX'; //支付訂單號 'sign_type' => 'MD5'; //簽名類型 'sign' => 'XXXXXXXXXXXXXXXXXXXXXX'; //簽名 ] ``` ### 掃碼支付訂單查詢 [](#掃碼支付訂單查詢) 使用商家訂單號查詢單筆訂單狀態。 ``` $merchantId = 'XXXXXXXXXXXXXXX'; // 商家號 $secretKey = 'XXXXXXXXXXXXXXX'; // MD5 密鑰 $tradeNo = '20180109023351XXXXX'; // 商家產生的唯一訂單號 ``` ``` $tradeQuery = new TradeQuery(merchantId, secretKey); $result = $tradeQuery->find($tradeNo); ``` ``` Result: [ 'auth_result' => 'SUCCESS'; // 請求驗證結果:SUCCESS：成功，其他，失敗 'trade_result' => 'X'; // 0 未支付 1 支付成功 'error_msg' => 'XXXXXXXXXXX'; // 錯誤訊息 'mer_no' => 'XXXXXXXXXXXXXXX'; // 商家號 'mer_order_no' => '20180109023351XXXXX'; // 商家訂單號 'order_no' => 'XXXXXXX'; // 平台訂單號 'trade_amount' => '1.00'; // 交易金額 單位為元 'pay_date' => '2018-01-16 22:13:29'; // 支付時間 'sign' => 'XXXXXXXXXXXXXXXXXX'; //簽名 'sign_type' => 'MD5'; //簽名類型 ] ``` ### 掃碼支付訂單支付成功查詢 [](#掃碼支付訂單支付成功查詢) 使用商家訂單號查詢單筆訂單是否支付成功。 ``` $merchantId = 'XXXXXXXXXXXXXXX'; // 商家號 $secretKey = 'XXXXXXXXXXXXXXX'; // MD5 密鑰 $tradeNo = '20180109023351XXXXX'; // 商家產生的唯一訂單號 ``` ``` $tradeQuery = new TradeQuery($merchantId, $secretKey); $result = $tradeQuery->isPaid($tradeNo); ``` ``` Result: bool(true|false) ``` 網銀支付下單 ------ [](#網銀支付下單) 使用網路銀行支付，下單後返回跳轉頁面，請 render 到客戶端。 ``` $merchantId = 'XXXXXXXXXXXXXXX'; // 商家號 $secretKey = 'XXXXXXXXXXXXXXX'; // MD5 密鑰 $tradeNo = '20180109023351XXXXX'; // 商家產生的唯一訂單號 $bank = Bank::ABC; // 銀行編號 $amount = 1.00; // 消費金額 (元) $notifyUrl = 'https://XXX.XXX.XXX'; // 交易完成後異步通知接口 $returnUrl = 'https://XXX.XXX.XXX'; // 交易完成後會跳轉到這個頁面 ``` ``` $payment = new BankPayment($merchantId, $secretKey); $result = $payment->order($tradeNo, $bank, $amount, $notifyUrl, $returnUrl); ``` ``` Result: 跳轉用的 HTML，請 render 到客戶端 ``` ### 網銀支付交易成功通知 [](#網銀支付交易成功通知) 同掃碼支付交易成功通知 ### 網銀支付訂單查詢 [](#網銀支付訂單查詢) 同掃碼支付訂單查詢 ### 網銀支付訂單支付成功查詢 [](#網銀支付訂單支付成功查詢) 同掃碼支付訂單支付成功查詢 ### Health Score 26 — LowBetter than 43% of packages Maintenance20 Infrequent updates — may be unmaintained Popularity10 Limited adoption so far Community2 Small or concentrated contributor base Maturity59 Maturing project, gaining track record 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 ~0 days Total 2 Last Release 3023d ago ### Community Maintainers ![](https://www.gravatar.com/avatar/aa9065d63339291715229f25e9b12f521dfe56ba9062a3601e963a668e15ea52?d=identicon)[jetfueltw](/maintainers/jetfueltw) --- Tags paymentpayment gateway ### Code Quality TestsPHPUnit ### Embed Badge ![Health badge](/badges/jetfueltw-biwpay-php/health.svg) ``` [![Health](https://phpackages.com/badges/jetfueltw-biwpay-php/health.svg)](https://phpackages.com/packages/jetfueltw-biwpay-php) ``` ### Alternatives [shetabit/multipay PHP Payment Gateway Integration Package 291348.2k3](/packages/shetabit-multipay) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)