支付增值服务
接口列表
储值余额和礼品卡
退充值成功通知

退充值成功通知

退充值成功通知

⚠️

对后台通知交互时,如果收付通收到应答不是成功或超时,收付通认为通知失败,收付通会通过一定的策略定期重新发起通知,尽可能提高通知的成功率,但收付通不保证通知最终能成功

  • 同样的通知可能会多次发送给商户系统。商户系统必须能够正确处理重复的通知。 推荐的做法是,当商户系统收到通知进行处理时,先检查对应业务数据的状态,并判断该通知是否已经处理。如果未处理,则再进行处理;如果已处理,则直接返回结果成功。在对业务数据进行状态检查和处理之前,要采用数据锁进行并发控制,以避免函数重入造成的数据混乱。

  • 如果在一定时间内(推荐60s)或所有通知频率后没有收到收付通侧回调。商户应调用查询退充值订单接口确认订单状态。

特别提醒: 商户系统对于开启结果通知的内容一定要做签名验证,并校验通知的信息是否与商户侧的信息一致,防止数据泄露导致出现“假通知”,造成资金损失。

通知规则

用户在退充值成功后,微卡收付通平台将通知商户系统退充值结果,商户系统接收处理,并返回应答。

商户系统对收付通的回调通知进行验签,在处理成功后需要响应 200 HTTP 状态码。验签方式见:回调请求验签

对后台通知交互时,如果收付通收到应答不是成功或超时,收付通认为通知失败,收付通会通过一定的策略定期重新发起通知,尽可能提高通知的成功率,但收付通不保证通知最终能成功。(通知频率为 5/5/10/30/60/60/60/60/60/60,单位:秒)

接口说明

请求方式:
post
接入方退充值成功回调地址

请求参数

Request
Body 包体
OutRefundRechargeId必填
string

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


ChannelRefundRechargeId必填
string

微卡退充值订单号,针对本金钱包退充值


ThirdRefundRechargeId必填
string

收单方退款订单号,针对本金钱包退充值


OutRechargeId必填
string

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


ChannelRechargeId必填
string

原微卡充值订单号,针对本金钱包充值


RefundRechargeStatus必填
string

退款状态。SUCCESS:退款成功;FAILED:退款失败;PROCESSING:退款中。


RefundMessage必填
string

退款返回描述,比如失败原因等。


RefundRechargeAmount必填
integer

退充值金额,单位:分


PayerId必填
string

付款方ID


WalletId必填
string

钱包ID


RefundFinishTime必填
string

退充值成功时间。RFC3339 格式

请求示例

{
  "OutRefundRechargeId": "demo202211200001refund",
  "ChannelRefundRechargeId": "xxx",
  "ThirdRefundRechargeId": "xxx",
  "OutRechargeId": "demo202211200001",
  "ChannelRechargeId": "xxx",
  "RefundRechargeStatus": "SUCCESS",
  "RefundMessage": "成功",
  "RefundRechargeAmount": 1000,
  "PayerId": "xxx",
  "WalletId": "xxx",
  "RechargeTime": "2015-05-20T13:29:35+08:00"
}

返回参数

Response

返回示例

""

商户系统如果接受并处理回调通知成功,需要返回 200 HTTP 状态码,否则需要返回 5xx 或 4xx 的 HTTP 状态码。 如果接受失败,可以返回 message 字段表述处理失败原因。


腾讯微卡收付通接口文档