从业机构/服务商/渠道商/商户可调用该接口，在商户订单下单完成后，上报订单关联信息，以便后续在支付环节进行风险管控

接口说明

支持商户：

【从业机构（银行）】【从业机构（支付机构）】【普通服务商】【渠道商】

请求方式：

【POST】/v3/merchant-risk-manage/report-trade-union-information

请求域名：

【主域名】

https://api.mch.weixin.qq.com

使用该域名将访问就近的接入点

【备域名】

https://api2.mch.weixin.qq.com

使用该域名将访问异地的接入点 ，指引点击查看

请求参数

Header HTTP头参数
Authorization 必填 string
请参考 签名认证 生成认证信息
Accept 必填 string
请设置为 application/json
Content-Type 必填 string
请设置为 application/json
Wechatpay-Serial 必填 string
【微信支付平台证书序列号】 请求参数中的敏感字段，需要使用微信支付平台证书公钥加密。请设置为该证书的证书序列号。详见敏感信息加解密

Body 包体参数
sp_mchid 选填 string
【服务商商户号】 微信支付分配的服务商唯一标识。 注：若为子商户调用，可选择传入对应的服务商号。
acquiring_bank_id 选填 string
【从业机构商户号】 微信支付分配的从业机构唯一标识。 注：若为银行子商户、渠道商调用，可选择传入对应的从业机构号。
channel_id 选填 string
【渠道号】 微信支付分配的渠道商唯一标识。 注：若为银行子商户调用，可选择传入对应的渠道号。
sub_mchid 选填 string
【子商户号】 上报订单风险数据的商户号信息
out_trade_no 选填 string
【商户订单号】 商户系统内部订单号，只能是数字、大小写字母_-*且在同一个商户号下唯一。用于标识上报的风险信息所属订单。
openid 选填 string
【用户标识】 此参数为微信用户在商户对应appid下的唯一标识。 补充说明：用户登录三方app且关联的微信账号，在商户所申请appid下对应的 openid
phone 选填 string
【用户手机号】 用户在商户侧留存的手机号，采用商户平台证书sm2公钥加密传递，详见敏感信息加密说明
certificates_number 选填 string
【用户实名证件号】 身份证ID后6位，采用商户平台证书sm2公钥加密传递，详见敏感信息加密说明
client_ip 选填 string
【用户终端ip】 用户的终端IP
risk_level 选填 integer
【商户判定交易的风险等级】 商户判定交易的风险等级
line_type 选填 integer
【线上线下标识】 1：线上交易; 2：线下交易
goods_type 选填 integer
【虚拟实物标识】 1：虚拟交易；2：实物交易
seller_type 选填 integer
【物品发布类型】 物品发布类型。1：个人; 2：商家（平台类商户发布交易物品的是个人或商家）
is_need_deliver 选填 boolean
【是否需要物流发货】 是否需要物流发货
device_type 选填 integer
【用户设备类型】 用户设备类型。1：苹果；2：安卓；3：其它
userid 选填 string
【付款方用户标识】 出金的用户在商户侧的账号，由商户侧定义，保证账号维度唯一即可
phone_from 选填 integer
【手机号来源】 用户手机号的来源方式
seller_userid 选填 string
【收款方用户标识】 收款方在商户侧的用户标识，由商户侧定义，账号维度唯一即可
scene 选填 integer
【业务场景】 0：无明确场景；1：充值；2：生活缴费
recharge_fields 选填 object
【充值业务场景独有字段】
• 属性
living_expenses_fields 选填 object
【生活缴费场景独有字段】
• 属性
extra_fields1 选填 string(4096)
【扩展字段1】 扩展字段1，json格式
extra_fields2 选填 string(4096)
【扩展字段2】 扩展字段2，json格式
extra_fields3 选填 string(4096)
【扩展字段3】 扩展字段3，json格式

请求示例

POST

应答参数

200OK
sp_mchid 选填 string
【服务商商户号】 微信支付分配的服务商唯一标识。 注：若为子商户调用，可选择传入对应的服务商号。
acquiring_bank_id 选填 string
【从业机构商户号】 微信支付分配的从业机构唯一标识。 注：若为银行子商户、渠道商调用，可选择传入对应的从业机构号。
channel_id 选填 string
【渠道号】 微信支付分配的渠道商唯一标识。 注：若为银行子商户调用，可选择传入对应的渠道号。
sub_mchid 选填 string
【子商户号】 上报订单风险数据的商户号信息
out_trade_no 选填 string
【商户订单号】 商户系统内部订单号，只能是数字、大小写字母_-*且在同一个商户号下唯一。用于标识上报的风险信息所属订单。

应答示例

200 OK

错误码

公共错误码

状态码	错误码	描述	解决方案
400	PARAM_ERROR	参数错误	请根据错误提示正确传入参数
400	INVALID_REQUEST	HTTP 请求不符合微信支付 APIv3 接口规则	请参阅 接口规则
401	SIGN_ERROR	验证不通过	请参阅 签名常见问题
500	SYSTEM_ERROR	系统异常，请稍后重试	请稍后重试

业务错误码

状态码	错误码	描述	解决方案
400	INVALID_REQUEST	请求参数符合参数格式，但不符合业务规则	请确认相同单号是否使用了不同的参数
404	MCH_NOT_EXISTS	商户号不存在	请确认传入的商户号是否正确
404	NOT_FOUND	请求的资源不存在	请商户检查需要查询的ID或者请求URL是否正确
404	ORDER_NOT_EXIST	请求的资源不存在	请商户检查需要查询的ID或者请求URL是否正确
429	FREQUENCY_LIMITED	频率超限	请求量不要超过接口调用频率限制
500	SYSTEM_ERROR	系统错误	5开头的状态码都为系统问题，请使用相同参数 稍后重新调用