退款-创建全额退款申请

请求

POST http://order-test.hsifue.cn/refunds/apply

说明

创建退款申请, 该接口只支持全额退款申请

参数

参数名

参数类型

参数含义

是否必填

inputCharset

String(8)

字符编码, 固定为UTF-8

signType

String(8)

签名算法, 可选择SHA-256, SHA-1, MD5, 推荐使用SHA-256

appKey

String(32)

应用Key

outOrderId

String(100)

商户订单号

outRefundId

String(100)

商户退款单号(不允许重复)

refundAmount

Integer

退款金额, 单位为分, 当前仅支持按订单满额退款

applyReason

String(100)

申请退款的原因

g_signature

String

签名

请求示例

curl -X POST -d "appKey=QI3FPWF3AGBBOYrVQtBKHpotRaFdb0HG&applyReason=%E6%B5%8B%E8%AF%95%E9%AA%8C%E8%AF%81&inputCharset=UTF-8&outOrderId=202207191542&outRefundId=202207191542&refundAmount=1&signType=SHA-256&g_signature=9d0fc05b63b64a751d6772aec5c84f0f5631643f05169288984bc65b76c2fe45" http://order-test.hsifue.cn/refunds/apply

响应示例

{
  "code": "000000",
  "message": "成功",
  "data": {
    "id": 747058591206359040,
    "appKey": "QI3FPWF3AGBBOYrVQtBKHpotRaFdb0HG",
    "outRefundId": "202207191542",
    "orderId": "746796234496425984",
    "outOrderId": "202207191542",
    "refundStatus": 1,
    "refundAmount": 1,
    "payAmount": 1,
    "approveTime": null,
    "applyTime": 1658279113000,
    "applyReason": "测试验证",
    "rejectReason": null,
    "refundRequestSource": 1,
    "rejectTime": null
  }
}

响应报文

参数名

参数含义

类型

data.id

支付中心退款单号

Long

data.appKey

应用来源

String(32)

data.outRefundId

商户退款单号

String(100)

data.orderId

支付中心订单号

String(32)

data.outOrderId

商户订单号

String(100)

data.refundStatus

退款状态: 1申请中 2已完成 3已驳回

Integer

data.refundAmount

申请退款金额, 以分为单位

Integer

data.payAmount

订单收款金额, 以分为单位

Integer

data.approveTime

退款完成时间, Unix时间戳

Long

data.applyTime

申请时间, Unix时间戳

Long

data.applyReason

申请退款原因

String(100)

data.rejectReason

驳回原因

String(100)

业务状态码

code

message

备注

000000

成功

-

999999

系统异常

-

000008

签名不存在

-

000006

签名非法

-

000002

数据不存在

应用不存在

100006

商户退款单号已存在

-