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