# payment

**Repository Path**: wenmoyin/payment

## Basic Information

- **Project Name**: payment
- **Description**: 对接支付多个支付公司sdk
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-02-23
- **Last Updated**: 2026-02-28

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Payment - PHP 8.0+ 支付库

一个现代化的 PHP 8.0+ 支付库，支持多种支付网关，包括微信支付、支付宝、QQ支付、银联等45个支付插件。

## 特性

- **PHP 8.0+** 严格类型声明
- **PSR-4/PSR-12** 标准编码规范
- **统一接口** 45个支付插件统一调用接口
- **配置整合** 相同支付方式的配置整合
- **GuzzleHTTP** 基于 GuzzleHTTP 的 HTTP 客户端
- **自动适配** 自动生成适配器，兼容旧版插件
- **扩展性强** 支持自定义网关和适配器

## 支持的支付方式（45个插件）

### 微信支付系列 (4个)
- `wxpay` - 微信官方支付
- `wxpayn` - 微信支付(新版)
- `wxpaynp` - 微信支付(非官方)
- `wxpaysl` - 微信支付(手续费版)

### 支付宝系列 (6个)
- `alipay` - 支付宝官方支付
- `aliold` - 支付宝旧版
- `alipaybill` - 支付宝账单
- `alipayd` - 支付宝D版
- `alipayrp` - 支付宝退款版
- `alipaysl` - 支付宝手续费版

### QQ支付 (1个)
- `qqpay` - QQ钱包支付

### 银联/银行支付 (3个)
- `unionpay` - 银联支付
- `chinaums` - 银联在线支付
- `allinpay` - 通联支付

### 第三方支付 (30+个)
- `swiftpass` - 威富通
- `swiftpass2` - 威富通2
- `jeepay` - 极支付
- `epay` - 易支付
- `xorpay` - XorPay
- `xunhupay` - 虎皮椒支付
- `ympay` - YM支付
- `ysepay` - 银盛支付
- `duolabao` - 哆啦宝
- `huifu` - 汇付
- `jdpay` - 京东支付
- `sandpay` - 杉德支付
- `umfpay` - 联动支付
- `fubei` - 付贝
- `fuiou` - 付钱拉
- `heepay` - 汇付宝
- `hnapay` - 海鸟支付
- `jinyihui` - 金一汇
- `kayixin` - 凯易信
- `ltzf` - 龙腾支付
- `mirfupay` - 米富支付
- `passpay` - 帕斯支付
- `vmq` - VMQ
- `woaizf` - 我爱支付
- `zhangyishou` - 章鱼手
- `zyu` - ZYU

### 国际支付 (2个)
- `stripe` - Stripe
- `paypal` - PayPal

## 安装

```bash
composer require spore/payment-gateway
```

## 快速开始

### 初始化应用

```php
<?php
declare(strict_types=1);

use Payment\Payment\Manager;

$config = [
    // 默认支付方式
    'default' => 'wechat',

    // 微信支付配置
    'wechat' => [
        'appid' => 'wx1234567890',
        'mch_id' => '1234567890',
        'secret_key' => 'your_v3_secret_key',
        'v2_secret_key' => 'your_v2_secret_key',
        'private_key' => 'your_private_key',
        'certificate' => 'your_certificate',
    ],

    // 支付宝配置
    'alipay' => [
        'appid' => '2021234567890',
        'private_key' => 'your_private_key',
        'public_key' => 'your_public_key',
    ],

    // QQ支付配置
    'qqpay' => [
        'appid' => 'your_qq_appid',
        'mch_id' => 'your_qq_mchid',
        'secret_key' => 'your_qq_secret_key',
    ],

    // 第三方支付配置（以威富通为例）
    'swiftpass' => [
        'appid' => 'your_swiftpass_appid',
        'appmchid' => 'your_swiftpass_mchid',
        'appkey' => 'your_swiftpass_key',
        'api_url' => 'https://pay.swiftpass.com/api',
    ],
];

$app = new Manager($config);
```

### 使用微信支付

```php
// 微信扫码支付
$wechat = $app->wechat();
$response = $wechat->pay([
    'out_trade_no' => 'ORDER' . time(),
    'total_fee' => 100, // 单位：分
    'body' => '商品描述',
    'trade_type' => 'native',
]);
$qrCodeUrl = $response->get('code_url');
```

### 使用支付宝支付

```php
// 支付宝电脑网站支付
$alipay = $app->alipay();
$response = $alipay->pay([
    'out_trade_no' => 'ORDER' . time(),
    'total_amount' => '1.00',
    'subject' => '商品标题',
    'product_code' => 'FAST_INSTANT_TRADE_PAY',
]);
```

### 使用微信支付系列其他版本

```php
// 微信支付新版
$wxpayn = $app->gateway('wxpayn');
$response = $wxpayn->pay([...]);

// 微信支付非官方版
$wxpaynp = $app->gateway('wxpaynp');
$response = $wxpaynp->pay([...]);

// 微信支付手续费版
$wxpaysl = $app->gateway('wxpaysl');
$response = $wxpaysl->pay([...]);
```

### 使用支付宝系列其他版本

```php
// 支付宝旧版
$aliold = $app->gateway('aliold');
$response = $aliold->pay([...]);

// 支付宝账单
$alipaybill = $app->gateway('alipaybill');
$response = $alipaybill->pay([...]);
```

### 使用QQ支付

```php
$qqpay = $app->qqpay();
$response = $qqpay->pay([
    'out_trade_no' => 'ORDER' . time(),
    'total_fee' => 100,
    'body' => '商品描述',
    'trade_type' => 'native',
]);
```

### 使用银联支付

```php
$unionpay = $app->gateway('unionpay');
$response = $unionpay->pay([
    'out_trade_no' => 'ORDER' . time(),
    'total_fee' => 100,
    'body' => '商品描述',
    'trade_type' => 'page',
]);
```

### 使用第三方支付（以威富通为例）

```php
$swiftpass = $app->gateway('swiftpass');
$response = $swiftpass->pay([
    'out_trade_no' => 'ORDER' . time(),
    'total_fee' => 100,
    'body' => '商品描述',
    'trade_type' => 'native',
]);
```

### 使用国际支付

```php
// Stripe支付
$stripe = $app->gateway('stripe');
$response = $stripe->pay([
    'out_trade_no' => 'ORDER' . time(),
    'total_amount' => '10.00',
    'currency' => 'usd',
    'description' => 'Product description',
    'payment_method' => 'card',
]);

// PayPal支付
$paypal = $app->gateway('paypal');
$response = $paypal->pay([
    'out_trade_no' => 'ORDER' . time(),
    'total_amount' => '10.00',
    'description' => 'Product description',
]);
```

## 配置

完整配置请参考 [config/payment.php](config/payment.php)

## 插件适配器

所有45个支付插件都已通过适配器模式整合到新架构中：

1. **原生网关类** - wxpay、alipay 等官方支付使用原生实现的网关类
2. **专用适配器** - wxpayn、wxpaynp、aliold 等使用专用适配器
3. **通用适配器** - 其他插件使用通用适配器自动适配

## 开发规范

本项目严格遵循 [CLAUDE.md](CLAUDE.md) 中定义的编码规范。

## 测试

```bash
composer test
```

## 许可证

MIT License