充值成功通知

⚠️

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

同样的通知可能会多次发送给商户系统。商户系统必须能够正确处理重复的通知。推荐的做法是，当商户系统收到通知进行处理时，先检查对应业务数据的状态，并判断该通知是否已经处理。如果未处理，则再进行处理；如果已处理，则直接返回结果成功。在对业务数据进行状态检查和处理之前，要采用数据锁进行并发控制，以避免函数重入造成的数据混乱。
如果在一定时间内(推荐60s)或所有通知频率后没有收到收付通侧回调。商户应调用查询充值订单接口确认订单状态。

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

通知规则

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

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

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

接口说明

请求方式：

post

接入方充值成功回调地址

请求参数

Request

Body 包体

OutRechargeId必填

string

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

ChannelRechargeId必填

string

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

ThirdRechargeId必填

string

收单方订单号，针对本金钱包充值

PayerId必填

string

付款方 ID

RechargeAmount必填

string

充值金额，分。如果是购买礼品卡，则值为 0

GiftAmount必填

string

赠送金额，分。如果是购买礼品卡，则值为 0

CardBatchId必填

string

礼品卡批次 ID。如果是充值，则值为空字符串

CardQuantity必填

string

礼品卡张数。如果是充值，则值为 0

RechargeTime必填

string

充值成功时间。RFC3339 格式

Attachment选填

string

附加信息，在查询API和支付通知中原样返回，可作为自定义参数使用

请求示例

{
  "OutRechargeId": "xxx",
  "ChannelRechargeId": "xxx",
  "ThirdRechargeId": "xxx",
  "PayerId": "xxx",
  "RechargeAmount": "100",
  "GiftAmount": "0",
  "CardBatchId": "abcxxx",
  "CardQuantity": 0,
  "RechargeTime": "2015-05-20T13:29:35+08:00"
}

返回参数

Response

200 OK

返回示例

""

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