Skip to content

aa0604/payment

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

83 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

更新说明

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、后端服务器收到成功付款的通知后,运行支付成功后的业务代码

目录

安装

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

PaySsion

PayPal

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

About

支付插件 支持支付宝和微信

Resources

Stars

Watchers

Forks

Packages

No packages published

Languages