支付SDK（V3）

項(xiàng)目地址

https://github.com/yansongda/pay

安裝

composer require yansongda/pay ~3.0

使用

說明：以下以支付寶沙箱環(huán)境為環(huán)境進(jìn)行文檔編寫，若有問題，請(qǐng)及時(shí)反饋哦！

配置文件

假設(shè)有以下配置文件 config/payment.php

<?php
/**
 * @desc 支付配置文件
 * @author Tinywan(ShaoBo Wan)
 * @date 2022/03/11 20:15
 */
return [
    '_force' => true, // 注意，這個(gè)必須是true
    'alipay' => [
        'default' => [
            // 必填-支付寶分配的 app_id
            'app_id' => '20160909004708941',
            // 必填-應(yīng)用私鑰 字符串或路徑
            'app_secret_cert' => 'MIIEpAIBAAKCxxxxxxxxxxxxxxP4r3m4OUmD/+XDgCg==',
            // 必填-應(yīng)用公鑰證書 路徑
            'app_public_cert_path' => base_path().'/payment/appCertPublicKey_2016090900470841.crt',
            // 必填-支付寶公鑰證書 路徑
            'alipay_public_cert_path' => base_path().'/payment/alipayCertPublicKey_RSA2.crt',
            // 必填-支付寶根證書 路徑
            'alipay_root_cert_path' => base_path().'/payment/alipayRootCert.crt',
            // 選填-同步回調(diào)地址
            'return_url' => 'https://webman.tinywan.cn/payment/alipay-return',
            // 選填-異步回調(diào)地址
            'notify_url' => 'https://webman.tinywan.cn/payment/alipay-notify',
            // 選填-服務(wù)商模式下的服務(wù)商 id，當(dāng) mode 為 Pay::MODE_SERVICE 時(shí)使用該參數(shù)
            'service_provider_id' => '',
            // 選填-默認(rèn)為正常模式?？蛇x為： MODE_NORMAL, MODE_SANDBOX, MODE_SERVICE
            'mode' => \Yansongda\Pay\Pay::MODE_SANDBOX,
        ]
    ],
    'wechat' => [
        'default' => [
            // 必填-商戶號(hào)，服務(wù)商模式下為服務(wù)商商戶號(hào)
            'mch_id' => '',
            // 必填-商戶秘鑰
            'mch_secret_key' => '',
            // 必填-商戶私鑰 字符串或路徑
            'mch_secret_cert' => '',
            // 必填-商戶公鑰證書路徑
            'mch_public_cert_path' => '',
            // 必填
            'notify_url' => 'https://yansongda.cn/wechat/notify',
            // 選填-公眾號(hào) 的 app_id
            'mp_app_id' => '2016082000291234',
            // 選填-小程序 的 app_id
            'mini_app_id' => '',
            // 選填-app 的 app_id
            'app_id' => '',
            // 選填-合單 app_id
            'combine_app_id' => '',
            // 選填-合單商戶號(hào)
            'combine_mch_id' => '',
            // 選填-服務(wù)商模式下，子公眾號(hào) 的 app_id
            'sub_mp_app_id' => '',
            // 選填-服務(wù)商模式下，子 app 的 app_id
            'sub_app_id' => '',
            // 選填-服務(wù)商模式下，子小程序 的 app_id
            'sub_mini_app_id' => '',
            // 選填-服務(wù)商模式下，子商戶id
            'sub_mch_id' => '',
            // 選填-微信公鑰證書路徑, optional，強(qiáng)烈建議 php-fpm 模式下配置此參數(shù)
            'wechat_public_cert_path' => [
                '45F59D4DABF31918AFCEC556D5D2C6E376675D57' => __DIR__.'/Cert/wechatPublicKey.crt',
            ],
            // 選填-默認(rèn)為正常模式。可選為： MODE_NORMAL, MODE_SERVICE
            'mode' => \Yansongda\Pay\Pay::MODE_SANDBOX,
        ]
    ],
    'logger' => [
        'enable' => false,
        'file' => runtime_path().'/logs/alipay.log',
        'level' => 'debug', // 建議生產(chǎn)環(huán)境等級(jí)調(diào)整為 info，開發(fā)環(huán)境為 debug
        'type' => 'single', // optional, 可選 daily.
        'max_file' => 30, // optional, 當(dāng) type 為 daily 時(shí)有效，默認(rèn) 30 天
    ],
    'http' => [ // optional
        'timeout' => 5.0,
        'connect_timeout' => 5.0,
        // 更多配置項(xiàng)請(qǐng)參考 [Guzzle](https://guzzle-cn.readthedocs.io/zh_CN/latest/request-options.html)
    ]
];

