Wallogit.com
2017 © Pedro Peláez
支付宝、微信、payPal、payssion，使用命名空间，可在YII框架中使用，也可以独立使用。使用官方SDK修改，APP支付和验证异步通知，并可生成支付宝、微信app签名，已修复微信官方SDK的众多BUG
app签名的键名改变了三个，之前是全小写，现改为驼峰（nonceStr，timeStamp，appId）, (*1)
支持支付宝支付、微信支付、IOS苹果内购、payPal支付、银联、首信易，payssion支付，头条/字节跳动, (*2)
可生成支付宝、微信app、小程序签名（小程序签名使用另外的方法）, (*3)
可生成微信/头条/字节跳动所需的orderInfo，字节跳动可传入支付宝、微信配置生成alipay_url || wx_url，使用方法和生成签名参数一样, (*4)
本库使用interface规范，工厂模式编写，代码质量高，统一规范。, (*5)
简单说好处就是，在控制器里，你只需要写几行代码，你就可以对接多个支付。想要做到这一点，需要前端向传递服务端使用哪个支付驱动代码，服务端再根据支付驱动代码去调用相应的支付程序。, (*6)
美中不足的是，部分代码是用php7的新特性写的，不兼容老版本的，我们做开发的特别是新项目自然是要走在技术的前端才对。, (*7)
1、支持：支付宝、微信、银联、payPal、payssion，首信易支付, (*8)
2、主要功能：全部支持支付和验证异步通知, (*9)
3、支付宝、微信、微信JSAPI支付：可生成app签名，可原路退款, (*10)
4、通过工厂服务可以一次调用出所有支持的支付平台的app参数, (*11)
（其他第三方支付流程也类似，有的会不同，详细有什么不同可以到github上面给我留言，我收到后有空时会补充说明）, (*12)
1、生成签名，设置回调地址（回调地址在配置中设置）, (*13)
2、app收到签名后向用户发起支付, (*14)
3、支付成功后支付宝/微信会向你配置的回调地址发起付款成功的通知, (*15)
4、后端服务器收到成功付款的通知后，运行支付成功后的业务代码, (*16)
composer require xing.chen/payment dev-master, (*17)
<?php
$payName = 'WeChatPay'; // 支付驱动代码
$orderSn = '商家订单号';
$title = '商品名称';
$body = $payName == 'ApplePay' ? '商品id' : '商品名称或商品描述';
// 配置
$set = [...]; // 配置，请参阅配置章节
if (empty($set)) throw new \Exception('读取支付设置失败，payName = ' . $payName);
$payInstance = \xing\payment\drive\PayFactory::getInstance($payName)
->init($set)
->customParams($module)
->set($orderSn, $amount, $title, $body, $intOrderSn);
// 如果是微信JSAPI支付
if ($payName == 'wxMiniProgram') {
$openId = '微信用户openId';
$set['openId'] = $openId;
$orderInfo = $paySign = $payInstance->getMiniProgramParam();
} else { // 其他
$orderInfo = $paySign = $payInstance->getAppParam();
}
本例为支付宝异步通知，其他支付驱动请查看详细文档自行码, (*18)
<?php
try {
$payName = 'AliPay';
$set = PaymentSetMap::getSet($payName);
if (!PayFactory::getInstance($payName)->init($set)->validate($_POST)) throw new \Exception('验证失败');
exit('success');
} catch (\Exception $e) {
exit('fail');
}
说明：在此方法传递参数时传入此代码即调用相应的支付驱动 \xing\payment\drive\PayFactory::getInstance('支付驱动代码'), (*19)
AliPay, (*20)
WeChatPay, (*21)
WeChatPay, (*22)
BeijinPay, (*23)
UnionPay, (*24)
PaySsion, (*25)
PayPal, (*26)
ApplePay, (*27)
TuoTiaoPay, (*28)
<?php $payName = '支付驱动代码'; // 支付驱动代码 $payInstance = \xing\payment\drive\PayFactory::getInstance($payName)->init($confing); //支付驱动 的配置，详情看配置篇，小程序需要在微信支付配置的基础上多加openId // 小程序、公众号支付等JSAPI需要额外加上用户openId $confing['openId'] = '用户openId';
<?php
// 单个
$sign = $payInstance->set('订单号', '金额', '支付标题（商品名）')->getAppParam();
// 微信小程序、公众号、网页支付等和JSAPI有关的支付生成签名方法为：
$sign = $payInstance->set('订单号', '金额', '支付标题（商品名）')->getMiniProgramParam();
// 同时获取微信和支付的app支付签名
$payChannel= \xing\payment\drive\PayFactory::getAppsParam([
'AliPay' => $aliConfig,
'WeChatPay' => $wechatConfig
], '订单号', '金额', '支付标题（商品名）');
<?php
// 如无特别说明，传递的参数都是是$_POST，但有些支付厂商不能使用$_POST，如paypal，微信等，请参考获取异步通知参数说明
if (!$payInstance->validate($_POST))
throw new \Exception('非法请求');
<?php
$payInstance->set('订单号', '退款金额')->refund();
$payInstance->set('订单号', '退款金额', '退款原因', '', '多次退款唯一标识单号')->refund();
<?php
$payInstance->customParams('自定义参数（字符串）');
。, (*29)
整个支付流程建议为：, (*30)
1、如果需要跟踪客户订单或是保持和支付宝微信的支付流程一致，可以先在服务端生成订单信息，并返回orderinfo参数，客户端保存好订单号。否则这一步可以跳过。, (*31)
2、客户端发起购买, (*32)
3、用户确认并支付, (*33)
4、支付成功后，客户端保存成功的数据，向服务端发送receipt数据以及订单号, (*34)
5、服务端根据服务端数据库的订单状态或保存的receipt原始订单id来判断是否使用过，避免刷单，如未使用，则发起验证，验证通过保存receipt为已使用。, (*35)
<?php
$appleSet = [
'sandbox' => false, // 是否沙箱模式
'secret' => 'app专用共享密钥',
];
说明：和支付宝，微信的生成app签名的方法一样，不同的是，第4个参数为产品id，这样可以使后端一套代码应付多个支付平台，并且使苹果内购支付前的流程和支付宝微信相似。, (*36)
<?php
$orderInfo = $payInstance->set('订单号', '金额', '', '产品id')->getAppParam();
有三个步骤有可能造成漏单：, (*37)
1、服务端并不能保证100%在线。, (*38)
2、用户网络也无法保证100%连通。, (*39)
3、苹果服务器不稳定。, (*40)
解决方案建议：, (*41)
客户端保存支付成功数据，在未得到服务成功的信号前，一直存在，并有不断重启请求任务的机制，并且app重启也能重启此任务。, (*42)
<?php
// 支付宝配置
$aliConfig = [
'title' => '支付宝支付',
'appId' => '支付宝appId',
'notifyUrl' => '异步通知 url',
'alipayrsaPublicKey' => '支付宝公钥（字符串），详情请查看支付宝生成公钥的文档',
'rsaPrivateKey' => '支付宝私钥（字符串），详情请查看支付宝生成私钥的文档',
];
<?php $params = $_POST['passback_params']; // 自定义参数 $orderSn = $_POST['out_trade_no']; // 订单号 $payMoney = $_POST['total_amount']; // 支付金额
微信和小程序的配置和流程是可以共用的，只需要在生成支付sign的时候使用getMiniProgramParam方法即可（需要要在配置加上用户openId，详细见生成签名, (*43)
<?php
// 微信
$wechatConfig = [
'title' => '微信支付',
'appId' => '微信支付appId',
'mchId' => '商户id',
'notifyUrl' => '异步通知 url',
// 请换成你自己的相应的文证书件地址
'SSL_CERT_PATH' => '(绝对路径)apiclient_cert.pem',
'SSL_KEY_PATH' => '(绝对路径)apiclient_key.pem',
];
<?php # 获取微信异步通知传来的参数 $post = $payInstance->getNotifyParams(); # 这是自定义参数 $drive = $post['attach'] ?? ''; # 订单号 $orderSn = $post['out_trade_no'];
<?php # 获取微信异步通知传来的参数 $post = $payInstance->getNotifyParams(); # 获取和订单一致的支付金额（将分转为元） $payMoney = $payInstance->centsToYuan($post['total_fee']);
$config = [
'merchant_id' => '商户号',
'app_id' => 'appId',
'secret' => '密钥',
];
// 传入支付宝或微信驱动代码，返回的数据就会包含alipay_url或wx_url相关参数
$orderInfo = $payInstance->setService('AliPay或WeChatPay')->getAppParam();
<?php
$config = [
'clientId' => '商家id',
'clientSecret' => 'Secret',
'sandbox' => false, // 是否开启沙箱模式
];
<?php
$requestBody = file_get_contents('php://input');
<?php $set = [ 'apiKey' => 'apiKey', 'secretKey' => 'secretKey' ];
手机控件支付：银联需要先获取流水号再返回给前端app，app支付成功后才能成功接收银联的异步通知结果。, (*44)
<?php
$test = true; // 是否测试环境
$config = [
// 配置和证书的路径
'certsPath' => dirname(__DIR__) . '/config/certs'.(!$test ? '' : '_test').'/',
'merId' => $test ? 777290058110048 : '商户号',
];
/**
* certsPath文件说明：
* 以下文件当你和银联那边对接通之后，他们的资源包会包含以下文件，除了复制到程序里之外，你还需要根据银联的教程将部分文件配置好。
*
* 生产环境 certsPath 应包含的文件
* config/certs/acp_prod_enc.cer
* config/certs/acp_prod_middle.cer
* config/certs/acp_prod_root.cer
* config/certs/acp_sdk.ini
* config/certs/cfca.cer
* config/certs/cfca.pfx
*
*
* 测试环境 certsPath 应包含的文件
* config/certs_test/acp_sdk.ini
* config/certs_test/acp_test_enc.cer
* config/certs_test/acp_test_middle.cer
* config/certs_test/acp_test_root.cer
* config/certs_test/acp_test_sign.pfx
*/
<?php
$orderSn = '订单号';
$payMoney = '支付金额/单位分';
try {
$tn = $payInstance->createOrder($orderSn, $payMoney);
} catch (\Exception $e) {
throw $e;
}
<?php
$conifg = [
'apiKey' => 'apiKey',
'checkValidate' => 'md5', // 验证方式
'pemPath' => '证书路径',
];
<?php
try {
$orderSn = $_REQUEST['v_oid'] ?? '';
if (empty($orderSn)) throw new \Exception('订单号没有获取到');
if($payInstance->validate($_REQUEST)) {
$count = $_REQUEST['v_count'] ?? 0;//订单个数
if ($count <= 0) throw new \Exception('订单个数小于0');
$v_oid=$_REQUEST['v_oid'];//订单编号组
$v_pstatus=$_REQUEST['v_pstatus'];//支付状态组
$v_amount=$_REQUEST['v_amount'];//订单支付金额
$v_moneytype=$_REQUEST['v_moneytype'];//订单支付币种
$sp = '|_|';
$a_oid = explode($sp, $v_oid);
$a_pstatus = explode($sp, $v_pstatus);
$a_amount = explode($sp, $v_amount);
// 通知可能包含多个订单通知，所以循环
for ($i = 0; $i < $count; $i++) {
$orderSn = preg_replace('/(.*)-/', '', $a_oid[$i]);
if($a_pstatus[$i]=='1')
{
// 支付成功，业务代码
}
}
exit('success');
} else {
throw new \Exception('验证订单失败');
}
} catch(\Exception $e) {
throw $e;
}
支付宝、微信、payPal、payssion，使用命名空间，可在YII框架中使用，也可以独立使用。使用官方SDK修改，APP支付和验证异步通知，并可生成支付宝、微信app签名，已修复微信官方SDK的众多BUG
MIT