2.4.1.8微信投诉/风控案例结果异步通知


交易渠道(暂时通知只支持微信)对客户投诉或确认交易违规时,会将案例推送给通联收银宝系统,收银宝会通过主动发起http post请求的方式,把通知信息转接推送到客户在收银宝客户平台配置的风控通知地址,请求参数如下:

注意:因为以后可能会增加通知参数,请获取全量变量,然后遍历获取非空变量,而不能用request.getparam(“key”)这样用文档中的字段名来一个个获取,到时候收银宝增加通知字段,就无法兼容了.请参考demo
通知的每一个字段都会进行UTF-8的UrlEncode,如果商户接收结果的服务器用web容器进行接收,例如TOMCAT,IIS.则无需进行URLDecode,如果不是用web容器进行接收,而是读数据流自己进行解析,则需要进行UTF-8的UrlDecode
以java为例:
String trxreserve = "订购人+10086";
String sendData = URLEncoder.encode(trxreserve, "UTF-8");
String getData = URLDecoder.decode(sendData, "UTF-8");

通知响应结果:
商户服务端在接收到结果通知并正确处理后,应响应消息。正确处理响应success,其他响应或者不响应通联开发平台则通过重发机制进行重发,重发次数为5次

对后台通知交互时,如果通联收到商户的应答不符合规范或超时,通联认为通知失败,通联会通过一定的策略定期重新发起通知,尽可能提高通知的成功率,但通联不保证通知最终能成功。(通知频率为15s/15s/5m/10m/15m - 总计30m30s)

字段

名称

取值

最长长度

说明

cusid

商户编号

 

15

 

appid

收银宝APPID

 

8

 

sign

sign校验码

 

256

 

id

通知的唯一ID

 

36

 

risktype

风控结果类型

 

32

VIOLATION:违规
COMPLAINT:投诉1.0结果
COMPLAINTV2:投诉2.0结果

create_time

通知创建的时间

 

 32

遵循rfc3339标准格式,

格式为yyyy-MM-DDTHH:mm:ss+TIMEZONE,

yyyy-MM-DD表示年月日,

T出现在字符串中,表示time元素的开头,

HH:mm:ss表示时分秒,

TIMEZONE表示时区

(+08:00表示东八区时间,领先UTC 8小时,即北京时间)。

例如:2015-05-20T13:29:35+08:00表示北京时间2015年05月20日13点29分35秒

event_type

通知的类型,投诉事件通知的类型

 

32

违规类型:
VIOLATION.PUNISH:处罚
VIOLATION.INTERCEPT:拦截
VIOLATION.APPEAL:申诉

投诉类型:
COMPLAINT.CREATE:产生新投诉
COMPLAINT.STATE_CHANGE:投诉状态变化

resource_type

知的资源数据类型

encrypt-resource

 

 

summary

回调摘要

 

64

 

resource

通知资源数据

 

 

JSON格式
报文主体与risktype关联


(1)当risktype= VIOLATION时,resource通知资源数据包含字段

字段

名称

取值

最长长度

说明

sub_mchid

渠道子商户号

 

32

该商户平台处置记录对应的商户号

company_name

子商户公司名称

 

64

 

record_id

唯一标识

 

128

微信支付对违约商户处理通知的唯一标识,可用于去重

punish_plan

具体处罚方案

 

2048

微信支付对违约商户的具体处罚方案,

可根据具体的处罚方案指引商户登录商户平台/商家助手小程序进行申诉/相关操作,

使用时请留意该值为处罚方法的文本内容,并非枚举值。

punish_time

处置时间

 

64

微信支付对违约商户的处置时间,

遵循rfc3339标准格式,

格式为yyyy-MM-DDTHH:mm:ss+TIMEZONE,

yyyy-MM-DD表示年月日,

T出现在字符串中,表示time元素的开头,

HH:mm:ss表示时分秒,TIMEZONE表示时区

(+08:00表示东八区时间,领先UTC 8小时,即北京时间)。

例如:2015-05-20T13:29:35+08:00表示北京时间2015年05月20日13点29分35秒

punish_description

描述信息

 

128

微信支付对违约商户处罚方案的详细描述信息,补充处罚方案的相关影响。

risk_type

风险类型

 

2048

