Payment是一個php版本的支付聚合第三方sdk，集成了微信支付、支付寶支付、招商一網(wǎng)通支付。提供統(tǒng)一的調(diào)用接口，方便快速接入各種支付、查詢、退款、轉(zhuǎn)賬能力。

Payment 的目的是簡化大家在對接主流第三方時需要頻繁去閱讀第三方文檔，還經(jīng)常遇到各種問題。Payment 將所有第三方的接口進行了合理的建模分類，對大家提供統(tǒng)一的接入入口，大家只需要關注自身業(yè)務并且支付系統(tǒng)設計上。

目前已經(jīng)集成：支付寶、微信、招商絕大部分功能。

如何使用

安裝

當前 Payment 項目僅支持 PHP version > 7.0 的版本，并且僅支持通過 composer 進行安裝。

需要 PHP 安裝以下擴展：

 - ext-curl
- ext-mbstring
- ext-bcmath
- package-Guzzle

composer安裝方式：

直接在命令行下安裝：

composer require "riverslei/payment:*"

通過項目配置文件方式安裝：

"require": {
"riverslei/payment": "*"
}

項目集成

按照上面的步驟完成安裝后，即可在項目中使用。

對于整個過程，提供了唯一的入口類 \Payment\Client，每一個渠道，均只介紹 APP支付 與 異步/同步通知 該如何接入。會重點說明每個請求支持的參數(shù)。

APP支付demo

$config = [
// 配置信息，各個渠道的配置模板見對應子目錄
];

// 請求參數(shù)，完整參數(shù)見具體表格
$payData = [
'body' => 'test body',
'subject' => 'test subject',
'trade_no' => 'trade no',// 自己實現(xiàn)生成
'time_expire' => time() + 600, // 表示必須 600s 內(nèi)付款
'amount' => '5.52', // 微信沙箱模式，需要金額固定為3.01
'return_param' => '123',
'client_ip' => isset($_SERVER['REMOTE_ADDR']) ? $_SERVER['REMOTE_ADDR'] : '127.0.0.1', // 客戶地址
];``

// 使用
try {
$client = new \Payment\Client(\Payment\Client::WECHAT, $wxConfig);
$res = $client->pay(\Payment\Client::WX_CHANNEL_APP, $payData);
} catch (InvalidArgumentException $e) {
echo $e->getMessage();
exit;
} catch (\Payment\Exceptions\GatewayException $e) {
echo $e->getMessage();
var_dump($e->getRaw());
exit;
} catch (\Payment\Exceptions\ClassNotFoundException $e) {
echo $e->getMessage();
exit;
} catch (Exception $e) {
echo $e->getMessage();
exit;
}

異步/同步通知

// 自己實現(xiàn)一個類，繼承該接口
class TestNotify implements \Payment\Contracts\IPayNotify
{
/**
* 處理自己的業(yè)務邏輯，如更新交易狀態(tài)、保存通知數(shù)據(jù)等等
* @param string $channel 通知的渠道，如：支付寶、微信、招商
* @param string $notifyType 通知的類型，如：支付、退款
* @param string $notifyWay 通知的方式，如：異步 async，同步 sync
* @param array $notifyData 通知的數(shù)據(jù)
* @return bool
*/
public function handle(
string $channel,
string $notifyType,
string $notifyWay,
array $notifyData
) {
//var_dump($channel, $notifyType, $notifyWay, $notifyData);exit;
return true;
}
}

$config = [
// 配置信息，各個渠道的配置模板見對應子目錄
];

// 實例化繼承了接口的類
$callback = new TestNotify();

try {
$client = new \Payment\Client(\Payment\Client::ALIPAY, $config);
$xml = $client->notify($callback);
} catch (InvalidArgumentException $e) {
echo $e->getMessage();
exit;
} catch (\Payment\Exceptions\GatewayException $e) {
echo $e->getMessage();
exit;
} catch (\Payment\Exceptions\ClassNotFoundException $e) {
echo $e->getMessage();
exit;
} catch (Exception $e) {
echo $e->getMessage();
exit;
}

