PHPackages                             kode/pays - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Payment Processing](/categories/payments)
4. /
5. kode/pays

ActiveLibrary[Payment Processing](/categories/payments)

kode/pays
=========

Kode Pays - 企业级多平台聚合支付 SDK，支持微信、支付宝、云闪付、抖音支付、美团支付、京东支付、快手支付、QQ 支付、支付宝国际版、PayPal、Stripe、Square、Adyen、Amazon Pay、Klarna、Wise、Revolut、Payoneer、Apple Pay、Google Pay、HitPay、Xendit 等国内外主流支付渠道

1.19.0(3w ago)02Apache-2.0PHPPHP >=8.3

Since Apr 24Pushed 3w agoCompare

[ Source](https://github.com/kodephp/pays)[ Packagist](https://packagist.org/packages/kode/pays)[ Docs](https://github.com/kodephp/pays)[ RSS](/packages/kode-pays/feed)WikiDiscussions main Synced 3w ago

READMEChangelogDependencies (12)Versions (19)Used By (0)

Kode Pays SDK
=============

[](#kode-pays-sdk)

Kode Pays 是一个面向 PHP 8.3+ 的企业级多平台聚合支付 SDK，支持微信、支付宝、云闪付、抖音支付、美团支付、京东支付、快手支付、QQ 支付、支付宝国际版、PayPal、Stripe、Square、Adyen、Amazon Pay、Klarna、Wise、Revolut、Payoneer、Apple Pay、Google Pay、HitPay、Xendit 等国内外主流支付渠道。采用事件驱动、管道中间件、门面模式等现代架构设计，让开发者能够快速、安全、可扩展地接入各种支付能力。

特性
--

[](#特性)

- **多平台支持**：微信、支付宝、云闪付、抖音支付、美团支付、京东支付、快手支付、QQ 支付、支付宝国际版、PayPal、Stripe、Square、Adyen、Amazon Pay、Klarna、Wise、Revolut、Payoneer、Apple Pay、Google Pay、HitPay、Xendit、聚合支付
- **统一接口**：所有网关实现同一接口，切换渠道对业务代码完全无感知
- **聚合路由**：支持多渠道配置，自动优先级路由和失败切换
- **门面模式**：`Pay::wechat($config)` 一行代码创建网关
- **沙箱管理**：全局/按网关独立控制沙箱环境，测试不扣真实资金
- **事件驱动**：支付生命周期各阶段触发事件，解耦日志/监控/通知
- **管道中间件**：请求参数通过中间件栈处理，支持签名、日志、加密等
- **类型安全**：充分利用 PHP 8.3+ 特性（`readonly`、`match`、`enum`、`typed class constants`）
- **异常细分**：6 种具体异常子类，便于精确捕获和差异化处理
- **中文注释**：所有代码和文档均为中文，降低国内开发者学习成本
- **生态兼容**：预留 kode 系列扩展点（二维码、协程、缓存、数据库等）

环境要求
----

[](#环境要求)

- PHP >= 8.3
- ext-json
- ext-openssl
- Composer

安装
--

[](#安装)

```
composer require kode/pays
```

### 可选扩展（推荐）

[](#可选扩展推荐)

```
# 支付二维码生成
composer require kode/tools

# 依赖注入容器
composer require kode/di

# 订单缓存与分布式锁
composer require kode/cache

# 订单持久化与分库分表
composer require kode/database

# 协程支持
composer require kode/fibers

# 多进程支持
composer require kode/process

# 多线程支持
composer require kode/parallel

# 限流保护
composer require kode/limiting

# 异常处理增强
composer require kode/exception

# 门面模式增强
composer require kode/facade

# 日志记录（PSR-3 兼容）
composer require monolog/monolog
```

快速开始
----

[](#快速开始)

### 门面模式快速接入

[](#门面模式快速接入)

```