支付通知API

支付成功异步通知API

如果商户收到网易支付支付成功通知的请求,打印platformId|ewTradeId给网易支付,否则网易支付则会一直发送通知给商户。如果商户不需要支付成功异步通知,请联系网易支付技术支持为您配置。

开通

商户需要开通新版接口trade_notify_platform权限,同时配置通知的报文格式,json或xml

注:如果商户的通知地址端口不是80或443,需向网易宝说明,提交申请。


请求地址

https://${notif_url}?msg=&sign=


通知参数

网易支付通知商户支付成功参数,返回的类型为JSONXML

参数 

参数称

msg 

处理结果报文 

sign 

Msg签名信息

msg : 业务参数拼装成的XML或者JSON,再Base64后的值,例如:msg=base64(xml)或者msg=base64(json);

sign : 使用算法对msg的签名,例如:sign=rsa_sign(private_key,msg);

如果msgsign参数含有特殊字符时,为避免请求被转码等问题,请在参数发送时需进行UrlEncode.

msg中的参数说明

参数

参数名称

样例

notifyType

通知类型

back:后台通知
online
web前端通知
onlinemobile
:移动网网页前端
有的商户是根据notifyUrl来判断客户端,

有的商户是根据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

未付款  
已付款 等待卖家发货  

已发货  
交易成功  
退款处理中  
已退款  
交易关闭   

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

网易支付出口ip列表