注意：證書目錄沒有規(guī)定，以上示例是放在的框架的 payment目錄下

├── payment
│?? ├── alipayCertPublicKey_RSA2.crt
│?? ├── alipayRootCert.crt
│?? └── appCertPublicKey_2016090900470841.crt

初始化

直接調(diào)用 config 方法初始化

// 獲取配置文件 config/payment.php
$config = config('payment');
Pay::config($config);

注意：如果是支付寶沙箱模式，一定要記得開啟配置文件 'mode' => \Yansongda\Pay\Pay::MODE_SANDBOX,，該選項(xiàng)默認(rèn)為默認(rèn)為正常模式。

支付（網(wǎng)頁）

use support\Request;
use Yansongda\Pay\Pay;

/**
 * @param Request $request
 * @return string
 */
public function payment(Request $request)
{
    // 1. 初始化配置
    Pay::config(config('payment'));

    // 2. 網(wǎng)頁支付
    $order = [
        'out_trade_no' => time(),
        'total_amount' => '8888.88',
        'subject' => 'webman payment',
        '_method' => 'get' // 使用get方式跳轉(zhuǎn)
    ];
    return Pay::alipay()->web($order)->getBody()->getContents();
}

異步回調(diào)

use support\Request;
use Yansongda\Pay\Pay;

/**
 * @desc:『支付寶』異步通知
 * @param Request $request
 * @return Response
 */
public function alipayNotify(Request $request): Response
{
    // 1. 初始化配置
    Pay::config(config('payment'));

    // 2. 支付寶回調(diào)處理
    $result = Pay::alipay()->callback($request->post());

    // ===================================================================================================
    // 請(qǐng)自行對(duì) trade_status 進(jìn)行判斷及其它邏輯進(jìn)行判斷，只有交易通知狀態(tài)為 TRADE_SUCCESS 或 TRADE_FINISHED 時(shí)，支付寶才會(huì)認(rèn)定為買家付款成功。
    // 1、商戶需要驗(yàn)證該通知數(shù)據(jù)中的out_trade_no是否為商戶系統(tǒng)中創(chuàng)建的訂單號(hào)；
    // 2、判斷total_amount是否確實(shí)為該訂單的實(shí)際金額（即商戶訂單創(chuàng)建時(shí)的金額）；
    // 3、校驗(yàn)通知中的seller_id（或者seller_email) 是否為out_trade_no這筆單據(jù)的對(duì)應(yīng)的操作方；
    // 4、驗(yàn)證app_id是否為該商戶本身。
    // 5、其它業(yè)務(wù)邏輯情況
    // ===================================================================================================

    // 5. 支付寶回調(diào)處理
    return new Response(200, [], 'success');
}

注意：不能使用插件本身 return Pay::alipay()->success();響應(yīng)支付寶回調(diào)，如果你用到中間件會(huì)出現(xiàn)中間件問題。所以響應(yīng)支付寶需要使用webman的響應(yīng)類 support\Response;

同步回調(diào)

use support\Request;
use Yansongda\Pay\Pay;

/**
 * @desc: 『支付寶』同步通知
 * @param Request $request
 * @author Tinywan(ShaoBo Wan)
 */
public function alipayReturn(Request $request)
{
    Log::info('『支付寶』同步通知'.json_encode($request->get()));
    return 'success';
}

更多內(nèi)容

訪問官方文檔 https://pay.yansongda.cn/docs/v3/