# BSPHP 收费管理系统 API 集成说明

简体中文 | [繁體中文](#繁體中文) | [English](#english)

---

## 简体中文

### 项目简介

BSPHP 是面向收费管理场景的专业 API 接口系统，支持开发者快速集成到现有软件中。  
系统覆盖后台管理、代理中心、用户中心、API 接口、WEB 接口与插件开发能力。

- 支持多语言切换：简体中文、繁体中文、English
- 支持多种编程语言与接口对接方式（HTTP API / WEB / 插件）
- 支持二次开发：核心代码加密，插件模块全源码开放
- 提供演示测试与授权测试，支持无条件退款（100% 放心购买）

### 开发者快速接入

1. 获取接口地址、`mutualkey`、密钥对等参数。  
2. 在示例项目配置文件中填写参数：
   - `BSPHP_API_URL`
   - `BSPHP_MUTUAL_KEY`
   - `BSPHP_SERVER_PRIVATE_KEY_B64`
   - `BSPHP_CLIENT_PUBLIC_KEY_B64`
3. 使用示例客户端发起加密请求（AES-128-CBC + RSA PKCS1）。
4. 根据业务需要接入登录模式（`.lg`）或卡模式（`.ic`）接口。
5. 按需扩展插件或进行二次开发。

### 目录结构说明

```text
BSPHP-C-DEMO/
├─ BSPHP-C-DEMO-LOGIN/        # 登录模式示例（.lg）
│  ├─ main.c                  # 示例入口
│  ├─ bsphp_client.c/.h       # 客户端请求封装
│  ├─ bsphp_crypto.c/.h       # 加密模块（MD5/AES/RSA）
│  ├─ bsphp_config.h          # 接口与密钥配置
│  └─ README.md               # 登录模式说明
├─ BSPHP-C-DEMO-CARD/         # 卡模式示例（.ic）
│  ├─ main.c                  # 示例入口
│  ├─ bsphp_client.c/.h       # 客户端请求封装
│  ├─ bsphp_crypto.c/.h       # 加密模块
│  ├─ bsphp_config.h          # 接口与密钥配置
│  └─ README.md               # 卡模式说明
└─ 目录项目文件作用说明.md      # 详细目录/文件用途说明
```

---

## 繁體中文

### 專案簡介

BSPHP 是面向收費管理場景的專業 API 介接系統，可讓開發人員快速整合到既有軟體。  
系統涵蓋後台管理、代理中心、使用者中心、API 介面、WEB 介面與外掛開發能力。

- 支援多語言切換：簡體中文、繁體中文、English
- 支援多種程式語言與介接方式（HTTP API / WEB / 外掛）
- 支援二次開發：核心程式碼加密，外掛模組全原始碼開放
- 提供展示測試與授權測試，支援無條件退款（100% 放心購買）

### 開發者快速整合

1. 取得 API 位址、`mutualkey`、金鑰參數。  
2. 在範例專案設定檔填入：
   - `BSPHP_API_URL`
   - `BSPHP_MUTUAL_KEY`
   - `BSPHP_SERVER_PRIVATE_KEY_B64`
   - `BSPHP_CLIENT_PUBLIC_KEY_B64`
3. 透過範例客戶端送出加密請求（AES-128-CBC + RSA PKCS1）。
4. 依需求整合登入模式（`.lg`）或卡模式（`.ic`）介面。
5. 可依專案需求擴充外掛與二次開發。

### 目錄結構說明

```text
BSPHP-C-DEMO/
├─ BSPHP-C-DEMO-LOGIN/        # 登入模式範例（.lg）
├─ BSPHP-C-DEMO-CARD/         # 卡模式範例（.ic）
└─ 目錄專案檔案作用說明.md     # 詳細目錄/檔案用途說明（中文）
```

---

## English

### Overview

BSPHP is a professional API integration solution for billing and charging management software.  
It helps developers integrate APIs quickly into existing systems.

The platform includes:

- Admin Backend
- Agent Center
- User Center
- API Interfaces
- Web Interfaces
- Plugin Development Support

Additional highlights:

- Multi-language support: Simplified Chinese, Traditional Chinese, and English
- Broad language/runtime integration support via standard HTTP API
- Secondary development supported (core encrypted, plugin source code open)
- Demo testing and licensed testing available, with unconditional refund support

### Quick Integration for Developers

1. Prepare endpoint URL, `mutualkey`, and key pairs.
2. Configure the demo project:
   - `BSPHP_API_URL`
   - `BSPHP_MUTUAL_KEY`
   - `BSPHP_SERVER_PRIVATE_KEY_B64`
   - `BSPHP_CLIENT_PUBLIC_KEY_B64`
3. Use the demo client to send encrypted requests (AES-128-CBC + RSA PKCS1).
4. Choose and integrate required APIs:
   - Login mode (`.lg`)
   - Card mode (`.ic`)
5. Extend functionality with plugin-based secondary development.

### Repository Structure

```text
BSPHP-C-DEMO/
├─ BSPHP-C-DEMO-LOGIN/        # Login mode demo
├─ BSPHP-C-DEMO-CARD/         # Card mode demo
└─ 目录项目文件作用说明.md      # Detailed file/folder explanation (Chinese)
```

---

## Contact & Testing

- You can test with the demo environment first.
- You can also purchase a license for full testing.
- Unconditional refund is supported for risk-free adoption.