從上面的例子簡單總結下，所有的支持的能力，通過 \Payment\Client 對外暴露方法;所有需要的常量也在這個類中進行了定義。其次需要一個 $config，關于config的模板，在每個渠道下面去看。最后一個傳入請求的參數(shù)，完整的參數(shù)會在每個渠道中列出來，需要說明的是這些參數(shù)名字根據(jù)第三方文檔部分進行了改寫。在使用的時候請注意。

支付寶

配置文件模板

$config = [
'use_sandbox' => true, // 是否使用沙盒模式

'app_id' => '2016073100130857',
'sign_type' => 'RSA2', // RSA RSA2

// 支付寶公鑰字符串
'ali_public_key' => '',

// 自己生成的密鑰字符串
'rsa_private_key' => '',

'limit_pay' => [
//'balance',// 余額
//'moneyFund',// 余額寶
//'debitCardExpress',// 借記卡快捷
//'creditCard',//信用卡
//'creditCardExpress',// 信用卡快捷
//'creditCardCartoon',//信用卡卡通
//'credit_group',// 信用支付類型（包含信用卡卡通、信用卡快捷、花唄、花唄分期）
], // 用戶不可用指定渠道支付當有多個渠道時用“,”分隔

// 與業(yè)務相關參數(shù)
'notify_url' => 'https://dayutalk.cn/notify/ali',
'return_url' => 'https://dayutalk.cn',
];

微信

對于每一個微信支持的能力，并不是所有參數(shù)都支持了，有些參數(shù)絕大多數(shù)場景并不需要用到。如果確實需要請自行對源碼進行修改。

配置文件模板

$config = [
'use_sandbox' => false, // 是否使用 微信支付仿真測試系統(tǒng)

'app_id' => 'wxxxxxxxx', // 公眾賬號ID
'sub_appid' => 'wxxxxxxxx', // 公眾子商戶賬號ID
'mch_id' => '123123123', // 商戶id
'sub_mch_id' => '123123123', // 子商戶id
'md5_key' => '23423423dsaddasdas', // md5 秘鑰
'app_cert_pem' => 'apiclient_cert.pem',
'app_key_pem' => 'apiclient_key.pem',
'sign_type' => 'MD5', // MD5 HMAC-SHA256
'limit_pay' => [
//'no_credit',
], // 指定不能使用信用卡支付 不傳入，則均可使用
'fee_type' => 'CNY', // 貨幣類型 當前僅支持該字段

'notify_url' => 'https://dayutalk.cn/v1/notify/wx',

'redirect_url' => 'https://dayutalk.cn/', // 如果是h5支付，可以設置該值，返回到指定頁面
];

招商銀行

配置文件模板

$config = [
'use_sandbox' => true, // 是否使用 招商測試系統(tǒng)

'branch_no' => 'xxx', // 商戶分行號，4位數(shù)字
'mch_id' => 'xxxx', // 商戶號，6位數(shù)字
'mer_key' => 'xxxxxx', // 秘鑰16位，包含大小寫字母 數(shù)字

// 招商的公鑰，建議每天凌晨2:15發(fā)起查詢招行公鑰請求更新公鑰。
'cmb_pub_key' => 'xxxxx',

'op_pwd' => 'xxxxx', // 操作員登錄密碼。
'sign_type' => 'SHA-256', // 簽名算法,固定為“SHA-256”
'limit_pay' => 'A', // 允許支付的卡類型,默認對支付卡種不做限制，儲蓄卡和信用卡均可支付 A:儲蓄卡支付，即禁止信用卡支付

'notify_url' => 'https://dayutalk.cn/notify/cmb', // 支付成功的回調(diào)

'sign_notify_url' => 'https://dayutalk.cn/notify/cmb', // 成功簽約結果通知地址
'sign_return_url' => 'https://dayutalk.cn', // 成功簽約結果通知地址

'return_url' => 'https://dayutalk.cn', // 如果是h5支付，可以設置該值，返回到指定頁面
];