# 回调通知

交易创建完成后,如果交易状态发生改变,会以通知的形式告知平台商户端 平台商户端接收到回调之后需要进行签名确认交易状态,返回字符串 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 签名
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等形式