营销资金划拨通知

⚠️

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

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

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

接口说明

请求方式：

post

接入方提供营销资金划拨通知 URL

请求参数

Request

Body 包体

channel_merchant_id必填

string

商户ID

type必填

string

类型：pay=划拨 refund=退划拨

out_order_id必填

string

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

channel_order_id必填

string

微卡收付通订单号

wechat_transaction_id必填

string

微信支付单号

promotion_activity_id必填

string

优惠活动ID(代金券批次ID)；等于订单信息 PromotionInfos 里面的 PromotionActivityId 字段

promotion_id必填

string

券ID。等于订单信息 PromotionInfos 里面的 PromotionId 字段

amount必填

string

划拨金额，单位分；如果 type=refund 则为退划拨金额。

out_refund_id选填

string

退款外部订单号，即业务系统侧退款订单号；当 type=refund 时有值。

channel_refund_id选填

string

微卡收付通退款流水号；当 type=refund 时有值。

transfer_status必填

string

划拨状态。 WAIT_TRANSFER = 待划拨 TRANSFERING = 划拨中 TRANSFER_FAILED = 划拨失败 TRANSFER_SUCCESS = 划拨成功

id必填

string

唯一标识一笔营销划拨记录，无实际业务含义。

请求示例

{
  "channel_merchant_id": "CM470781797219762383",
  "type": "pay",
  "out_order_id": "OutOrderId20210819100000000000000000000001",
  "channel_order_id": "OrderId20210819100000000000000000000001",
  "wechat_transaction_id": "4200001868202307246628884230",
  "promotion_id": "321",
  "amount": 10,
  "transfer_status": "TRANSFERRING",
  "id": "2cl0rXgLWfmx9MRLYobMMdh25xV",
  "create_time": "2024-02-23T15:26:44+08:00"
}

返回参数

Response

200 OK

返回示例

""