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
Requires
- php: >=8.0
- ext-curl: *
- ext-json: *
Requires (Dev)
- phpunit/phpunit: ^9.0
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 进行异常处理。
安全建议
- 请妥善保管 secret_key,不要泄露给他人
- 建议使用 HTTPS 传输数据
- 生产环境关闭 PHP 错误输出
- 定期更新 SDK 到最新版本
参考文档
注意事项
- 当前版本为了兼容性考虑,暂时禁用了 SSL 证书验证
- 建议在生产环境中使用 HTTPS 代理或 VPN 确保传输安全
- 后续版本会提供更完善的 SSL 证书配置选项