PHPackages                             jetfueltw/txfpay-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/txfpay-php

AbandonedArchivedLibrary[Payment Processing](/categories/payments)

jetfueltw/txfpay-php
====================

Txfpay payment gateway php package

v1.0.8(7y ago)0111Apache-2.0PHPPHP &gt;=5.6.4

Since Apr 3Pushed 7y agoCompare

[ Source](https://github.com/jetfueltw/txfpay-php)[ Packagist](https://packagist.org/packages/jetfueltw/txfpay-php)[ RSS](/packages/jetfueltw-txfpay-php/feed)WikiDiscussions master Synced today

READMEChangelog (9)Dependencies (3)Versions (10)Used By (0)

介紹
--

[](#介紹)

同心支付 PHP 版本封裝。

安裝
--

[](#安裝)

使用 Composer 安裝。

```
composer require jetfueltw/txfpay-php

```

使用方法
----

[](#使用方法)

### 掃碼支付下單

[](#掃碼支付下單)

使用QQ錢包、銀聯掃碼支付，下單後返回支付網址，請自行轉為 QR Code。

```
$merchantId = 'XXXXXXXXXXXXXXX'; // 商家號
$secretKey = 'XXXXXXXXXXXXXXX'; // SHA 密鑰
$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:
[
    'codeUrl' =>'weixin://wxpay/bizpayurl?pr=XXXXXXX', // 支付網址
    'respCode' =>'S0001', // S0001 表示請求成功
    'respMessage' =>'XXXXX', // 如果請求失敗,會有此欄位敘述錯誤訊息
];

```

### 掃碼支付交易成功通知

[](#掃碼支付交易成功通知)

消費者支付成功後，平台會發出 HTTP POST 請求到你下單時填的 $notifyUrl，商家在收到通知並處理完後必須回應 `success`，否則平台會認為通知失敗，並且平臺會在交易產生後的 24 小時內返回支付訂單信息，返回的時間頻率會逐漸減弱，（1 分鐘、3 分鐘、5 分鐘、10 分鐘、15...）。

- 商家必需正確處理重複通知的情況。
- 能使用 `NotifyWebhook@successNotifyResponse` 返回成功回應。
- 務必使用 `NotifyWebhook@verifyNotifyPayload` 驗證簽證是否正確。
- 通知的消費金額單位為 `元`。

```
Post Data: （並非每個欄位都會回傳）
[
    'body' => 'GOODS_BODY', // 商品描述
    'buyer_email' => 'XXXXXXXXXXXXX', // 買家email
    'buyer_id' => 'XXXXXXXXXXXX', // 買家ID
    'discount' => '0.00', // 折扣
    'ext_param1' => 'XXXXXXX', // 預留
    'ext_param2' => 'XXXXXXX', // 當支付通道為支付寶、QQ等時，異步通知返回擴展字段　ext_param2，賦值為相應的通道編碼，如：ext_param2=ALIPAY
    'gmt_create' => '2018-01-16 16:13:29', // 交易創建時間
    'gmt_logistics_modify' => '2018-01-16 16:23:29', // 訂單更改時間
    'gmt_payment' => '2018-01-16 19:13:29', // 交易付款時間
    'is_success' => 'X', // 通訊狀態：T 表示成功、F 表示失敗
    'is_total_fee_adjust' => 5.00, // 總費用，預留
    'notify_id' => 'XXXXXXXX', // 通知流水號
    'notify_time' => '2018-01-16 20:13:29', // 通知時間
    'notify_type' => 'WAIT_TRIGGER',
    'order_no' => '20180109023351XXXXX', // 商户订单号
    'payment_type' => '1', // 固定值
    'price' => '0.00', // 單價，預留值
    'quantity' => '1', // 數量，預留值
    'seller_actions' => 'SEND_GOODS', // 固定值
    'seller_email' => 'XXXXXX', // 賣家 email
    'seller_id' => 'XXXXX', // 賣家 id
    'title' => 'GOODS_NAME', // 商品名稱
    'total_fee' => 1.00, // 交易金額，單位為元
    'trade_no' => 'XXXXXXXXXXXXXX', // 平台交易流水號
    'trade_status' => 'TRADE_FINISHED', // 成功狀態
    'use_coupon' => 'X', // 是否使用優惠券
    'sign' => 'XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX', // 簽名（字母大寫）
    'signType' => 'SHA', // 簽名類型
]

```

### 掃碼支付訂單查詢

[](#掃碼支付訂單查詢)

使用商家訂單號查詢單筆訂單狀態。

```
$merchantId = 'XXXXXXXXXXXXXXX'; // 商家號
$secretKey = 'XXXXXXXXXXXXXXX'; // SHA 密鑰
$tradeNo = '20180109023351XXXXX'; // 商家產生的唯一訂單號

```

```
$tradeQuery = new TradeQuery(merchantId, secretKey);
$result = $tradeQuery->find($tradeNo);

```

```
Result:
[
    'feeAmount' => 0.00, // 手續費
    'amount' => 1.00, // 交易金額，元
    'tradeNo' => 'XXXXXXXXXXXXXXX', // 平台交易號
    'subject' => 'GOODS_NAME', // 商品名稱
    'outTradeNo' => '20180109023351XXXXX', // 商家產生的唯一訂單號
    'createdTime' => '2018-01-16 16:13:29', // 訂單創建時間
    'tradeDate' => '20180116', // 交易日期
    'tradeType' => 'payment', // 交易類型：固定值，payment 表示支付
    'timestamp' => '2018-01-16 16:13:30', // 時間
    'status' => 'XXXX', // 支付狀態：wait 等待支付，completed 支付成功，failed 支付失败
    'respCode' =>'S0001', // S0001 表示請求成功
    'respMessage' =>'XXXXX', // 如果請求失敗，會有此欄位敘述錯誤訊息
]

```

### 掃碼支付訂單支付成功查詢

[](#掃碼支付訂單支付成功查詢)

使用商家訂單號查詢單筆訂單是否支付成功。

```
$merchantId = 'XXXXXXXXXXXXXXX'; // 商家號
$secretKey = 'XXXXXXXXXXXXXXX'; // SHA 密鑰
$tradeNo = '20180109023351XXXXX'; // 商家產生的唯一訂單號

```

```
$tradeQuery = new TradeQuery($merchantId, $secretKey);
$result = $tradeQuery->isPaid($tradeNo);

```

```
Result:
bool(true|false)

```

### 網銀支付下單

[](#網銀支付下單)

使用網路銀行支付，下單後返回跳轉頁面，請 render 到客戶端。

```
$merchantId = 'XXXXXXXXXXXXXXX'; // 商家號
$secretKey = 'XXXXXXXXXXXXXXX'; // SHA 密鑰
$tradeNo = '20180109023351XXXXX'; // 商家產生的唯一訂單號
$bank = Bank::CCB; // 銀行編號
$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

28

—

LowBetter than 57% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity10

Limited adoption so far

Community2

Small or concentrated contributor base

Maturity64

Established project with proven stability

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 ~10 days

Recently: every ~18 days

Total

9

Last Release

2833d 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-txfpay-php/health.svg)

```
[![Health](https://phpackages.com/badges/jetfueltw-txfpay-php/health.svg)](https://phpackages.com/packages/jetfueltw-txfpay-php)
```

###  Alternatives

[shetabit/multipay

PHP Payment Gateway Integration Package

291345.8k3](/packages/shetabit-multipay)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
