https://github.com/phalapi/xunhupay
PhalApi 2.x 虎皮椒支付扩展
https://github.com/phalapi/xunhupay
Last synced: 14 days ago
JSON representation
PhalApi 2.x 虎皮椒支付扩展
- Host: GitHub
- URL: https://github.com/phalapi/xunhupay
- Owner: phalapi
- Created: 2020-01-14T06:37:09.000Z (over 5 years ago)
- Default Branch: master
- Last Pushed: 2020-01-14T15:29:31.000Z (over 5 years ago)
- Last Synced: 2025-01-30T01:45:12.456Z (5 months ago)
- Language: PHP
- Size: 29.3 KB
- Stars: 3
- Watchers: 3
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# PhalApi 2.x 虎皮椒支付扩展
## 安装
修改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目录下，以便作为支付回调入口提供给虎皮椒调用。出于安全性考虑，文件名可以自行修改，但在配置时要同步修改。
在数据库中以下创建虎皮椒订单表：
```sql
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。
```php
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，在里面进行业务的处理。
```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、数据库支付订单纪录
## 参考
+ [虎皮椒开发文档](https://www.xunhupay.com/doc/api/search.html)