# 1.1 退款接口

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