README

更新说明

app签名的键名改变了三个，之前是全小写，现改为驼峰（nonceStr，timeStamp，appId）

概要

支持支付宝支付、微信支付、IOS苹果内购、payPal支付、银联、首信易，payssion支付，头条/字节跳动

可生成支付宝、微信app、小程序签名（小程序签名使用另外的方法）

可生成微信/头条/字节跳动所需的orderInfo，字节跳动可传入支付宝、微信配置生成alipay_url || wx_url，使用方法和生成签名参数一样

本库使用interface规范，工厂模式编写，代码质量高，统一规范。

简单说好处就是，在控制器里，你只需要写几行代码，你就可以对接多个支付。想要做到这一点，需要前端向传递服务端使用哪个支付驱动代码，服务端再根据支付驱动代码去调用相应的支付程序。

美中不足的是，部分代码是用php7的新特性写的，不兼容老版本的，我们做开发的特别是新项目自然是要走在技术的前端才对。

功能说明

1、支持：支付宝、微信、银联、payPal、payssion，首信易支付

2、主要功能：全部支持支付和验证异步通知

3、支付宝、微信、微信JSAPI支付：可生成app签名，可原路退款

4、通过工厂服务可以一次调用出所有支持的支付平台的app参数

支付宝、微信APP支付流程

（其他第三方支付流程也类似，有的会不同，详细有什么不同可以到github上面给我留言，我收到后有空时会补充说明）

1、生成签名，设置回调地址（回调地址在配置中设置）

2、app收到签名后向用户发起支付

3、支付成功后支付宝/微信会向你配置的回调地址发起付款成功的通知

4、后端服务器收到成功付款的通知后，运行支付成功后的业务代码

安装
业务代码示例
- 签名/参数获取示例代码
- 异步通知示例代码
支付驱动代码列表
统一方法
- 初始化
- 生成app签名/参数
- 异步通知
- 退款（原路全款退回）
- 退款（原路部分多次退回）
- 设置自定义参数
苹果内购
支付宝
- 支付宝配置
- 支付宝获取异步通知参数
微信/小程序
- 微信配置
- 微信获取异步通知参数
- 微信分转换为元
字节跳动
- 配置
- 获取支付宝或微信url
paypal
- payPal配置
- payPal获取异步通知参数
payssion
- payssion配置
银联
- 银联说明
- 银联配置
- 获取银联流水号
首信易
- 首信易异步通知

安装

composer require xing.chen/payment dev-master

业务代码示例

签名/参数获取示例代码

<?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();
    }

异步通知示例代码

本例为支付宝异步通知，其他支付驱动请查看详细文档自行码

<?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('支付驱动代码')

支付宝支付

AliPay

微信支付

WeChatPay

小程序支付

WeChatPay

首信易支付

BeijinPay

银联

UnionPay

PaySsion

PayPal

苹果支付

ApplePay

字节跳动

TuoTiaoPay

统一方法

初始化

<?php

$payName = '支付驱动代码'; // 支付驱动代码
$payInstance = \xing\payment\drive\PayFactory::getInstance($payName)->init($confing); //支付驱动 的配置，详情看配置篇，小程序需要在微信支付配置的基础上多加openId 
// 小程序、公众号支付等JSAPI需要额外加上用户openId
$confing['openId'] = '用户openId';

生成app签名

<?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('自定义参数（字符串）');

苹果内购

苹果流程说明

。

整个支付流程建议为：

1、如果需要跟踪客户订单或是保持和支付宝微信的支付流程一致，可以先在服务端生成订单信息，并返回orderinfo参数，客户端保存好订单号。否则这一步可以跳过。

2、客户端发起购买

3、用户确认并支付

4、支付成功后，客户端保存成功的数据，向服务端发送receipt数据以及订单号

5、服务端根据服务端数据库的订单状态或保存的receipt原始订单id来判断是否使用过，避免刷单，如未使用，则发起验证，验证通过保存receipt为已使用。

苹果配置

<?php

$appleSet = [
    'sandbox' => false, // 是否沙箱模式
    'secret' => 'app专用共享密钥',
];

苹果获取订单参数

说明：和支付宝，微信的生成app签名的方法一样，不同的是，第4个参数为产品id，这样可以使后端一套代码应付多个支付平台，并且使苹果内购支付前的流程和支付宝微信相似。

<?php

$orderInfo = $payInstance->set('订单号', '金额', '', '产品id')->getAppParam();

苹果漏单处理

有三个步骤有可能造成漏单：

1、服务端并不能保证100%在线。

2、用户网络也无法保证100%连通。

3、苹果服务器不稳定。

解决方案建议：

客户端保存支付成功数据，在未得到服务成功的信号前，一直存在，并有不断重启请求任务的机制，并且app重启也能重启此任务。

支付宝

支付宝配置

<?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，详细见生成签名

微信配置

<?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();

paypal

payPal配置

<?php
$config = [
    'clientId' => '商家id',
    'clientSecret' => 'Secret',
    'sandbox' => false, // 是否开启沙箱模式
];

payPal获取异步通知参数

<?php
$requestBody = file_get_contents('php://input');

payssion

payssion配置

<?php
$set = [
   'apiKey' => 'apiKey',
   'secretKey' => 'secretKey'
];

银联

银联说明

手机控件支付：银联需要先获取流水号再返回给前端app，app支付成功后才能成功接收银联的异步通知结果。

银联配置

<?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;
}

xing.chen / payment

Maintainers

Details

README

更新说明

概要

功能说明

支付宝、微信APP支付流程

目录

安装

业务代码示例

签名/参数获取示例代码

异步通知示例代码

支付驱动代码列表

支付宝支付

微信支付

小程序支付

首信易支付

银联

PaySsion

PayPal

苹果支付

字节跳动

统一方法

初始化

生成app签名

异步通知

退款（原路全款退回）

退款（原路部分多次退回）

设置自定义参数

苹果内购

苹果流程说明

苹果配置

苹果获取订单参数

苹果漏单处理

支付宝

支付宝配置

支付宝获取异步通知参数

微信/小程序

微信配置

微信获取异步通知参数

微信分转换为元

字节跳动

配置

支付宝和微信的返回参加获取

paypal

payPal配置

payPal获取异步通知参数

payssion

payssion配置

银联

银联说明

银联配置

获取银联流水号

首信易支付

首信易配置

首信易异步通知