上报订单关联信息
更新时间:2024.12.04从业机构/服务商/渠道商/商户可调用该接口,在商户订单下单完成后,上报订单关联信息,以便后续在支付环节进行风险管控
接口说明
支持商户:【从业机构(银行)】 【从业机构(支付机构)】 【普通服务商】 【渠道商】
请求方式:【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
请求参数中的敏感字段,需要使用微信支付公钥加密(推荐),请参考获取微信支付公钥ID说明以及微信支付公钥加密敏感信息指引,也可以使用微信支付平台证书公钥加密,参考获取平台证书序列号、平台证书加密敏感信息指引
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
【用户手机号】用户在商户侧留存的手机号,需要使用微信支付公钥加密(推荐),请参考获取微信支付公钥ID说明以及微信支付公钥加密敏感信息指引,也可以使用微信支付平台证书公钥加密,参考获取平台证书序列号、平台证书加密敏感信息指引
certificates_number 选填 string
【用户实名证件号】身份证ID后6位,需要使用微信支付公钥加密(推荐),请参考获取微信支付公钥ID说明以及微信支付公钥加密敏感信息指引,也可以使用微信支付平台证书公钥加密,参考获取平台证书序列号、平台证书加密敏感信息指引
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格式
high_risk_goods 选填 integer
【高风险商品标签】高风险商品专属标签
same_deviced 选填 boolean
【用户下单设备与支付设备是否一致】用户下单设备与支付设备是否一致
reliable_device 选填 boolean
【用户下单设备是否是常用设备】用户下单设备是否为常用设备
delivery_province 选填 string
【收货省份】下单邮寄地址的收货省份
delivery_city 选填 string
【收货城市】下单邮寄地址的收货城市
new_address 选填 boolean
【收货人地址是否新增】收货人该笔订单地址是否新增
last_pay_openid 选填 string
【上一笔支付openid】该笔订单对应账号上一次支付openid
risky_goods 选填 integer
【高风险类目】高风险类目,1-游戏点卡,2-话费充值,3-商超购物卡,4-电费,5-燃气费,6-其他卡类
offline_delivery_label 选填 integer
【订单识别标识:小时购/自提等枚举值】订单物流类型,1-小时购;2-自提订单
proxy_payment 选填 boolean
【是否为代付订单】是否为代付订单,true or false
order_phone_number 选填 string
【下单人手机号:手机号前3后4】下单用户脱敏手机号,回传前3后4手机号
user_risk_level 选填 integer
【下单人风险等级】下单人风险等级,1-高风险;2-中高风险;3-中风险;4-低风险;5-未知;6-可扩展;7-可扩展
sp_risk_level 选填 integer
【商户风险等级】商户风险等级,1-高风险;2-中高风险;3-中风险;4-低风险;5-未知;6-可扩展;7-可扩展
phone_number_location 选填 string
【手机号所属地】用户手机号所属地
goods_category 选填 string
【商品类目】购买的商品类目
pre_opening_behavior 选填 string
【前置打开行为异常】访问交易场景的打开方式异常的情况
new_store 选填 boolean
【卖家是否是新账号】卖家是否是新账号
store_identifier 选填 string
【店铺标识】店铺ID
goods_listing_time 选填 string
【商品上架时间】商品上架时间
combine_out_trade_no 选填 string
【合单商户订单号】 如通过合单接口下单,请上报合单商户订单号。商户系统内部订单号,可以是数字、大小写字母以及特殊符号_-*的任意组合,且在同一个商户号下唯一。
combine_mchid 选填 string
【合单商户号】 如通过合单接口下单,请上报合单商户号,即合单发起方商户号
sub_orders 选填 array[SubOrderInfo]
【子单列表】 子单列表,支持传入多个子单。
属性 | |
请求示例
POST
应答参数
200 OK
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开头的状态码都为系统问题,请使用相同参数 稍后重新调用 |