如果商户收到网易支付支付成功通知的请求,打印platformId|ewTradeId给网易支付,否则网易支付则会一直发送通知给商户。如果商户不需要支付成功异步通知,请联系网易支付技术支持为您配置。
开通
商户需要开通新版接口trade_notify_platform权限,同时配置通知的报文格式,json或xml
注:如果商户的通知地址端口不是80或443,需向网易宝说明,提交申请。
请求地址
https://${notif_url}?msg=&sign=
通知参数
网易支付通知商户支付成功参数,返回的类型为JSON或XML。
参数 | 参数称 |
msg | 处理结果报文 |
sign | Msg签名信息 |
msg : 业务参数拼装成的XML或者JSON,再Base64后的值,例如:msg=base64(xml)或者msg=base64(json);
sign : 使用算法对msg的签名,例如:sign=rsa_sign(private_key,msg);
如果msg和sign参数含有特殊字符时,为避免请求被转码等问题,请在参数发送时需进行UrlEncode.
msg中的参数说明
参数 | 参数名称 | 样例 |
notifyType | 通知类型 back:后台通知 有的商户是根据notifyType处理。 批量交易全部按online类型通知。 | online |
sellerId | 卖出方ID,原样返回 | Urstest@163.com |
payAccountId | 付款方ID | Urstest@163.com |
platformId | 商户号,原样返回 | 2008122815PT00000025 |
platformTradeId | 平台交易流水号 ,原样返回 | 2012070317CP00000001 |
ewTradeId | 网易支付交易流水号 | 2012080317JY49912792 |
ewTime | 钱包交易时间 精确到秒,格式yyyyMMddHHmmss | 20120807000000 |
tradeType | 交易类型(1:即时、2:担保),原样返回 | 1 |
platformTime | 平台商品交易时间 精确到秒,原样返回 格式:yyyyMMdd HHmmss | 20120806000000 |
platformPrivateField | 平台附加信息,原样返回 | Test |
tradeStatus | 0 未付款 2 已发货 | 3 |
tradeAmount | 交易金额 格式:0.00,平台声明应支付的金额 | 0.01 |
trueAmount | 实际交易金额 格式0.00,用户实际支付金额 | 0.01 |
currencyType | 交易币种,人民币:00 | 00 |
tradeMode | 交易模式,如:B2C | 2 |
handFee | 手续费;如果产品指定手续费,这里原样返回, 如果是钱包收取,这里返回的是钱包收取的实际手续费。 | 0.00 |
logisticType | 物流类型。原样返回 | 0 |
realPaymethod | 支付方式 | quickPay |
bankReturnAttach | 部分银行返回的支付凭证部分银行 | 2030944433 |
totalCouponAmount | 当前订单支付所用的红包金额 需要在系统ini配置NEED_SEND_COUPON_INFO_TO_PLATFORMS才返回该字段,否则为空 | |
bankId | 银行ID | |
bankName | 银行中文名称,需在iniNEED_SEND_CARD_INFO_TO_PLATFORMS配置商户才返回银行id | |
cardNoTail | 银行卡尾号,需在iniNEED_SEND_CARD_INFO_TO_PLATFORMS配置商户才返回 | |
couponIds | 优惠id,多个优惠id用逗号分隔。 需要在系统ini配置NEED_SEND_COUPON_INFO_TO_PLATFORMS才返回该字段,否则为空 |
商户返回内容
如果商户收到网易宝支付成功通知的请求,打印platformId|ewTradeId给网易宝,否则网易宝则会一直发送通知给商户。
(商户通知地址最好同时支持POST和GET两种方式,前台通知为POST,后台通知为GET)
注意:
如果商户端设置了IP访问白名单,商户需要在白名单中新增下列ip:
a. 59.111.18.0 ~ 59.111.18.254,255个IP
b. 123.58.185.40,123.58.185.30,123.58.185.57,123.58.185.56,123.58.185.25 ,5个IP