支付增值服务
接口列表
储值余额和礼品卡
线上退充值

线上退充值

创建退充值订单,用户退充值成功后,会退还充值金额。

接口说明

请求方式:
post
https://p.wecard.tencent.com/cloudpay/v1/wallet/out/create_refund_recharge_order

请求参数

Request
Body 包体
OutRefundRechargeId必填
string

外部退充值订单号,即业务系统侧退款单号

最小长度:6     最大长度:60

OutRechargeId必填
string

外部充值订单号,即业务系统侧订单号

最小长度:6     最大长度:60

RefundRechargeAmount必填
integer

退充值金额,单位:分


Remark选填
string

退款备注

最小长度:1     最大长度:128

RefundReason选填
string

退款原因

最小长度:1     最大长度:128

ExternalRefundData选填
string

退款渠道扩展字段,第三方通道的扩展信息,根据具体对接的渠道情况传值; 该字段为 json 序列化之后的字符

最小长度:1     最大长度:1000

NotifyUrl选填
string

退款成功后的回调地址

最小长度:1     最大长度:255

FundAllocateList选填
array

退挂账信息。支付通道耦合银行账户体系时必填,否则不用。

数组子类型:object

请求示例

{
  "OutRefundRechargeId": "demo202211200001refund",
  "OutRechargeId": "demo202211200001",
  "RefundRechargeAmount": 1000,
  "Remark": "备注",
  "RefundReason": "退款原因",
  "NotifyUrl": "https://zhifu.com/refund/notify"
}

返回参数

Response
Response必填
object

返回示例

{
  "Response": {
    "RequestId": "A8E7B797ADD44C3AA57E87AD7420A725",
    "Result": {
      "OutRefundRechargeId": "demo202211200001refund",
      "OutRechargeId": "demo202211200001",
      "RefundRechargeStatus": "PROCESSING",
      "RefundMessage": "退款中",
      "RefundRechargeAmount": "1000"
    },
    "ErrCode": "SUCCESS",
    "ErrMessage": "成功"
  }
}

腾讯微卡收付通接口文档