wechatpay.im

主题模式

上报订单关联信息 ​

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

请求参数类型描述
jsonobject声明请求的JSON数据结构
sp_mchidstring微信支付分配的服务商唯一标识
acquiring_bank_idstring微信支付分配的从业机构唯一标识
channel_idstring微信支付分配的渠道商唯一标识
sub_mchidstring上报订单风险数据的商户号信息
out_trade_nostring商户系统内部订单号，只能是数字、大小写字母_-*且在同一个商户号下唯一
openidstring此参数为微信用户在商户对应appid下的唯一标识
phonestring用户在商户侧留存的手机号，采用商户平台证书sm2公钥加密传递
certificates_numberstring身份证ID后6位，采用商户平台证书sm2公钥加密传递
client_ipstring用户的终端IP
risk_levelinteger商户判定交易的风险等级
line_typeinteger1：线上交易; 2：线下交易
goods_typeinteger1：虚拟交易；2：实物交易
seller_typeinteger物品发布类型
is_need_deliverboolean是否需要物流发货
device_typeinteger用户设备类型
useridstring出金的用户在商户侧的账号，由商户侧定义，保证账号维度唯一即可
phone_frominteger用户手机号的来源方式
seller_useridstring收款方在商户侧的用户标识，由商户侧定义，账号维度唯一即可
sceneinteger0：无明确场景；1：充值；2：生活缴费
recharge_fieldsobject
account_typeinteger充值场景，用户充值的账号类型
accountstring
living_expenses_fieldsobject
acc_nostring生活缴费的呼号
typeinteger缴费的种类
citystring用户缴费户号所属城市
addressstring用户缴费户号所对应的地址信息
acc_namestring缴费户号对应的户主名字
company_namestring给哪个机构缴纳该笔费用
amountinteger缴费金额，单位为分，币种为人名币
extra_fields1string扩展字段1，json格式
extra_fields2string扩展字段2，json格式
extra_fields3string扩展字段3，json格式
headersobject声明请求的头参数
Wechatpay-Serialstring平台公钥ID/平台公钥证书序列号
php
$instance->v3->merchantRiskManage->reportTradeUnionInformation->postAsync([
  'json' => [
    'sp_mchid' => '1900000109',
    'acquiring_bank_id' => '1356485',
    'channel_id' => '1900000108',
    'sub_mchid' => '1900009231',
    'out_trade_no' => '1217752501201407033233368018',
    'openid' => 'oUpF8uMuAJO_M2pxb1Q9zNjWeS6o',
    'phone' => 'ca775af5f841bdf424b2e6eb86a6e21e',
    'certificates_number' => 'ca775af5f841bdf424b2e6eb86a6e21e',
    'client_ip' => '123.12.12.123',
    'risk_level' => 1,
    'line_type' => 1,
    'goods_type' => 1,
    'seller_type' => 1,
    'is_need_deliver' => true,
    'device_type' => 1,
    'userid' => '华为的账号：260XXX',
    'phone_from' => 1,
    'seller_userid' => '抖音的账号：XXXXX',
    'scene' => 1,
    'recharge_fields' => [
      'account_type' => 1,
      'account' => 'example_account',
    ],
    'living_expenses_fields' => [
      'acc_no' => '123456',
      'type' => 1,
      'city' => '湖南衡阳',
      'address' => '广东省深圳市南山区海天二路33号',
      'acc_name' => '詹讯',
      'company_name' => '深圳电力',
      'amount' => 500,
    ],
    'extra_fields1' => '{"key1":"value1"}',
    'extra_fields2' => '{"key1":"value1"}',
    'extra_fields3' => '{"key1":"value1"}',
  ],
  'headers' => [
    'Wechatpay-Serial' => 'PUB_KEY_ID_0114232134912410000000000000',
  ],
])
->then(static function(\Psr\Http\Message\ResponseInterface $response) {
  print_r(json_decode((string) $response->getBody(), true));
})
->wait();
php
$instance->chain('v3/merchant-risk-manage/report-trade-union-information')->postAsync([
  'json' => [
    'sp_mchid' => '1900000109',
    'acquiring_bank_id' => '1356485',
    'channel_id' => '1900000108',
    'sub_mchid' => '1900009231',
    'out_trade_no' => '1217752501201407033233368018',
    'openid' => 'oUpF8uMuAJO_M2pxb1Q9zNjWeS6o',
    'phone' => 'ca775af5f841bdf424b2e6eb86a6e21e',
    'certificates_number' => 'ca775af5f841bdf424b2e6eb86a6e21e',
    'client_ip' => '123.12.12.123',
    'risk_level' => 1,
    'line_type' => 1,
    'goods_type' => 1,
    'seller_type' => 1,
    'is_need_deliver' => true,
    'device_type' => 1,
    'userid' => '华为的账号：260XXX',
    'phone_from' => 1,
    'seller_userid' => '抖音的账号：XXXXX',
    'scene' => 1,
    'recharge_fields' => [
      'account_type' => 1,
      'account' => 'example_account',
    ],
    'living_expenses_fields' => [
      'acc_no' => '123456',
      'type' => 1,
      'city' => '湖南衡阳',
      'address' => '广东省深圳市南山区海天二路33号',
      'acc_name' => '詹讯',
      'company_name' => '深圳电力',
      'amount' => 500,
    ],
    'extra_fields1' => '{"key1":"value1"}',
    'extra_fields2' => '{"key1":"value1"}',
    'extra_fields3' => '{"key1":"value1"}',
  ],
  'headers' => [
    'Wechatpay-Serial' => 'PUB_KEY_ID_0114232134912410000000000000',
  ],
])
->then(static function(\Psr\Http\Message\ResponseInterface $response) {
  print_r(json_decode((string) $response->getBody(), true));
})
->wait();
php
$instance['v3/merchant-risk-manage/report-trade-union-information']->postAsync([
  'json' => [
    'sp_mchid' => '1900000109',
    'acquiring_bank_id' => '1356485',
    'channel_id' => '1900000108',
    'sub_mchid' => '1900009231',
    'out_trade_no' => '1217752501201407033233368018',
    'openid' => 'oUpF8uMuAJO_M2pxb1Q9zNjWeS6o',
    'phone' => 'ca775af5f841bdf424b2e6eb86a6e21e',
    'certificates_number' => 'ca775af5f841bdf424b2e6eb86a6e21e',
    'client_ip' => '123.12.12.123',
    'risk_level' => 1,
    'line_type' => 1,
    'goods_type' => 1,
    'seller_type' => 1,
    'is_need_deliver' => true,
    'device_type' => 1,
    'userid' => '华为的账号：260XXX',
    'phone_from' => 1,
    'seller_userid' => '抖音的账号：XXXXX',
    'scene' => 1,
    'recharge_fields' => [
      'account_type' => 1,
      'account' => 'example_account',
    ],
    'living_expenses_fields' => [
      'acc_no' => '123456',
      'type' => 1,
      'city' => '湖南衡阳',
      'address' => '广东省深圳市南山区海天二路33号',
      'acc_name' => '詹讯',
      'company_name' => '深圳电力',
      'amount' => 500,
    ],
    'extra_fields1' => '{"key1":"value1"}',
    'extra_fields2' => '{"key1":"value1"}',
    'extra_fields3' => '{"key1":"value1"}',
  ],
  'headers' => [
    'Wechatpay-Serial' => 'PUB_KEY_ID_0114232134912410000000000000',
  ],
])
->then(static function(\Psr\Http\Message\ResponseInterface $response) {
  print_r(json_decode((string) $response->getBody(), true));
})
->wait();
php
$response = $instance->v3->merchantRiskManage->reportTradeUnionInformation->post([
  'json' => [
    'sp_mchid' => '1900000109',
    'acquiring_bank_id' => '1356485',
    'channel_id' => '1900000108',
    'sub_mchid' => '1900009231',
    'out_trade_no' => '1217752501201407033233368018',
    'openid' => 'oUpF8uMuAJO_M2pxb1Q9zNjWeS6o',
    'phone' => 'ca775af5f841bdf424b2e6eb86a6e21e',
    'certificates_number' => 'ca775af5f841bdf424b2e6eb86a6e21e',
    'client_ip' => '123.12.12.123',
    'risk_level' => 1,
    'line_type' => 1,
    'goods_type' => 1,
    'seller_type' => 1,
    'is_need_deliver' => true,
    'device_type' => 1,
    'userid' => '华为的账号：260XXX',
    'phone_from' => 1,
    'seller_userid' => '抖音的账号：XXXXX',
    'scene' => 1,
    'recharge_fields' => [
      'account_type' => 1,
      'account' => 'example_account',
    ],
    'living_expenses_fields' => [
      'acc_no' => '123456',
      'type' => 1,
      'city' => '湖南衡阳',
      'address' => '广东省深圳市南山区海天二路33号',
      'acc_name' => '詹讯',
      'company_name' => '深圳电力',
      'amount' => 500,
    ],
    'extra_fields1' => '{"key1":"value1"}',
    'extra_fields2' => '{"key1":"value1"}',
    'extra_fields3' => '{"key1":"value1"}',
  ],
  'headers' => [
    'Wechatpay-Serial' => 'PUB_KEY_ID_0114232134912410000000000000',
  ],
]);
print_r(json_decode((string) $response->getBody(), true));
php
$response = $instance->chain('v3/merchant-risk-manage/report-trade-union-information')->post([
  'json' => [
    'sp_mchid' => '1900000109',
    'acquiring_bank_id' => '1356485',
    'channel_id' => '1900000108',
    'sub_mchid' => '1900009231',
    'out_trade_no' => '1217752501201407033233368018',
    'openid' => 'oUpF8uMuAJO_M2pxb1Q9zNjWeS6o',
    'phone' => 'ca775af5f841bdf424b2e6eb86a6e21e',
    'certificates_number' => 'ca775af5f841bdf424b2e6eb86a6e21e',
    'client_ip' => '123.12.12.123',
    'risk_level' => 1,
    'line_type' => 1,
    'goods_type' => 1,
    'seller_type' => 1,
    'is_need_deliver' => true,
    'device_type' => 1,
    'userid' => '华为的账号：260XXX',
    'phone_from' => 1,
    'seller_userid' => '抖音的账号：XXXXX',
    'scene' => 1,
    'recharge_fields' => [
      'account_type' => 1,
      'account' => 'example_account',
    ],
    'living_expenses_fields' => [
      'acc_no' => '123456',
      'type' => 1,
      'city' => '湖南衡阳',
      'address' => '广东省深圳市南山区海天二路33号',
      'acc_name' => '詹讯',
      'company_name' => '深圳电力',
      'amount' => 500,
    ],
    'extra_fields1' => '{"key1":"value1"}',
    'extra_fields2' => '{"key1":"value1"}',
    'extra_fields3' => '{"key1":"value1"}',
  ],
  'headers' => [
    'Wechatpay-Serial' => 'PUB_KEY_ID_0114232134912410000000000000',
  ],
]);
print_r(json_decode((string) $response->getBody(), true));
php
$response = $instance['v3/merchant-risk-manage/report-trade-union-information']->post([
  'json' => [
    'sp_mchid' => '1900000109',
    'acquiring_bank_id' => '1356485',
    'channel_id' => '1900000108',
    'sub_mchid' => '1900009231',
    'out_trade_no' => '1217752501201407033233368018',
    'openid' => 'oUpF8uMuAJO_M2pxb1Q9zNjWeS6o',
    'phone' => 'ca775af5f841bdf424b2e6eb86a6e21e',
    'certificates_number' => 'ca775af5f841bdf424b2e6eb86a6e21e',
    'client_ip' => '123.12.12.123',
    'risk_level' => 1,
    'line_type' => 1,
    'goods_type' => 1,
    'seller_type' => 1,
    'is_need_deliver' => true,
    'device_type' => 1,
    'userid' => '华为的账号：260XXX',
    'phone_from' => 1,
    'seller_userid' => '抖音的账号：XXXXX',
    'scene' => 1,
    'recharge_fields' => [
      'account_type' => 1,
      'account' => 'example_account',
    ],
    'living_expenses_fields' => [
      'acc_no' => '123456',
      'type' => 1,
      'city' => '湖南衡阳',
      'address' => '广东省深圳市南山区海天二路33号',
      'acc_name' => '詹讯',
      'company_name' => '深圳电力',
      'amount' => 500,
    ],
    'extra_fields1' => '{"key1":"value1"}',
    'extra_fields2' => '{"key1":"value1"}',
    'extra_fields3' => '{"key1":"value1"}',
  ],
  'headers' => [
    'Wechatpay-Serial' => 'PUB_KEY_ID_0114232134912410000000000000',
  ],
]);
print_r(json_decode((string) $response->getBody(), true));
返回字典类型描述
sp_mchidstring微信支付分配的服务商唯一标识
acquiring_bank_idstring微信支付分配的从业机构唯一标识
channel_idstring微信支付分配的渠道商唯一标识
sub_mchidstring上报订单风险数据的商户号信息
out_trade_nostring商户系统内部订单号

参阅 官方文档

Published on the GitHub by TheNorthMemory