README

您可以在https://www.gba.one注册GBasJPay账户。

要求

PHP 5.6.0及更高版本。

Composer

您可以通过Composer安装绑定。运行以下命令

composer require jpaypp/gbas-php

要使用绑定，请使用Composer的自动加载

require_once('vendor/autoload.php');

手动安装

如果您不希望使用Composer，您可以下载最新版本。然后，要使用绑定，请包含init.php文件。

require_once('/path/to/jpay-php/init.php');

依赖

绑定需要以下扩展才能正常工作

• curl，尽管如果您愿意，您也可以使用自己的非cURL客户端
• json
• mbstring（多字节字符串）

如果您使用Composer，这些依赖项应该会自动处理。如果您手动安装，请确保这些扩展可用。

入门

简单使用如下所示

\GBasJPay\GBasJPay::setDebug(true); //调试模式   true /false
\GBasJPay\GBasJPay::setApiMode('sandbox'); //环境  live 线上，sandbox 沙盒
\GBasJPay\GBasJPay::setClientId('10000000');   // 设置 CLIENT ID
\GBasJPay\GBasJPay::setApiKey('BQokikJOvBiI2HlWgH4olfQ2');    // 设置 API Key
try {
    $ch = \GBasJPay\Charge::create([
        'channel'   => '901',                // 支付使用的第三方支付渠道取值
        'out_order_no' => time(),  //外部订单号 ，为空时由系统生成
        'product' =>[  //商品信息
            'subject'      => '测试商品',   //商品名称
            'body'      => '测试商品',   //商品描述
            'amount'    => '1',   // 订单总金额
            'quantity'  => '1'  //商品数量
        ],
        'extra'    =>[     //扩展信息
            'mode'      => 'mweb',  //微信渠道901 ，支付模式，jsapi 微信公众号、native 扫码支付、mweb H5 支付 ,link 返回支付链接跳转
            'format'    => 'json', //返回方式 from 表单直接提交/ json 返回
        ],
        'metadata'  => '自定义数据',
        'client_ip' => '1.1.1.1',   //客户端发起支付请求的IP
        'description' => '测试数据', //订单备注说明
        'notify'=> 'https:///notify.html',   //异步通知地址
        'return'=>'https:///callback.html',  //同步地址
     ]);
    echo $ch;                                       // 输出 返回的支付凭据 Charge
} catch (\GBasJPay\Error\Base $e) {
    // 捕获报错信息
    if ($e->getHttpStatus() != null) {
        header('Status: ' . $e->getHttpStatus());
        echo $e->getHttpBody();
    } else {
        echo $e->getMessage();
    }
}

文档

请参阅https://www.gba.one/api获取最新文档。

开发

获取[Composer][composer]。例如，在Mac OS上

brew install composer

安装依赖

composer install

按上述方法安装依赖（这将解决PHPUnit），然后您可以运行测试套件

./vendor/bin/phpunit

或运行单个测试文件

./vendor/bin/phpunit tests/UtilTest.php

该方法应仅在发送任何请求到API之前调用一次。第二个和第三个参数是可选的。