mirror of
https://gitee.com/zoujingli/WeChatDeveloper.git
synced 2026-09-04 23:12:09 +08:00
ca18f905d1
- 抽取 buildGatewayParams 统一开放平台网关公共参数、扩展参数和签名生成。 - 电脑网站支付跳转地址复用同一套签名参数，避免 request/page 逻辑重复。 - 同步补齐支付宝平台与支付客户端的中文 PHPDoc。
97 lines
2.7 KiB
PHP
97 lines
2.7 KiB
PHP
<?php
|
|
|
|
declare(strict_types=1);
|
|
|
|
/**
|
|
* 支付宝支付客户端。
|
|
*/
|
|
|
|
namespace We\Platform\Alipay;
|
|
|
|
use GuzzleHttp\ClientInterface;
|
|
use We\Config\AlipayPaymentConfig;
|
|
|
|
/**
|
|
* 支付宝支付客户端。
|
|
*
|
|
* 在支付宝开放平台网关能力之上提供电脑网站支付与交易退款快捷方法。
|
|
*/
|
|
final class PaymentClient extends PlatformClient
|
|
{
|
|
/**
|
|
* 创建支付宝支付客户端。
|
|
*/
|
|
public function __construct(AlipayPaymentConfig $config, ?ClientInterface $http = null)
|
|
{
|
|
parent::__construct($config, $http);
|
|
}
|
|
|
|
/**
|
|
* 调用支付宝交易退款接口 `alipay.trade.refund`。
|
|
*
|
|
* @param array<string,mixed> $bizContent
|
|
* @param array<string,mixed> $extra
|
|
* @return array<string,mixed>
|
|
*/
|
|
public function refund(array $bizContent, array $extra = []): array
|
|
{
|
|
return $this->request('alipay.trade.refund', $bizContent, $extra);
|
|
}
|
|
|
|
/**
|
|
* 生成电脑网站支付接口 `alipay.trade.page.pay` 跳转地址。
|
|
*
|
|
* @param array<string,mixed> $bizContent
|
|
*/
|
|
public function page(array $bizContent, array $extra = []): string
|
|
{
|
|
$params = $this->buildGatewayParams('alipay.trade.page.pay', $bizContent, $extra);
|
|
|
|
return $this->config->gateway . '?' . http_build_query($params);
|
|
}
|
|
|
|
/**
|
|
* 通用支付调用入口；特殊操作名用于电脑网站支付和退款快捷调用。
|
|
*
|
|
* @param array<string,mixed> $params
|
|
* @param array<string,mixed> $options
|
|
* @return array<string,mixed>
|
|
*/
|
|
public function call(string $uriOrPath, array $params = [], string $httpMethod = 'POST', array $options = []): array
|
|
{
|
|
$apiMethod = trim($uriOrPath);
|
|
if ($apiMethod === 'page') {
|
|
return ['url' => $this->page($params, $options)];
|
|
}
|
|
if ($apiMethod === 'refund') {
|
|
return $this->refund($params, $options);
|
|
}
|
|
|
|
return $this->request($apiMethod, $params, $options);
|
|
}
|
|
|
|
/**
|
|
* 按 POST 语义调用支付宝支付接口。
|
|
*
|
|
* @param array<string,mixed> $params
|
|
* @param array<string,mixed> $options
|
|
* @return array<string,mixed>
|
|
*/
|
|
public function post(string $uriOrPath, array $params = [], array $options = []): array
|
|
{
|
|
return $this->call($uriOrPath, $params, 'POST', $options);
|
|
}
|
|
|
|
/**
|
|
* 按 GET 语义调用支付宝支付接口。
|
|
*
|
|
* @param array<string,mixed> $params
|
|
* @param array<string,mixed> $options
|
|
* @return array<string,mixed>
|
|
*/
|
|
public function get(string $uriOrPath, array $params = [], array $options = []): array
|
|
{
|
|
return $this->call($uriOrPath, $params, 'GET', $options);
|
|
}
|
|
}
|