简介

退款接口用于处理订单金额的返还操作，支持多种退款场景（如退货退款、取消订单等）。

支付流程

请求方法

方法 路径 描述
POST /api/reference/endpoints/payment/refund 提交退款申请

路径参数

  • order_id (必填): 订单唯一标识符
  • refund_amount (必填): 退款金额（单位：元）
  • reason (可选): 退款原因（如"商品质量问题"、"用户取消"）

请求体示例

{
  "order_id": "20231015001",
  "refund_amount": 150.00,
  "reason": "商品质量问题"
}

响应示例

✅ 成功响应:

{
  "status": "success",
  "message": "退款申请已受理",
  "refund_id": "RF20231015001"
}

❌ 失败响应:

{
  "status": "fail",
  "message": "订单状态异常，无法退款"
}

使用示例

curl -X POST https://api.example.com/api/reference/endpoints/payment/refund \
-H "Content-Type: application/json" \
-d '{"order_id": "20231015001", "refund_amount": 150.00, "reason": "商品质量问题"}'

相关资源

退款状态