# 1.1 退款接口
# 简要描述
- 退款接口
# 请求URL
/api/v2/payment/refund
# 请求方式
- POST
# 请求参数
| 参数名 | 必选 | 类型 | 长度 | 说明 |
|---|---|---|---|---|
| appId | 是 | string | - | 应用APPID |
| mchRefundOrderId | 是 | string | 1-32 | 商户-退款编号, 商户系统唯一标识,格式:字母+数字,1-32位,如:CCP20220428011068111 |
| originalTransactionId | 是 | string | - | 原交易流水号 |
| subOrderId | 是 | string | - | 运单号 |
| refundAmount | 是 | int | - | 退款金额(以分为单位,例如PHP:500.10, 需要设置为50010) |
| refundReason | 否 | string | - | 退款原因 |
| refundCallbackUrl | 是 | string | - | 退款回调Url |
| sign | 是 | string | - | 签名 |
# 返回示例
{
"code": 1000,
"message": "success",
"data": {
"mchRefundOrderId": "CCP20220428011068111",
"refundTransactionId": "R420220428004148975",
"refundAmount": 100,
"refundCreateTime": "2024-04-17 18:12:46",
"refundStatus": "PENDING"
}
}
# 返回失败案例 响应code列表 (opens new window)
{
"code":1002,
"message":"merchant white ip forbidden",
}