README

您可以在 https://jpay.weidun.biz 上注册 MasJPay 账户。

要求

PHP 5.6.0 及更高版本。

Composer

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

composer require jpaypp/jpay-php

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

require_once('vendor/autoload.php');

手动安装

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

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

依赖项

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

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

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

入门

简单用法如下

\MasJPay\MasJPay::setDebug(true); //调试模式   true /false
\MasJPay\MasJPay::setApiMode('sandbox'); //环境  live 线上，sandbox 沙盒
\MasJPay\MasJPay::setClientId('10000000');   // 设置 CLIENT ID
\MasJPay\MasJPay::setApiKey('BQokikJOvBiI2HlWgH4olfQ2');    // 设置 API Key
try {
    $ch = \MasJPay\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 (\MasJPay\Error\Base $e) {
    // 捕获报错信息
    if ($e->getHttpStatus() != null) {
        header('Status: ' . $e->getHttpStatus());
        echo $e->getHttpBody();
    } else {
        echo $e->getMessage();
    }
}

文档

请参阅 https://jpay.weidun.biz/api 获取最新文档。

开发

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

brew install composer

安装依赖项

composer install

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

./vendor/bin/phpunit

或运行单个测试文件

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

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