# 回调通知

交易创建完成后,如果交易状态发生改变,会以通知的形式告知平台商户端 平台商户端接收到回调之后需要进行签名确认交易状态,返回字符串 SUCCESS,否则系统将进行重试,最多重试16次,间隔次数与时间如下表

第几次重试 与上次重试的间隔时间 第几次重试 与上次重试的间隔时间
1 10秒 9 7分钟
2 30秒 10 8分钟
3 1分钟 11 9分钟
4 2分钟 12 10分钟
5 3分钟 13 20分钟
6 4分钟 14 30分钟
7 5分钟 15 1小时
8 6分钟 16 2小时

交易回调参数

参数名 字段名 格式 必填 说明
pid 合作方平台id String(20) 是 合作方平台id,由蝉鸣分配
mid 平台商户号 String(20) 是 平台进件成功后,由蝉鸣分配的商户唯一ID
sign 签名 String 是 签名
notifyType 通知业务类型 通知业务类型 是 TRADE_SYNC:交易通知;REFUND_SYNC:退款通知;
tradeNo 蝉鸣交易编号 蝉鸣交易编号 是
outTradeNo 平台商户交易号 String(32) 是 平台商户端交易的唯一编号,用来和蝉鸣交易关联
tradeAmount 交易金额 Money(8,2) 是
tradeStatus 交易状态 String(10) 是 交易所处的状态;NOT_PAY 未支付;TIME_OUT 交易超时;CANCELED 交易撤销;FAIL 交易失败;CLOSED 交易关闭;SUCCESS 交易成功
refundStatus 退款状态 String(20) 特殊 REFUND_PROCESS退款处理中;REFUND_SUCCESS退款成功;REFUND_FAIL 退款失败
refundAmount 退款总金额 Number 特殊 单位元
refundTime 退款时间 Datetime 特殊 退款成功时包含
refundNo 退款交易号 String(64) 特殊 是
outRefundNo 外部退款交易单号 String(64) 特殊 外部退款编号
subject 交易标题 String(50) 是
body 交易信息 String(64) 是
payAmount 支付金额 Money(8,2) 否 支付成功时返回
payUserId 支付人id String(20) 否 支付成功时返回
payTime 支付时间 Date 否 支付成功时返回
payChannelCode 支付渠道号 String(5) 否 支付成功时返回
payTradeNo 支付渠道交易号 String(32) 否 支付成功时返回
stageNum 分期数 Integer(2) 否 当支付渠道为KFQ,且支付成功时,包含此结果
payChannelOrderNo 支付通道交易编号 String(64) 否 支付宝或微信端的订单号,可用于打印小票给客户核对
merchantOrderNo 商户订单号 String(128) 否 商户订单号。该订单号与支付宝、微信支付客户端账单详情显示的商户订单号一致,通过该订单后可发起扫码退款或查询交易
buyerLogonId 买家支付宝登录账号 String(128) 否 买家支付宝登录账号。该字段2017年9月30日提供线上服务。
buyerUserId 支付宝买家uid String(128) 否 买家支付宝用户id
attach 额外信息 String(128) 否 原样返回
bankType 银行类型 String(10) 否 付款银行。银行类型,仅使用微信支付时有返回值
isSubscribe 是否关注公众号 String(1) 否 用户是否关注商户公众号,仅微信支付有效。Y:关注;N: 未关注
couponFee 现金券金额 Number 否 仅微信返回,现金券支付金额=订单总金额,订单总金额-现金券金额为现金支付金额。该字段2017年9月30日提供线上服务
credit 借贷标识 Number 否 可选值:credit:信用卡pcredit:花呗(仅支付宝)debit:借记卡balance:余额unknown:未知
receiptAmount 实收金额 Number 否 实收金额,商户实际入账的金额(扣手续费之前)。仅支付宝返回
buyerPayAmount 用户实付金额 Number 否 用户实付金额,建议打印在小票上避免退款时出现纠纷。仅支付宝返回
InvoiceAmount 开票金额 Number 否 开票金额,快速告知商户应该给用户开多少钱发票。仅支付宝返回
payType 支付方式 String(2) 否 0-银行卡 1-白条 2-余额 3-优惠券 5-小金库 6-钢镚 8-白条分期 9-白条支付(不分期)
fundChannel 资金渠道 String(200) 否 详细见状态编码 资金渠道,多个资金渠道,逗号分隔
passBackParams 回传参数 String(512) 否 orderNo=1111&1-1&1-2等形式