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