跳到主要内容

pay.refunds.submit

提交退款

  • 请求路由: pay.refunds.submit
  • 交互模型: Request Response
  • 访问限制: 无

请求​

RSocket.rr({
"route" : "pay.refunds.submit",
"data" : {
"outTradeNo" : "CCO202311301551433036",
"paymentPlatform" : "wexin",
"subOutTradeNo" : "CCO202311301551433036-2",
"applicationId" : "A1002",
"amount" : 1,
"refundPayer" : {
"targetType" : "CHANNEL",
"targetId" : "CH1001",
"targetName" : "渠道1001"
},
"source" : "order",
"reason" : "行程冲突",
"remark" : "客户取消订单"
}
});

请求参数​

名称类型必须说明
outTradeNoString是相关订单编号
paymentPlatformString是所属支付平台
  • weixin - 微信支付
  • douyin - 抖音
  • alipay - 支付宝
  • subOutTradeNoString否合单支付时指定子订单编号
    普通支付无须提供该参数
    applicationIdString是申请编号
    amountNumber是退款金额
    offlineAmountNumber否其中线下退款部分的金额
    必须不能大于amount。大于0时,在退款支付操作后,会自动生成线下支付
    refundPayerObject否退款出资方
    未指定时默认为订单收款人
    refundPayer.targetTypeString否帐户类型
    由调用方根据分账方身份类型定义,例如:COMPANY,PARTNER,CHANNEL等
    refundPayer.targetIdString否targetType下的帐户标识
    refundPayer.targetNameString否帐户名
    sourceString否退款来源
    - order 订单
    reasonString否退款原因简要说明
    长度80字符
    remarkString否退款详细备注
    refundAttachmentsObject[]否退款附件
    refundAttachments.[].titleString否附件标题
    refundAttachments.[].descriptionString否附件说明
    refundAttachments.[].binaryIdString[]否附件id

    返回​

    提交的数据

    { }

    返回属性​

    名称类型说明
    refundNoString退款单号
    outTradeNoString相关订单编号
    paymentPlatformString所属支付平台
  • weixin - 微信支付
  • douyin - 抖音
  • alipay - 支付宝
  • subOutTradeNoString合单支付时指定子订单编号
    普通支付无须提供该参数
    applicationIdString申请编号
    amountNumber退款金额
    offlineAmountNumber其中线下退款部分的金额
    必须不能大于amount。大于0时,在退款支付操作后,会自动生成线下支付
    refundPayerObject退款出资方
    未指定时默认为订单收款人
    refundPayer.targetTypeString帐户类型
    由调用方根据分账方身份类型定义,例如:COMPANY,PARTNER,CHANNEL等
    refundPayer.targetIdStringtargetType下的帐户标识
    refundPayer.targetNameString帐户名
    sourceString退款来源
    - order 订单
    reasonString退款原因简要说明
    长度80字符
    remarkString退款详细备注
    refundAttachmentsObject[]退款附件
    refundAttachments.[].titleString附件标题
    refundAttachments.[].descriptionString附件说明
    refundAttachments.[].binaryIdString[]附件id
    rejectReasonString驳回时填写驳回原因
    statusString退款状态:
    SUCCESS—退款成功
    CLOSED—退款关闭。
    PROCESSING—退款处理中
    ABNORMAL—退款异常,退款到银行发现用户的卡作废或者冻结了,导致原路退款银行卡失败,可前往商户平台(pay.weixin.qq.com)-交易中心,手动处理此笔退款。
    successTimeString退款成功时间

    下载结果模型定义