微信支付对违约商户定义的风险类型,枚举值:
ONE_YUAN_PURCHASES:涉嫌一元购
MULTI_LEVEL_DISTRIBUTION_REBATE:涉嫌多级分销返利
PROHIBITED_BUSINESS_CATEGORIES:涉嫌我司未开放类目
CASH_ADVANCE_VIA_CREDIT_CARD:涉嫌信用卡套现
INDUCING_USERS_TO_MAKE_PAYMENTS:涉嫌诱导支付
FRAUD:涉嫌欺诈
MALICIOUS_FAN_COUNT_BOOSTING:涉嫌恶意吸粉
CROSS_CATEGORY_ACTIVITIES:涉嫌跨类目
CROSS_CATEGORY_BUSINESS:涉嫌跨类目经营
GAMBLING:涉嫌赌博
LEWD_CONTENT:涉嫌色情
UNLICENSED_PAYMENT_AND_SETTLEMENT_BUSINESS:涉嫌无证经营支付结算业务
INVESTMENT:涉嫌投资理财
TRANSACTION_DISPUTE:涉嫌交易纠纷
CROSS_BORDER_USE_OF_DOMESTIC_PAYMENT_API:涉嫌境内支付接口跨境使用
OVERSEAS_ACTIVITIES_OUTSIDE_THE_BUSINESS_SCOPE_APPROVED_BY_REGULATORY_AUTHORITIES:涉嫌境外超监管批复范围经营
UNUSUAL_TRANSACTION:涉嫌交易异常
UNLICENSED_BUSINESS:涉嫌无资质经营
WEALTH_INVESTMENT:涉嫌投资理财
AFFILIATED_TO_A_VIOLATING_ENTITY:涉嫌关联违规主体等异常风险
INVOLVED_IN_A_JUDICIAL_CASE:涉嫌司法案件
INCORRECT_INFORMATION_SUBMITTED:涉嫌资料异常
APPEAL_SUCCESSFUL:申诉成功
REPORTED_BY_OTHERS:涉嫌他人投诉举报
VIOLATING_SMART_CATERING_ACTIVITIES:涉嫌智慧餐饮活动违规
MORE_THAN_ONE_MERCHANT_UNDER_A_SINGLE_MERCHANT_ID:涉嫌同一商户号下挂多个商户
CROSS_REGION_USE_OF_INTERNATIONAL_PAYMENT_API:涉嫌境外支付接口跨区域
UNUSUAL_REAL_TIME_TRANSACTION:涉嫌实时交易异常
UNACCEPTABLE_DOCUMENTS:涉嫌资料不合格
LARGE_AMOUNT_TRANSACTION:涉嫌大额交易
ALL_MERCHANTS_HAVE_CONFIRMED_THE_WILLINGNESS_TO_OPEN_AN_ACCOUNT:无交易商户未确认开户意愿
UNCONFIRMED_WILLINGNESS_TO_OPEN_AN_ACCOUNT:未确认开户意愿
INACTIVE_TRANSACTION:交易停滞
OTHER_UNUSUAL_ACTIVITIES:涉嫌其它异常

risk_description

中文描述

 

2048

微信支付对违约商户定义的风险类型枚举值对应的中文描述


(2)当risktype= COMPLAINT时,resource通知资源数据包含字段

字段

名称

取值

最长长度

说明

sub_mchid

渠道子商户号

 

32

该商户平台处置记录对应的商户号

out_trade_no

收银宝交易单号

 

18

 

complaint_time

投诉时间

 

 

微信支付对违约商户的处置时间,

遵循rfc3339标准格式,

格式为yyyy-MM-DDTHH:mm:ss+TIMEZONE,

yyyy-MM-DD表示年月日,

T出现在字符串中,表示time元素的开头,

HH:mm:ss表示时分秒,

TIMEZONE表示时区

(+08:00表示东八区时间,领先UTC 8小时,即北京时间)。

例如:2015-05-20T13:29:35+08:00表示北京时间2015年05月20日13点29分35秒

amount

交易金额

 

 

单位:分

payer_phone

投诉人联系方式

 

32

投诉人联系方式

complaint_detail

投诉详情

 

2048

 

complaint_state

投诉单状态

 

 

标识当前投诉单所处的处理阶段,具体状态如下所示: PAYER_COMPLAINTED:用户已投诉
FROZENED:交易已冻结
FROZEN_FINISHED:冻结已结束
PAYER_CANCELED:用户已撤诉
MERCHANT_REFUNDED:商户已退款
SYSTEM_REFUNDED:系统(微信支付)已退款
MANUAL_UNFROZEN:人工(微信支付运营人员)手动解冻

