交易结算
优质
小牛编辑
165浏览
2023-12-01
说明
统一收单交易结算接口SDK。
官方文档：https://docs.open.alipay.com/api_1/alipay.trade.order.settle/
类
请求参数类
请求参数
类名：\Yurun\PaySDK\AlipayApp\Params\Settle\Request
属性
| 名称 | 类型 | 说明 |
|---|---|---|
| $method | string | 接口名称 |
| $app_auth_token | string | 详见：https://docs.open.alipay.com/common/105193 |
| $businessParams | \Yurun\PaySDK\AlipayApp\Params\Settle\BusinessParams | 业务请求参数 参考https://docs.open.alipay.com/api_1/alipay.trade.order.settle/ |
| $_syncResponseName | string | 支付宝返回的json中xxx_response的名字 |
| $_method | string | 接口请求方法 |
| $_isSyncVerify | boolean | 是否同步返回验证 |
业务请求参数
类名：\Yurun\PaySDK\AlipayApp\Params\Settle\BusinessParams
属性
| 名称 | 类型 | 说明 |
|---|---|---|
| $out_request_no | string | 结算请求流水号 开发者自行生成并保证唯一性 |
| $trade_no | string | 支付宝订单号 |
| $royalty_parameters | array<\Yurun\PaySDK\AlipayApp\Params\Settle\RoyaltyParameter> | 分账明细信息 |
| $operator_id | string | 操作员id |
简单使用
// SDK实例化，传入公共配置
$pay = new \Yurun\PaySDK\AlipayApp\SDK($params);
// 支付接口
$request = new \Yurun\PaySDK\AlipayApp\Params\Settle\Request;
$request->notify_url = $GLOBALS['PAY_CONFIG']['notify_url']; // 结果通知地址
$request->businessParams->out_trade_no = ''; // 结算请求流水号 开发者自行生成并保证唯一性
$request->businessParams->trade_no = ''; // 支付宝订单号
$param = new Yurun\PaySDK\AlipayApp\Params\Settle\RoyaltyParameter;
$param->trans_out = ''; // 分账支出方账户，类型为userId，本参数为要分账的支付宝账号对应的支付宝唯一用户号。以2088开头的纯16位数字。
$param->trans_in = ''; // 分账收入方账户，类型为userId，本参数为要分账的支付宝账号对应的支付宝唯一用户号。以2088开头的纯16位数字。
$param->amount = ''; // 分账的金额，单位为元
$param->amount_percentage = ''; // 分账信息中分账百分比。取值范围为大于0，少于或等于100的整数。
$param->desc = ''; // 分账描述
$request->businessParams->royalty_parameters[] = $param;
// 调用接口
$result = $pay->execute($request);
var_dump('result:', $result);
var_dump('success:', $pay->checkResult());
var_dump('error:', $pay->getError(), 'error_code:', $pay->getErrorCode());
详见：test/AlipayApp/settle.php