README

安装

修改composer.json文件，添加：

    "require": {
        "phalapi/xunhupay": "dev-master"
    },

然后再进行composer update操作。

如果要简化操作，可以直接使用composer命令进行安装：

$ composer require phalapi/xunhupay

安装好后，还需要在根目录的composer.json文件的psr-4中添加配置，以便在线接口文档可以加载扩展里面的接口。

{
    "autoload": {
        "psr-4": {
            "PhalApi\\Xunhupay\\":"vendor/phalapi/xunhupay/src",
            "App\\": "src/app"
        }
    }

}

此外，还需要把./vendor/phalapi/xunhupay/public/xunhupay_notify.php文件复制到./public目录下，以便作为支付回调入口提供给虎皮椒调用。出于安全性考虑，文件名可以自行修改，但在配置时要同步修改。

在数据库中以下创建虎皮椒订单表：

CREATE TABLE `xunhupay_order` (
      `id` int(11) NOT NULL AUTO_INCREMENT,
      `trade_order_id` varchar(32) DEFAULT '' COMMENT '商户订单号',
      `payment` varchar(20) DEFAULT NULL COMMENT '支付接口标识',
      `total_fee` decimal(18,2) DEFAULT NULL COMMENT '订单金额(元)。单位为人民币，精确到分',
      `title` varchar(128) DEFAULT NULL COMMENT '订单标题',
      `add_time` int(11) DEFAULT NULL COMMENT '当前时间戳',
      `nonce_str` varchar(32) DEFAULT NULL COMMENT '随机值',
      `plugins` varchar(128) DEFAULT NULL COMMENT '备注',
      `order_status` int(11) DEFAULT '0' COMMENT '支付状态，0待支付1已支付',
      PRIMARY KEY (`id`),
      UNIQUE KEY `trade_order_id` (`trade_order_id`)
) ENGINE=InnoDB;

配置

在./config/app.php配置中，添加以下虎皮椒支付扩展配置，并根据自己的情况修改里面的appid、appsecret、notify_url。

return array(
    // 虎皮椒支付扩展配置
    'xunhupay' => array(
        // 接口地址，一般不需要修改
        'api' => array(
            'do' => 'https://api.xunhupay.com/payment/do.html',
            'query' => 'https://api.xunhupay.com/payment/query.html',
        ),
        // 微信支付
        'wechat' => array(
            'appid' => '2147483647', // TODO 修改成你的APPID
            'appsecret' => '160130736b1ac0d54ed7abe51e44840b', // TODO 修改成你的密钥
        ),
        // 支付宝支付
        'alipay' => array(
            'appid' => '2147483647', // TODO 修改成你的APPID
            'appsecret' => '160130736b1ac0d54ed7abe51e44840b', // TODO 修改成你的密钥
        ),
        'notify_url' => 'http://你的接口域名/xunhupay_notify.php', // TODO 成功支付后的回调地址
    ),
);

接口

发起支付接口：PhalApi\Xunhupay.Xunhupay.PaymentDo
查询支付接口：PhalApi\Xunhupay.Xunhupay.OrderQuery
回调入口：http://你的接口域名/xunhupay_notify.php

示例效果

1、调用发起支付接口，可以选择直接接口跳转到支付页面，也可以先返回接口json结果然后客户端再跳转。例如返回：

{
    "ret": 200,
    "data": {
        "pay_url": "https://api.xunhupay.com/payments/wechat/index?id=20201381209&nonce_str=8976995811&time=1578991869&appid=2147483647&hash=51de5fa1a6cc9d4a0f6182d07970f927",
        "trade_order_id": "11888888898"
    },
    "msg": ""
}

打开pay_url链接，进入在线支付页面，如：

小结：

1、要么用ajax请求，把json拿回来，用js进行跳转（js_jump=0）
2、要么直接把接口当作跳转链接，用a标签新窗口打开（js_jump=1）

2、支付成功后，会回调到xunhupay_notify.php，在里面进行业务的处理。

if($data['status']=='OD'){
	// 更新订单为已支付
	$model->update($orderInfo['id'], array('order_status' => 1));
    /************商户业务处理******************/
    //TODO:此处处理订单业务逻辑,支付平台会多次调用本接口(防止网络异常导致回调失败等情况)
    //     请避免订单被二次更新而导致业务异常！！！
    //     if(订单未处理){
    //         处理订单....
    //      }

    //....
    //...
    /*************商户业务处理 END*****************/
}else{
    //处理未支付的情况
}

手机扫码后，

3、最后进行订单查询，当未支付时返回：

{
    "ret": 200,
    "data": {
        "errcode": 0,
        "errmsg": "",
        "data": {
            "open_order_id": "20201381200",
            "total_amount": "0.01",
            "title": "test",
            "status": "WP",
            "payment_method": "wechat",
            "transaction_id": null,
            "order_date": "2020-01-14 16:48:28",
            "paid_date": null,
            "pay_url": "weixin://wxpay/bizpayurl?pr=8R4Z3LI",
            "out_trade_order": "11888888898"
        }
    },
    "msg": ""
}

已支付后，返回：

{
    "ret": 200,
    "data": {
        "errcode": 0,
        "errmsg": "",
        "data": {
            "open_order_id": "20201381209",
            "total_amount": "0.01",
            "title": "test",
            "status": "OD",
            "payment_method": "wechat",
            "transaction_id": "4200000504202001141029026607",
            "paid_date": "2020-01-14 16:52:01",
            "pay_url": "weixin://wxpay/bizpayurl?pr=6Mprr2S",
            "out_trade_order": "11888888898"
        }
    },
    "msg": ""
}

4、数据库支付订单纪录

参考

虎皮椒开发文档

phalapi / xunhupay

Maintainers

Details

README

安装

配置

接口

示例效果

参考