PHPackages                             chenrj/glocash - 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. chenrj/glocash

ActiveLibrary[Payment Processing](/categories/payments)

chenrj/glocash
==============

glocash payment sdk

1.0(4y ago)02.7k↓33.3%MITPHP

Since Aug 18Pushed 3y ago2 watchersCompare

[ Source](https://github.com/Glocash/glocashpay-php)[ Packagist](https://packagist.org/packages/chenrj/glocash)[ RSS](/packages/chenrj-glocash/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (1)DependenciesVersions (2)Used By (0)

 GLOCASH PAY
=============

[](#-glocash-pay-)

 glocash payment SDK for PHP

###  [文档地址](https://docs.glocash.com)

[](#-文档地址-)

安装
--

[](#安装)

```
$ composer update
```

配置
--

[](#配置)

配置信息 以及实例化

```
$config = [
    'debug'=>true,//调试模式
    'sandbox'=>false,//sandbox模式
    'mchEmail'=>'商户邮箱或者商户编号',
    'apiKey'=>'商户秘钥',
];
$payment = new \glocash\Payment();
```

发起交易
----

[](#发起交易)

```
try{
    $data['REQ_INVOICE']  = 'test123'.rand(1000,9999); //订单号
    $data['REQ_APPID']  = 380; //应用ID
    $data['BIL_GOODSNAME']   = 'goods1Name×1;goods2Name×3'; //TODO 商户名称 请如实填写 否则银行结算会盘查
    $data['CUS_EMAIL']    = 'rongjiang.chen@witsion.com'; //客户邮箱
    $data['BIL_PRICE']    = '9.9'; //价格
    $data['BIL_CURRENCY'] = 'USD'; //币种
    $data['BIL_CC3DS'] = 1; //币种
    $data['URL_NOTIFY']   = 'http://www.crjblog.cn/notify.php';//异步通知地址 必须在白名单中 也可以在商户后台指定
    $data['URL_SUCCESS']   = 'http://www.crjblog.cn/return.php?status=success';//异步通知地址 必须在白名单中 也可以在商户后台指定
    $data['URL_FAILED']   = 'http://www.crjblog.cn/return.php?status=error';//异步通知地址 必须在白名单中 也可以在商户后台指定
    $result =  $payment->setChannel('C01')->create($data);
    echo ""; print_r($result); echo "";
}catch ( \glocash\PaymentException $e){
    $payment->log($e);
    //记录错误信息
    echo $e->getMessage();
}
```

发起退款
----

[](#发起退款)

```
$payment = new \glocash\Payment();
try{
    $gcid = $_GET['gcid'];
    $amount = $_GET['amount'];
    $result =  $payment->setMchEmail($config['mchEmail'])->setApiKey($config['apiKey'])->refunded($gcid,$amount);
    //接下来操做退款业务逻辑
    //更新为refunding
}catch ( \glocash\PaymentException $e){
    $payment->log($e);
    //记录错误信息
    echo $e->getMessage();
}
```

交易查询
----

[](#交易查询)

```
$payment = new \glocash\Payment();
try{
    $gcid = $_GET['gcid'];
    $list =  $payment->setMchEmail($config['mchEmail'])->setApiKey($config['apiKey'])->query($gcid);
    print_r($list);
}catch ( \glocash\PaymentException $e){
    $payment->log($e);
    //记录错误信息
    echo $e->getMessage();
}
```

异步通知
----

[](#异步通知)

```
try{
    //所有的状态更新都可以在这里操做
    $params =  $payment->setMchEmail($config['mchEmail'])->setApiKey($config['apiKey'])->notify();
    //业务逻辑查找当前订单交易情况
    if($params['PGW_NOTIFYTYPE'] == 'transaction'){
        //判断是否是unpaid 状态
        //更新状态操做

    }else if($params['PGW_NOTIFYTYPE'] == 'refunded'){
        //判断是否是paid refunding
        //处理退款信息
    }
    $payment->log('支付成功');
    echo 'success';
    //接下来操做退款业务逻辑
}catch ( \glocash\PaymentException $e){
    $payment->log($e);
    //记录错误信息
    echo $e->getMessage();
}
```

直连模式
----

[](#直连模式)

通过接入GLOCASHPAYMENT支付网关系统（下称GC网关），使商户系统获得覆盖全球的多样化收款渠道。在直连模式中，不需要跳转到信用卡支付页，直接完成支付。可快速完成接入，并实现最佳的付款体验。

```
$payment = new \glocash\Payment();
$payment = $payment->setMchEmail($config['mchEmail'])->setApiKey($config['apiKey']);
try{
    $data['REQ_INVOICE'] = 'test123'.rand(1000,9999); //订单号
    $data['REQ_APPID'] = 380; //应用ID
    $data['BIL_GOODSNAME'] = 'goods1Name×1;goods2Name×3'; //TODO 商户名称 请如实填写 否则银行结算会盘查
    $data['CUS_EMAIL'] = 'rongjiang.chen@witsion.com'; //客户邮箱
    $data['BIL_PRICE'] = '9.9'; //价格
    $data['BIL_CURRENCY'] = 'USD'; //币种
    $data['BIL_CC3DS'] = 1; //是否开启3ds 1 开启 0 不开启
    $data['BIL_IPADDR'] = '58.247.45.36'; //客户ip地址
    $data['BIL_GOODS_URL'] = 'https://www.merchant.com/goods/30'; //商品url
    $data['URL_NOTIFY'] = 'http://www.crjblog.cn/notify.php'; //异步通知地址 必须在白名单中 也可以在商户后台指定
    $data['URL_SUCCESS'] = 'http://www.crjblog.cn/return.php?status=success'; //异步通知地址 必须在白名单中 也可以在商户后台指定
    $data['URL_FAILED'] = 'http://www.crjblog.cn/return.php?status=error'; //异步通知地址 必须在白名单中 也可以在商户后台指定
    $data['BIL_CCNUMBER'] = '2223000000000007';
    $data['BIL_CCHOLDER'] = 'john smith';
    $data['BIL_CCEXPM'] = '09';
    $data['BIL_CCEXPY'] = '2024';
    $data['BIL_CCCVV2'] = '365';
    $result =  $payment->setChannel('C01')->create($data, 2);
    echo ""; print_r($result); echo "";
}catch ( \glocash\PaymentException $e){
    $payment->log($e);
    //记录错误信息
    echo $e->getMessage();
}
```

内嵌模式
----

[](#内嵌模式)

通过接入GLOCASHPAYMENT支付网关系统（下称GC网关），使商户系统获得覆盖全球的多样化收款渠道。在内嵌模式中，不需要跳转到信用卡支付页，可以直接嵌入网站页面中，让用户可以快速付款，从而提高付款率。

#### 前端代码 embed.html

[](#前端代码-embedhtml)

```
>

  glocash-iframe-test

  $(function() {
    //初始化 设置应用id和对应要嵌入的位置
    glocashPay.init(
            {
              appId: 2, //商户ID 必填
              payElement: "testFrom",//需要放入的支付表单的位置
              isToken: true, // token支付 必须是true
              buyerId: "456733211", // 买家ID
              config:{
                "card_iframe":{"style":"border: none; width: 100%;height:300px;display:none"},
              } // 设置iframe样式
            }
    );

    // 付款
    $("#sub_order").click(function () {
      glocashPay.checkout(function ({data}) {
        if (data.error) {
          console.error("创建卡信息失败:" + data.error);
          return false;
        }
        var postData = $("#place_order").serializeArray();
        if (data.token) {
          postData.push({name: 'BIL_TEMP_TOKEN', value: data.token});
        }
        if (data.bilToken) {
          postData.push({name: 'BIL_TOKEN', value: data.bilToken});
        }
        submitData(postData)
      });
    });

    // 提交数据
    function submitData(postData) {
      // 如果当前页面有其他的支付信息也可以一并提交到后台
      $.ajax({
        url: "./embed.php", //对应着你们后台的url
        type: "POST",
        data: postData,
        dataType: 'json',
        success: function (result) {
          console.log("返回参数", result);
          if (result.data.URL_CC3DS && result.data.URL_CC3DS != "") {
            //跳转到3ds页面
            window.location.href = result.data.URL_CC3DS;
          } else {
            if (result.data.BIL_STATUS && result.data.BIL_STATUS == 'paid') {
              //支付成功
              alert('paid success');
            } else {
              //支付失败
              if (result.data.REQ_ERROR) {
                alert('paid error ' + result.data.REQ_ERROR);
              }
              if (result.data.PGW_MESSAGE) {
                alert('paid error ' + result.data.PGW_MESSAGE);
              }
            }
          }
          return true;
        }
      });
    }
  });

```

#### 后端代码 embed.php

[](#后端代码-embedphp)

```
$payment = new \glocash\Payment();
$payment = $payment->setMchEmail($config['mchEmail'])->setApiKey($config['apiKey']);
try{
    $data['REQ_INVOICE'] = 'test123'.rand(1000,9999); //订单号
    $data['REQ_APPID'] = 380; //应用ID
    $data['REQ_TYPE'] = 'website'; //请求类型
    $data['BIL_GOODSNAME'] = 'goods1Name×1;goods2Name×3'; //TODO 商户名称 请如实填写 否则银行结算会盘查
    $data['CUS_EMAIL'] = 'rongjiang.chen@witsion.com'; //客户邮箱
    $data['BIL_PRICE'] = '9.9'; //价格
    $data['BIL_CURRENCY'] = 'USD'; //币种
    $data['BIL_CC3DS'] = 1; //是否开启3ds 1 开启 0 不开启
    $data['BIL_IPADDR'] = '58.247.45.36'; //客户ip地址
    $data['URL_NOTIFY'] = 'http://www.crjblog.cn/notify.php';//异步通知地址 必须在白名单中 也可以在商户后台指定
    $data['URL_SUCCESS'] = 'http://www.crjblog.cn/return.php?status=success';//异步通知地址 必须在白名单中 也可以在商户后台指定
    $data['URL_FAILED'] = 'http://www.crjblog.cn/return.php?status=error';//异步通知地址 必须在白名单中 也可以在商户后台指定
    $data['BIL_TEMP_TOKEN'] = '9fa3001597706e2c2a63cb55442b3e257b8e8d9fec629f43822f67d87d5af872'; //信用卡对应的临时TOKEN
    $result =  $payment->setChannel('C01')->create($data,3);
    echo ""; print_r($result); echo "";
}catch ( \glocash\PaymentException $e){
    $payment->log($e);
    //记录错误信息
    echo $e->getMessage();
}
```

收银台模式
-----

[](#收银台模式)

通过接入GLOCASHPAYMENT支付网关系统（下称GC网关），使商户系统获得覆盖全球的多样化收款渠道。在收银台模式中，可以根据国家，展示对应的支付方式，从而提高付款率。

```
$payment = new \glocash\Payment();
$payment = $payment->setMchEmail($config['mchEmail'])->setApiKey($config['apiKey']);
try{
    $data['REQ_INVOICE'] = 'test123'.rand(1000,9999); //订单号
    $data['REQ_APPID'] = 380; //应用ID
    $data['BIL_GOODSNAME'] = 'goods1Name×1;goods2Name×3'; //TODO 商户名称 请如实填写 否则银行结算会盘查
    $data['CUS_EMAIL'] = 'rongjiang.chen@witsion.com'; //客户邮箱
    $data['BIL_PRICE'] = '9.9'; //价格
    $data['BIL_CURRENCY'] = 'USD'; //币种
    $data['BIL_CC3DS'] = 1; //是否开启3ds 1 开启 0 不开启
    $data['BIL_IPADDR'] = '58.247.45.36'; //客户ip地址
    $data['URL_NOTIFY'] = 'http://www.crjblog.cn/notify.php'; //异步通知地址 必须在白名单中 也可以在商户后台指定
    $data['URL_SUCCESS'] = 'http://www.crjblog.cn/return.php?status=success'; //异步通知地址 必须在白名单中 也可以在商户后台指定
    $data['URL_FAILED'] = 'http://www.crjblog.cn/return.php?status=error'; //异步通知地址 必须在白名单中 也可以在商户后台指定
    $result =  $payment->setChannel('C01')->create($data,4);
    echo ""; print_r($result); echo "";
}catch ( \glocash\PaymentException $e){
    $payment->log($e);
    //记录错误信息
    echo $e->getMessage();
}
```

###  Health Score

28

—

LowBetter than 54% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity21

Limited adoption so far

Community10

Small or concentrated contributor base

Maturity50

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 62.5% 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

Unknown

Total

1

Last Release

1735d ago

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/47623621?v=4)[Glocash](/maintainers/Glocash)[@Glocash](https://github.com/Glocash)

---

Top Contributors

[![carter911](https://avatars.githubusercontent.com/u/13519736?v=4)](https://github.com/carter911 "carter911 (15 commits)")[![cablechen](https://avatars.githubusercontent.com/u/20896420?v=4)](https://github.com/cablechen "cablechen (9 commits)")

### Embed Badge

![Health badge](/badges/chenrj-glocash/health.svg)

```
[![Health](https://phpackages.com/badges/chenrj-glocash/health.svg)](https://phpackages.com/packages/chenrj-glocash)
```

###  Alternatives

[omnipay/paypal

PayPal gateway for Omnipay payment processing library

3156.8M53](/packages/omnipay-paypal)[eduardokum/laravel-boleto

Biblioteca com boletos para o laravel

626351.9k2](/packages/eduardokum-laravel-boleto)[tbbc/money-bundle

This is a Symfony bundle that integrates moneyphp/money library (Fowler pattern): https://github.com/moneyphp/money.

1961.9M](/packages/tbbc-money-bundle)[2checkout/2checkout-php

2Checkout PHP Library

83740.3k2](/packages/2checkout-2checkout-php)[smhg/sepa-qr-data

Generate QR code data for SEPA payments

61717.2k5](/packages/smhg-sepa-qr-data)[omnipay/dummy

Dummy driver for the Omnipay payment processing library

271.2M33](/packages/omnipay-dummy)

PHPackages © 2026

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