Skip to content

查询指定主体子商户列表

接口适用场景:收付通(平台)服务商可通过本接口,查询其名下指定主体的子商户列表。1、通过organization_type与cert_number定位主体。2、仅返回属于指定主体、与当前服务商存在有效父子绑定关系且未注销的子商户。3、支持limit/offset分页查询。

请求参数类型描述
queryobject声明请求的查询参数
organization_typestring主体类型
SUBJECT_TYPE_ENTERPRISE | SUBJECT_TYPE_INSTITUTIONS_CLONED | SUBJECT_TYPE_INDIVIDUAL | SUBJECT_TYPE_OTHERS | SUBJECT_TYPE_GOVERNMENT | SUBJECT_TYPE_MICRO 枚举值之一
cert_numberstring证件号码
limitinteger分页大小
offsetinteger分页偏移
headersobject声明请求的头参数
Wechatpay-Serialstring微信支付公钥ID/平台证书序列号
php
$instance->v3->ecommerce->subjectSubMerchants->getAsync([
  'query' => [
    'organization_type' => 'SUBJECT_TYPE_ENTERPRISE',
    'cert_number'       => 'Iuas%2BxWj7ma0t%',
    'limit'             => 20,
    'offset'            => 0,
  ],
  '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/ecommerce/subject-sub-merchants')->getAsync([
  'query' => [
    'organization_type' => 'SUBJECT_TYPE_ENTERPRISE',
    'cert_number'       => 'Iuas%2BxWj7ma0t%',
    'limit'             => 20,
    'offset'            => 0,
  ],
  '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/ecommerce/subject-sub-merchants']->getAsync([
  'query' => [
    'organization_type' => 'SUBJECT_TYPE_ENTERPRISE',
    'cert_number'       => 'Iuas%2BxWj7ma0t%',
    'limit'             => 20,
    'offset'            => 0,
  ],
  '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->ecommerce->subjectSubMerchants->get([
  'query' => [
    'organization_type' => 'SUBJECT_TYPE_ENTERPRISE',
    'cert_number'       => 'Iuas%2BxWj7ma0t%',
    'limit'             => 20,
    'offset'            => 0,
  ],
  'headers' => [
    'Wechatpay-Serial' => 'PUB_KEY_ID_0114232134912410000000000000',
  ],
]);
print_r(json_decode((string) $response->getBody(), true));
php
$response = $instance->chain('v3/ecommerce/subject-sub-merchants')->get([
  'query' => [
    'organization_type' => 'SUBJECT_TYPE_ENTERPRISE',
    'cert_number'       => 'Iuas%2BxWj7ma0t%',
    'limit'             => 20,
    'offset'            => 0,
  ],
  'headers' => [
    'Wechatpay-Serial' => 'PUB_KEY_ID_0114232134912410000000000000',
  ],
]);
print_r(json_decode((string) $response->getBody(), true));
php
$response = $instance['v3/ecommerce/subject-sub-merchants']->get([
  'query' => [
    'organization_type' => 'SUBJECT_TYPE_ENTERPRISE',
    'cert_number'       => 'Iuas%2BxWj7ma0t%',
    'limit'             => 20,
    'offset'            => 0,
  ],
  'headers' => [
    'Wechatpay-Serial' => 'PUB_KEY_ID_0114232134912410000000000000',
  ],
]);
print_r(json_decode((string) $response->getBody(), true));
返回字典类型描述
dataobject[]子商户列表
sub_mchidstring子商户号
merchant_shortnamestring商户简称
sign_timestring签约时间
offsetinteger分页偏移
limitinteger分页大小
total_countinteger总条数

参阅 官方文档

Published on the GitHub by TheNorthMemory