退款
优质
小牛编辑
135浏览
2023-12-01
说明
支付宝境外在线支付-退款
官方文档：https://global.alipay.com/service/website_split_cn/11
类
请求参数类
请求参数
类名：\Yurun\PaySDK\AlipayCrossBorder\Online\Refund\Request
属性
| 名称 | 类型 | 说明 |
|---|---|---|
| $service | string | 接口名称 |
| $out_return_no | string | 外部退款请求的ID |
| $out_trade_no | string | 境外商户交易号（确保在境外商户系统中唯一） |
| $return_amount | double | 外币退款金额 |
| $currency | string | 外币币种 |
| $gmt_return | string | YYYYMMDDHHMMSS 北京时间(+8) |
| $return_rmb_amount | double | 人民币退款金额 |
| $reason | string | 退款原因 |
| $product_code | string | 产品代码 网站支付: NEW_OVERSEAS_SELLER 手机浏览器或支付宝钱包支付: NEW_WAP_OVERSEAS_SELLER |
| $split_fund_info | array<\Yurun\PaySDK\AlipayCrossBorder\Params\SplitFundInfo> | 分账信息 |
| $_syncResponseName | string | 支付宝返回的json中xxx_response的名字 |
| $_method | string | 接口请求方法 |
| $_isSyncVerify | boolean | 是否同步返回验证 |
分账信息
属性
| 名称 | 类型 | 说明 |
|---|---|---|
| $transIn | string | 接受分账资金的支付宝账户ID。以2088开头的纯16位数字。 |
| $amount | double | 分账的金额。格式必须符合相应币种的要求，比如：日元为整数，人民币最多２位小数。当分账币种是CNY时，此金额代表的是人民币；如果分账币种是外币时，此金额则是外币。但分账商户实际收到的金额始终是人民币，如果分账明细中是外币，分账商户得到的人民币实际是通过汇率进行计算得到的。数值（小数点后最多2位） |
| $currency | string | 分账币种。如果total_fee不为空，则分账币种必须是外币，且与结算币种一致；如果rmb_fee不为空，则分账币种必须是人民币。人民币填写“CNY”，外币请参见“币种列表”。 |
| $desc | string | 分账描述信息 |
简单使用
// 支付接口
$request = new \Yurun\PaySDK\AlipayCrossBorder\Online\Refund\Request;
$request->out_return_no = date('Ymd') . mt_rand(100, 99999999); // 退款订单号
$request->out_trade_no = 'test37132408'; // 要退款订单的订单号
$request->return_amount = 0.01;
$request->currency = 'USD';
$request->product_code = 'NEW_OVERSEAS_SELLER';
// 调用接口
$result = $pay->execute($request);
var_dump('result:', $result);
var_dump('success:', $pay->checkResult());
var_dump('error:', $pay->getError(), 'error_code:', $pay->getErrorCode());
详见：test/AlipayCrossBorder/Online/refund.php