https://github.com/zhangv/union-pay
simplest union pay（银联支付）
https://github.com/zhangv/union-pay
chinapay pay union unionpay
Last synced: 5 months ago
JSON representation
simplest union pay（银联支付）
- Host: GitHub
- URL: https://github.com/zhangv/union-pay
- Owner: zhangv
- License: mit
- Created: 2015-11-07T14:37:40.000Z (over 10 years ago)
- Default Branch: master
- Last Pushed: 2020-05-21T03:06:24.000Z (about 6 years ago)
- Last Synced: 2025-12-20T06:07:34.611Z (7 months ago)
- Topics: chinapay, pay, union, unionpay
- Language: PHP
- Homepage:
- Size: 215 KB
- Stars: 32
- Watchers: 3
- Forks: 17
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# UnionPay - 银联支付
[](https://packagist.org/packages/zhangv/union-pay)
[](https://packagist.org/packages/zhangv/union-pay)
[](https://travis-ci.org/zhangv/union-pay)
[](https://codecov.io/gh/zhangv/union-pay)
simplest union pay - no dependency to any library, simple enough to let you hack.
### Feature
* [B2C - 在线网关支付](src/service/B2C.php)
* [Wap - 手机网页支付（WAP支付）](src/service/Wap.php)
* [App - App/控件支付](src/service/App.php)
* [B2B - 企业网银支付](src/service/B2B.php)
* [Direct - 无跳转标准版](src/service/Direct.php)
* [Token - 无跳转Token版](src/service/Token.php)
* [Qrcode - 二维码支付](src/service/Qrcode.php)
* [DirectDebit - 代收](src/service/DirectDebit.php)
* [Charge - 便民缴费产品](src/service/Charge.php)
* 刷脸支付 （TODO）
* 跨境电商海关申报（TODO）
### Install
```
composer require zhangv/union-pay
```
or
add:
```
"zhangv/union-pay":"0.8.12"
```
in composer.json
### Step 1: [config.php](demo/config.php) - 配置
```php
return ['test', [
'version' => '5.1.0',
'signMethod'=> '01', //RSA
'encoding' => 'UTF-8',
'merId' => '700000000000001',
'returnUrl' => 'http://dev.git.com/union-pay/demo/payreturn.php', //前台网关支付返回
'notifyUrl' => 'http://dev.git.com/union-pay/demo/paynotify.php', //后台通知
'frontFailUrl' => 'http://dev.git.com/union-pay/demo/payfail.php',
'refundnotifyUrl' => 'http://dev.git.com.com/union-pay/demo/refundnotify.php',
'signCertPath' => dirname(__FILE__).'/../cert/acp_test_sign.pfx',
'signCertPwd' => '000000', //签名证书密码
'verifyCertPath' => dirname(__FILE__).'/../cert/acp_test_verify_sign.cer', //v5.0.0 required
'verifyRootCertPath' => dirname(__FILE__).'/../cert/acp_test_root.cer', //v5.1.0 required
'verifyMiddleCertPath' => dirname(__FILE__).'/../cert/acp_test_middle.cer', //v5.1.0 required
'encryptCertPath' => dirname(__FILE__).'/../cert/acp_test_enc.cer',
'ifValidateCNName' => false, //正式环境设置为true
]
];
```
### Step 2: [pay.php](demo/b2c/pay.php) - 支付
```php
pay($payOrderNo,$amt);
echo $html;
```
### Step 3: [payreturn.php](demo/payreturn.php) - 支付完成前台返回
```php
onPayNotify($postdata,function($notifydata){
echo 'SUCCESS';
var_dump($notifydata);
});
```
### Step 4: [paynotify.php](demo/paynotify.php) - 支付完成后台通知
```php
onNotify($notifyData,'demoCallback');
}elseif(in_array($respCode,['03','04','05'])){
//后续需发起交易状态查询交易确定交易状态
}else{
echo 'fail';
}
function demoCallback($notifyData){//自定义回调
var_dump($notifyData);
print('ok');
}
```
### FAQ
* 关于测试环境：有时候会报验签错误，一般的原因是证书错误或者参数拼接，如果确认二者没错，那么可能是因为你的商户号在银联测试环境中不生效，这种时候需要联系银联的客服。也可以直接用生产环境的证书测试交易，如果可以正常交易，那么测试交易这步也可以不做。
* 关于测试用例：目前的测试用例依赖银联的测试环境，但并不是很稳定，经常会有返回错误的情况。后续可能考虑改成模拟数据。