工银聚富通支付异步通知报文参数

《工银聚富通支付异步通知报文详解》 工银聚富通支付异步通知报文是工商银行提供的一种在线支付系统与商户系统间进行交互的重要方式，它确保了支付过程中信息的及时传递和处理。这篇文档将详细介绍工银聚富通支付报文的格式、接收参数以及关键字段的意义，帮助开发者理解和处理这些报文。 一、报文格式与接收变量 工银聚富通支付的报文格式遵循JSON标准，主要由两部分构成：`notifyData`和`signData`。`notifyData`包含了支付通知的所有信息，经过base64编码；`signData`则用于API签名验证，通常商户端可以忽略此字段。接收时，报文内容需解析成map，以便处理键值对。 二、报文内容及参数说明 1. `txCode`（交易代码）：标识支付的类型，如“202”代表支付交易。 2. `respCode`（交易响应码）：成功为“00000”，失败则显示其他错误码，如“00001”。 3. `respMsg`（通知信息）：支付平台返回的具体状态描述，例如“交易成功！”。 4. `trxAmount`（交易金额）：以货币单位表示的交易总额。 5. `payMethod`（支付方式）：区分不同的支付渠道，如“01”代表工银e支付，“02”代表微信支付等。 6. `orderStatus`（订单状态）：“02”表示支付成功，“03”表示支付失败。 7. `orderId`（订单号）：商户系统内的唯一订单编号。 8. `completeDate`和`completeTime`（支付完成日期和时间）：8位日期和8位时间，精确到秒。 9. `appId`（平台商户标识）：工银聚富通分配的商户ID。 10. `vendorId`（子商户标识）：如果有子商户，用于识别子商户的ID。 11. `userId`（用户标识）：支付用户的唯一标识。 12. `merName`和`subMerName`（平台/子商户名称）：用于显示给用户的商户信息。 13. `orderNo`（聚富通交易流水号）：工银聚富通内部生成的交易流水号。 14. `vendorDiscount`和`bankDiscount`（商户优惠金额和银行补贴金额）：仅在特定支付方式下有值。 15. `realPayAmt`（实际支付金额）：扣除优惠后的实际支付金额。 16. `jftDiscountAmt`（聚富通优惠金额）：聚富通提供的优惠额度。 17. `shopCode`（商城代码）：内部使用的商城标识。 18. `icbcOrderId`（工行订单号）：微信、支付宝等第三方支付平台的订单号。 19. `comment`（订单信息说明）：可选的订单描述信息。 20. `jOrderId`（聚富通订单号）：单笔订单号或合并订单的父订单号。 21. `subOrderInfoList`（子商户信息）：包含子订单号、子商户标识、子商户名称、交易金额、实际支付金额等信息。 三、商户返回报文说明 商户在接收到工银聚富通的异步通知后，需要生成并返回一个报文，主要包括`return_code`和`return_msg`两个字段。`return_code`为“0”表示成功，其他值表示失败；`return_msg`应固定为“success”，并加上当前的时间戳作为`megId`。 总结，工银聚富通支付异步通知报文是支付过程中的重要环节，包含了支付交易的详细信息，包括交易状态、金额、支付方式、订单信息等，同时也规定了商户对这些通知的反馈格式。理解并正确处理这些报文对于确保支付流程的顺利进行至关重要。