transaction_id

渠道交易ID

 

 

微信交易ID

complaint_handle_state

投诉单处理状态

 

64

 投诉单处理进展状态,

标识当前投诉单所处的处理阶段,

描述用户与商户的沟通反馈进度,

将逐步取代投诉状态。具体状态如下所示:
WAIT_MERCHANT_RESPONSE:待商户处理
MERCHANT_RESPONSED:商户已反馈
USER_CONFIRMED:用户已确认
TIME_OUT_CLOSED:投诉超时关闭
MERCHANT_FULL_REFUNDED:商户全额退款
PAYER_CANCELED:用户已撤诉。
UNSPECIFIC:状态未知
示例值:WAIT_MERCHANT_RESPONSE

action_type

动作类型

 

64

触发本次投诉通知回调的具体动作类型,枚举如下:
CREATE_COMPLAINT:用户提交投诉
CONTINUE_COMPLAINT:用户继续投诉
USER_RESPONSE:用户新留言
RESPONSE_BY_PLATFORM:平台新留言
SELLER_REFUND:收款方全额退款
MERCHANT_RESPONSE:商户新回复
MERCHANT_CONFIRM_COMPLETE:商户反馈处理完成
示例值:CREATE_COMPLAINT

complaint_id

投诉单号

 

64

投诉单对应的投诉单号


(2)当risktype= COMPLAINTV2时,resource通知资源数据包含字段

字段

名称

取值

最长长度

说明

complaint_id

投诉单号

 

64

投诉单对应的投诉单号

complaint_time

投诉时间

 

32

 

complaint_detail

投诉详情

 

300

投诉的具体描述

complaint_state

投诉单状态

 

30

标识当前投诉单所处的处理阶段,具体状态如下所示:
PENDING-待处理
PROCESSING-处理中
PROCESSED-已处理完成

complainted_mchid

被诉商户号

 

64

微信子商户号

payer_phone

投诉人联系方式

 

64

 

payer_openid

投诉人OpenID

 

128

投诉人在商户AppID下的唯一标识,支付分服务单类型无

complaint_order_info

投诉单关联订单信息

 

 

array[ComplaintOrderInfo]
属性:
transaction_id 微信订单号
out_trade_no
通联交易单号
Amount
订单金额,单位(分)

complaint_full_refunded

投诉单是否已全额退款

 

 

投诉单下所有订单是否已全部全额退款

incoming_user_response

是否有待回复的用户留言

 

 

投诉单是否有待回复的用户留言

user_complaint_times

用户投诉次数

 

 

用户投诉次数。用户首次发起投诉记为1次,用户每有一次继续投诉就加1

complaint_media_list

投诉资料列表

 

 

array[ComplaintMedia]

属性

media_type

媒体文件业务类型

可选取值:

  1. USER_COMPLAINT_IMAGE: 用户提交投诉时上传的图片凭证
  2. OPERATION_IMAGE: 用户、商户、微信支付客服在协商解决投诉时,上传的图片凭证

media_url媒体文件请求url

problem_description

问题描述

 

256

 

problem_type

问题类型

 

 

  1. 问题类型为申请退款的单据是需要最高优先处理的单据
    可选取值:
  2. REFUND: 申请退款
  3. SERVICE_NOT_WORK: 服务权益未生效
  4. OTHERS: 其他类型

apply_refund_amount

申请退款金额

 

 

  1. 仅当问题类型为申请退款时, 有值, (单位:分)

user_tag_list

用户标签列表

 

 

array[string]

用户标签列表
可选取值:

TRUSTED: 此类用户满足极速退款条件

HIGH_RISK: 高风险投诉,请按照运营要求优先妥善处理

service_order_info

投诉单关联服务单信息

 

 

array[ServiceOrderInfo]

属性:

order_id 微信支付服务订单号

out_order_no 商户服务订单号

state  支付分服务单状态

可选取值:

  1. DOING: 服务订单进行中
  2. REVOKED: 服务订单已取消
  3. WAITPAY: 服务订单待支付
  4. DONE: 服务订单已完成

additional_info

补充信息

 

 

 


yinjr 2025年10月9日 14:57 收藏文档