wenwenpay/php-sdk

稳稳代付 PHP SDK

This package's canonical repository appears to be gone and the package has been frozen as a result.

1.0.1 2025-03-01 03:32 UTC

This package is not auto-updated.

Last update: 2025-04-27 02:41:29 UTC


README

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

环境要求

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

安装

通过 Composer 安装:

composer require wenwenpay/php-sdk

快速开始

配置初始化

use WenwenPay\Config\Config;
use WenwenPay\PaymentService;

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

查询余额

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

发起代付

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();
}

查询订单详情

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

查询订单列表

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 到最新版本

参考文档

注意事项

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