上报订单关联信息

更新时间: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

1curl -X POST \
2  https://api.mch.weixin.qq.com/v3/merchant-risk-manage/report-trade-union-information \
3  -H "Authorization: WECHATPAY2-SHA256-RSA2048 mchid=\"1900000001\",..." \
4  -H "Accept: application/json" \
5  -H "Wechatpay-Serial: 5157F09EFDC096DE15EBE81A47057A7232F1B8E1"  \
6  -H "Content-Type: application/json" \
7  -d '{
8    "sp_mchid" : "1900000109",
9    "acquiring_bank_id" : "1356485",
10    "channel_id" : "1900000108",
11    "sub_mchid" : "1900009231",
12    "out_trade_no" : "1217752501201407033233368018",
13    "openid" : "oUpF8uMuAJO_M2pxb1Q9zNjWeS6o",
14    "phone" : "ca775af5f841bdf424b2e6eb86a6e21e",
15    "certificates_number" : "ca775af5f841bdf424b2e6eb86a6e21e",
16    "client_ip" : "123.12.12.123",
17    "risk_level" : 1,
18    "line_type" : 1,
19    "goods_type" : 1,
20    "seller_type" : 1,
21    "is_need_deliver" : false,
22    "device_type" : 1,
23    "userid" : "华为的账号:260XXX",
24    "phone_from" : 1,
25    "seller_userid" : "抖音的账号:XXXXX",
26    "scene" : 1,
27    "recharge_fields" : {
28      "account_type" : 1,
29      "account" : "example_account"
30    },
31    "living_expenses_fields" : {
32      "acc_no" : "123456",
33      "type" : 1,
34      "city" : "湖南衡阳",
35      "address" : "广东省深圳市南山区海天二路33号",
36      "acc_name" : "詹讯",
37      "company_name" : "深圳电力",
38      "amount" : 500
39    },
40    "extra_fields1" : "{\"key1\":\"value1\"}",
41    "extra_fields2" : "{\"key1\":\"value1\"}",
42    "extra_fields3" : "{\"key1\":\"value1\"}",
43    "high_risk_goods" : 1,
44    "same_deviced" : false,
45    "reliable_device" : false,
46    "delivery_province" : "example_delivery_province",
47    "delivery_city" : "example_delivery_city",
48    "new_address" : false,
49    "last_pay_openid" : "example_last_pay_openid",
50    "risky_goods" : 1,
51    "offline_delivery_label" : 1,
52    "proxy_payment" : false,
53    "order_phone_number" : "example_order_phone_number",
54    "user_risk_level" : 1,
55    "sp_risk_level" : 1,
56    "phone_number_location" : "example_phone_number_location",
57    "goods_category" : "example_goods_category",
58    "pre_opening_behavior" : "example_pre_opening_behavior",
59    "new_store" : false,
60    "store_identifier" : "example_store_identifier",
61    "goods_listing_time" : "example_goods_listing_time",
62    "combine_out_trade_no" : "example_combine_out_trade_no",
63    "combine_mchid" : "example_combine_mchid",
64    "sub_orders" : [
65      {
66        "out_trade_no" : "example_out_trade_no",
67        "mch_id" : "example_mch_id",
68        "delivery_province" : "example_delivery_province",
69        "delivery_city" : "example_delivery_city",
70        "risky_goods" : 1,
71        "user_risk_level" : 1,
72        "sp_risk_level" : 1
73      }
74    ]    
75  }'

应答参数

200 OK

sp_mchid  选填 string

【服务商商户号】微信支付分配的服务商唯一标识。 注:若为子商户调用,可选择传入对应的服务商号。


acquiring_bank_id  选填 string

【从业机构商户号】微信支付分配的从业机构唯一标识。 注:若为银行子商户、渠道商调用,可选择传入对应的从业机构号。


channel_id  选填 string

【渠道号】微信支付分配的渠道商唯一标识。 注:若为银行子商户调用,可选择传入对应的渠道号。


sub_mchid  选填 string

【子商户号】上报订单风险数据的商户号信息


out_trade_no  选填 string

【商户订单号】商户系统内部订单号,只能是数字、大小写字母_-*且在同一个商户号下唯一。用于标识上报的风险信息所属订单。

应答示例

200 OK

1{
2  "sp_mchid" : "1900000109",
3  "acquiring_bank_id" : "1356485",
4  "channel_id" : "1900000108",
5  "sub_mchid" : "1900009231",
6  "out_trade_no" : "1217752501201407033233368018"
7}
8

错误码

公共错误码

状态码

错误码

描述

解决方案

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开头的状态码都为系统问题,请使用相同参数 稍后重新调用

 

 

反馈
咨询
目录
置顶