# 稳稳代付SDK

**Repository Path**: chasechan/wenwenpay-sdk

## Basic Information

- **Project Name**: 稳稳代付SDK
- **Description**: 稳稳代付 PHP SDK 提供了简单易用的接口，帮助快速接入稳稳代付系统。
- **Primary Language**: PHP
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-03-01
- **Last Updated**: 2025-03-04

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 稳稳代付 PHP SDK

稳稳代付 PHP SDK 提供了简单易用的接口，帮助快速接入稳稳代付系统。

## 环境要求

* PHP >= 8.0
* ext-curl
* ext-json

## 安装

通过 Composer 安装:

```bash
composer require wenwenpay/php-sdk
```

## 快速开始

### 配置初始化

```php
use WenwenPay\Config\Config;
use WenwenPay\PaymentService;

$config = new Config('your_agent_no', 'your_secret_key');
$payment = new PaymentService($config);
```

### 查询余额

```php
try {
    $result = $payment->amount();
    if ($result['success']) {
        echo "可用余额: " . $result['responseData']['amount'];
    }
} catch (\WenwenPay\Exception\PaymentException $e) {
    echo "查询失败: " . $e->getMessage();
    print_r($e->getData());
}
```

### 发起代付

```php
try {
$result = $payment->transfer([
    'id_card_no' => '330327095X', // 身份证号
    'bank_card_no' => '6214837232', // 银行卡号
    'phone' => '1580922', // 手机号
    'name' => '张三', // 姓名
    'amount' => '1.00', // 金额
    'client_tx_order_no' => '202403150001', // 商户订单号(可选)
    'client_customize_element' => 'A', // 客户端自定义字段(可选)
]);
if ($result['success']) {
    echo "代付订单号: " . $result['responseData']['payrollId'];
}
} catch (\WenwenPay\Exception\PaymentException $e) {
    echo "代付失败: " . $e->getMessage();
}
```

### 查询订单详情

```php
try {
    $result = $payment->query('payroll_id');
if ($result['success']) {
    echo "订单状态: " . $result['responseData']['status'];
}
} catch (\WenwenPay\Exception\PaymentException $e) {
    echo "查询失败: " . $e->getMessage();
}
```

### 查询订单列表

```php
try {
$result = $payment->list([
    'page_number' => '1',
    'page_limit' => '10',
    'start_date' => '2024-03-01',
    'end_date' => '2024-03-15'
]);
} catch (\WenwenPay\Exception\PaymentException $e) {
    echo "查询失败: " . $e->getMessage();
}
```

## 异常处理

SDK 定义了以下异常类:

* `PaymentException` - 支付相关错误
* `InvalidConfigException` - 配置错误
* `InvalidResponseException` - 响应格式错误

建议使用 try-catch 进行异常处理。

## 安全建议

1. 请妥善保管 secret_key，不要泄露给他人
2. 建议使用 HTTPS 传输数据
3. 生产环境关闭 PHP 错误输出
4. 定期更新 SDK 到最新版本

## 参考文档

* [完整接口文档](docs/api.md)

### 注意事项

1. 当前版本为了兼容性考虑，暂时禁用了 SSL 证书验证
2. 建议在生产环境中使用 HTTPS 代理或 VPN 确保传输安全
3. 后续版本会提供更完善的 SSL 证书配置选项