退款
测试环境
https://xyf-server-test.postar.cn
测试环境
https://xyf-server-test.postar.cn
POST
/yyfsevr/order/refund
使用场景：商户、ISV、应用开发者
1.
2.
3.
4.
5.
6.
7.
8.
a. 先算出 退款金额比率=退款金额/原交易金额（四舍五入保留小数点后10位）
b. 退款手续费= 原订单手续费*退款金额比率（单位精确分小数后不保留）
c.如退款金额为最后一笔对应退款取剩余退款手续费
案例：
原交易金额：10000
退款金额：5414.14
退款比率：0.5414140000
原手续费 ：0.99
退款手续费：0.99 * 0.5414140000=0.53599986
小数点保留到分最终结果：0.53
如果第二笔订单退款金额4585.86
此时剩余退款金额为4585.86与退款金额一致：
相当于把剩下交易金额全部退掉
退款手续费算法为 ： 原退款手续费-已退款手续费 即：0.99-0.53=0.46
| 错误信息 | 原因 |
|---|---|
| 未查询到该订单,或原订单未交易成功 | A1：正向交易未发起成功。 A2：原三方订单号或者原国通订单号或者原第三方通道号不正确。 A3：tag字段不正确。 A4：退历史订单时未传原交易日期originTradeDate。 |
| 该订单暂不支持退款 | A1：tag不对。 A2：原订单未交易成功。 |
| 该分账订单暂不支持退款 | 商圈不支持退款，对接群里找运营配置。 |
| 当前商户结算中，暂不允许退款 | 不在分账商圈配置的可退款时间内。 |
| 涉及已结算资金，请在xx-次日xx操作 | 当天的收款金额不够退款。 |
| 余额不足，不允许退款 | 账户余额不足。 |
| 商户不支持退货，请联系管理员 | 商户进件时没有开启退款权限（refPower=1），可调商户修改接口重新开启，或反馈运营开启 |
| 风险商户无法退款 | 商户处在灰名单中，被风控了，可咨询客服解除风控 |
请求参数
Header 参数
Body 参数application/json
返回响应
请求示例请求示例
Java
Shell
C#
PHP
响应示例响应示例
{
"code": "string",
"msg": "string",
"data": {
"agetId": "string",
"custId": "string",
"orderFlowNo": "string",
"threeOrderNo": "string",
"orderStatus": "string",
"orderTime": "string",
"sucOrderTime": "string",
"refundFee": "string",
"oldFee": "string",
"discountFee": "string",
"reAgetSubsidy": "string",
"reCustAmt": "string",
"orderType": "string",
"promotionDetail": "string",
"voucherDetailList": "string",
"fundBillList": "string",
"reserveFlag": "string",
"realRefundAmt": "string"
}
}修改于 2026-03-30 05:47:26