PHPackages                             zacksleo/omnipay-99bill - 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. zacksleo/omnipay-99bill

ActiveLibrary[Payment Processing](/categories/payments)

zacksleo/omnipay-99bill
=======================

99bill driver for the Omnipay PHP payment processing library: 快钱支付SDK

3.0.1(6y ago)61.1k2[1 issues](https://github.com/zacksleo/omnipay-99bill/issues)MITPHP

Since Apr 3Pushed 6y ago1 watchersCompare

[ Source](https://github.com/zacksleo/omnipay-99bill)[ Packagist](https://packagist.org/packages/zacksleo/omnipay-99bill)[ RSS](/packages/zacksleo-omnipay-99bill/feed)WikiDiscussions master Synced today

READMEChangelog (5)Dependencies (2)Versions (7)Used By (0)

omnipay-99bill
==============

[](#omnipay-99bill)

99bill driver for the Omnipay PHP payment processing library: 快钱支付SDK

Quick Start 快速开始
----------------

[](#quick-start--快速开始)

[Omnipay](https://github.com/omnipay/omnipay) is a framework agnostic, multi-gateway payment processing library for PHP 5.3+. This package implements WechatPay support for Omnipay.

### Install 安装

[](#install-安装)

Omnipay is installed via [Composer](http://getcomposer.org/). To install, simply add it to your `composer.json` file:

```
$ composer require zacksleo/omnipay-99bill -vvv
```

### Purchase 发起支付

[](#purchase-发起支付)

```
/* @var \Omnipay\Bill99\Gateway $gateway */
$gateway = \Omnipay\Omnipay::create('Bill99');
$gateway->setPrivateKey('the_app_private_key'); //私钥内容
$gateway->setReturnUrl('https://www.example.com/return');
$gateway->setNotifyUrl('https://www.example.com/return');
$gateway->setMchId('merchatn-id'); //商户号
$request = $gateway->purchase([
    //支付人姓名,可以为空。
    'payerName' => '',
    //支付人联系类型，1 代表电子邮件方式；2 代表手机联系方式。可以为空。
    'payerContactType' => 1,
    //支付人联系方式，与payerContactType设置对应，payerContactType为1，则填写邮箱地址；payerContactType为2，则填写手机号码。可以为空。
    'payerContact' => '2532987@qq.com',
    //商户订单号，以下采用时间来定义订单号，商户可以根据自己订单号的定义规则来定义该值，不能为空。
    'orderId' => date('YmdHis') . mt_rand(1000, 9999),
    //订单金额，金额以“分”为单位，商户测试以1分测试即可，切勿以大金额测试。该参数必填。
    'orderAmount' => 1,
    //商品名称，可以为空。
    'productName' => 'product-name',
    //商品数量，可以为空。
    'productNum' => '',
    //商品代码，可以为空。
    'productId' => '55558888',
    //商品描述，可以为空。
    'productDesc' => '',
    //扩展字段1，商户可以传递自己需要的参数，支付完快钱会原值返回，可以为空。
    'ext1' => '',
    //扩展自段2，商户可以传递自己需要的参数，支付完快钱会原值返回，可以为空。
    'ext2' => '',
]);
/* @var \Omnipay\Bill99\Message\PurchaseResponse $response */
$response = $request->send();
$response->redirect();
exit;
```

### 处理支付回调

[](#处理支付回调)

```
/* @var \Omnipay\Bill99\Gateway $gateway */
$gateway = Omnipay::create('Bill99');
$gateway->setPrivateKey('the_app_private_key'); //私钥内容
$gateway->setReturnUrl('https://www.example.com/return');
$gateway->setNotifyUrl('https://www.example.com/return');
/**
 * 先从快钱下载好.cer文件(假设为certificate.cer)，然后使用以下命令生成pem文件，里面即为public key(certificate_publickey.pem)
 * openssl x509 -inform PEM -in certificate.cer -pubkey -noout > certificate_publickey.pem
 * @see https://stackoverflow.com/questions/28060159/how-to-extract-the-rsa-public-key-from-a-cer-and-store-it-in-a-pem-using-opens
 */
$gateway->setBill99PublicKey('99bill_publickey'); //从快钱下载并提取出的public key
/* @var $request \Omnipay\Bill99\Message\CompletePurchaseRequest */
$request = $gateway->completePurchase();
$request->setParams(array_merge($_GET));
try {
    /* @var $response \Omnipay\Bill99\Message\CompletePurchaseResponse */
    $response = $request->send();
    if ($response->isPaid()) {
        $data = $response->getData();
        /**
         * var_dump($data);
         * @todo 这里为支付成功的业务逻辑
         * $data['orderId']  订单号
         * 订单金额 $data['orderAmount']/100,
         * 快钱交易号 $data['dealId'],
         */
        /** 这里需要注意，如果同步回调和同步回调（两者均为GET）在同一处处理，
         * 需要通过一定方式区分是异步还是同步，两者返回信息不同，如用户登录状态($_SESSION[uid])
         */
        //异步回调demo，该返回值为快钱必需
        die("1$url");
        //同步回调
        // redirect跳转页面...
    } else {
       // @todo 支付失败的业务逻辑
       //异步回调demo，该返回值为快钱必需
       die("0$url");
    }
} catch (Exception $e) {
    // @todo 这里为支付异常业务逻辑
    //异步回调demo，该返回值为快钱必需
    die("0$url");
}
```

Advance Config 其他配置
-------------------

[](#advance-config--其他配置)

### 配置测试环境

[](#配置测试环境)

```
$gateway->setTestMode(true); // 测试环境
```

###  Health Score

32

—

LowBetter than 72% of packages

Maintenance17

Infrequent updates — may be unmaintained

Popularity21

Limited adoption so far

Community9

Small or concentrated contributor base

Maturity67

Established project with proven stability

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

Recently: every ~121 days

Total

6

Last Release

2478d ago

Major Versions

0.0.3 → v3.x-dev2019-07-01

### Community

Maintainers

![](https://www.gravatar.com/avatar/3e97b8a6f67b09513e345a128d73a63898ae1ec9f6a6c77234c78b3f16d305d1?d=identicon)[zacksleo](/maintainers/zacksleo)

---

Top Contributors

[![zacksleo](https://avatars.githubusercontent.com/u/3369169?v=4)](https://github.com/zacksleo "zacksleo (18 commits)")

---

Tags

99billkuaiqianomnipayomnipay-99billpayment

### Embed Badge

![Health badge](/badges/zacksleo-omnipay-99bill/health.svg)

```
[![Health](https://phpackages.com/badges/zacksleo-omnipay-99bill/health.svg)](https://phpackages.com/packages/zacksleo-omnipay-99bill)
```

###  Alternatives

[league/omnipay

Omnipay payment processing library

6.1k9.7M166](/packages/league-omnipay)[silverstripe/silverstripe-omnipay

SilverStripe Omnipay Payment Module

38106.0k15](/packages/silverstripe-silverstripe-omnipay)

PHPackages © 2026

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