5. Query PMS Collection Result

API Path

/api/open/alipayhk/businessdistrict/circleStore/queryPage

Sample: https://open.alipay.hk/api/open/alipayhk/businessdistrict/circleStore/queryPage

API Request

Request

Header

Name

Description

Type

Length

Required

Remarks

Sample

client-id

Client ID

String

M

211020000000000000044

signature

Message signature information

String

M

algorithm=sha256withrsa,keyVersion=2,signature=xxxxxxxxxxxyyyyyyyyyyyyyyzzzzzzzzz==

encrypt

Message encryption information

String

O

algorithm=rsa, keyVersion=2

Content-type

HTTP content type

String

M

application/json; charset=UTF-8

Body

Field

Type

Length

Required

Remarks

Sample

businessDistrictSubject

BusinessDistrictSubjectVO

M

The mall‘s information defined by AlipayHK

"businessDistrictSubject": {

"mallGroupLabel": "20240316",

"mallLabel": ""

}

pageInfo

PageInfo

M

Sub-page information

"pageInfo": {

"pageSize": "20",

"pageIndex": "3",

"totalPageCount": "0",

"totalItemCount": "0"

}

BusinessDistrictSubjectVO

Field

Type

Length

Required

Remarks

Sample

mallGroupLabel

java.lang.String

M

The IDs assigned by AlipayHK to each group

20230316

mallLabel

java.lang.String

M

The IDs assigned by AlipayHK to each mall

20230316

PageInfo

Field

Type

Length

Required

Remarks

Sample

pageSize

java.lang.String

M

Number of lines of record displayed on the page

20

pageIndex

java.lang.String

M

Index of the opage

3

totalPageCount

java.lang.String

M

Total number of pages

0

totalItemCount

java.lang.String

M

Total number of records

0

Response

Header

Name

Description

Type

Length

Required

Remarks

Sample

client-id

Client ID

String

M

211020000000000000044

signature

Message signature information

String

M

algorithm=sha256withrsa,keyVersion=2,signature=xxxxxxxxxxxyyyyyyyyyyyyyyzzzzzzzzz==

encrypt

Message encryption information

String

O

algorithm=rsa, keyVersion=2

Content-type

HTTP content type

String

M

application/json; charset=UTF-8

Body

Field

Type

Length

Required

Remarks

Sample

businessDistrictCircleStores

List<BusinesDistrictCircleStorePageVO>

M

The store list

"businessDistrictCircleStores": [

{

"businessDistrictSubject": {

"mallGroupLabel": "20240316",

"mallLabel": "20240323"

},

"merchantName": "家乐福商家",

"storeName": "家乐福"

}]

pageInfo

PageInfo

M

Page Information

"pageInfo": {

"pageIndex": 3,

"pageSize": 20,

"totalItemCount": 104,

"totalPageCount": 6

},

result

Result|2.0

M

Result

"result": {

"resultCode": "SUCCESS",

"resultMessage": "success.",

"resultStatus": "S"

}

PageInfo

Field

Type

Length

Required

Remarks

Sample

pageIndex

java.lang.String

M

"pageIndex": 3,

pageSize

java.lang.String

M

"pageSize": 20,

totalPageCount

java.lang.String

M

"totalItemCount": 104,

totalItemCount

java.lang.String

M

"totalPageCount": 6

BusinesDistrictCircleStorePageVO

Field

Type

Length

Required

Remarks

Sample

businessDistrictSubject

BusinessDistrictSubjectVO

M

"businessDistrictSubject": {

"mallGroupLabel": "20240316",

"mallLabel": "20240323"

}

merchantName

java.lang.String

M

"merchantName": "家乐福商家",

storeName

java.lang.String

M

"storeName": "家乐福"

pmsLabel

java.lang.String

M

"pmsLabel": "2023041219161407000009000012056"

BusinessDistrictSubjectVO

Field

Type

Length

Required

Remarks

Sample

mallGroupLabel

java.lang.String

M

The IDs assigned by AlipayHK to each group

20230316

mallLabel

java.lang.String

M

The IDs assigned by AlipayHK to each mall

20230316

Result

Field

Type

Length

Required

Description

Sample

resultCode

java.lang.String

M

Result code

SUCCESS

resultStatus

java.lang.String

M

Result status

F - failed S- success

resultMessage

java.lang.String

M

Result message

success

Result Code

Result Code

Result Message

Result Status

Description

SUCCESS

success

S

BUSINESS_DISTRICT_NOT_EXIST

The business district does not exist

F

PARAM_ILLEGAL

Illegal parameters. For example, non-numeric input, invalid date.

F

UNKNOWN_EXCEPTION

API failed due to unknown reason.

F

3. Request Example

Request

copy
{
  "businessDistrictSubject": {
    "mallGroupLabel": "20240316",
    "mallLabel": "20240316"
  },
  "pageInfo": {
    "pageSize": "20",
    "pageIndex": "3",
    "totalPageCount": "0",
    "totalItemCount": "0"
  }
}

Response

copy
{
  "businessDistrictCircleStores": [
    {
      "businessDistrictSubject": {
        "mallGroupLabel": "20240316",
        "mallLabel": "20240323"
      },
      "merchantName": "家乐福商家",
      "storeName": "家乐福",
      "pmsLabel": "2023041219161407000009000012051"
    },
    {
      "businessDistrictSubject": {
        "mallGroupLabel": "20240316",
        "mallLabel": "20240323"
      },
      "merchantName": "家乐福商家",
      "storeName": "家乐福",
      "pmsLabel": "2023041219161407000009000012052"
    },
    {
      "businessDistrictSubject": {
        "mallGroupLabel": "20240316",
        "mallLabel": "20240323"
      },
      "merchantName": "家乐福商家",
      "storeName": "家乐福",
      "pmsLabel": "2023041219161407000009000012053"
    },
    {
      "businessDistrictSubject": {
        "mallGroupLabel": "20240316",
        "mallLabel": "20240323"
      },
      "merchantName": "家乐福商家",
      "storeName": "家乐福",
      "pmsLabel": "2023041219161407000009000012054"
    },
    {
      "businessDistrictSubject": {
        "mallGroupLabel": "20240316",
        "mallLabel": "20240323"
      },
      "merchantName": "家乐福商家",
      "storeName": "家乐福",
      "pmsLabel": "2023041219161407000009000012055"
    },
    {
      "businessDistrictSubject": {
        "mallGroupLabel": "20240316",
        "mallLabel": "20240323"
      },
      "merchantName": "家乐福商家",
      "storeName": "家乐福",
      "pmsLabel": "2023041219161407000009000012056"
    },
    {
      "businessDistrictSubject": {
        "mallGroupLabel": "20240316",
        "mallLabel": "20240323"
      },
      "merchantName": "家乐福商家",
      "storeName": "家乐福",
      "pmsLabel": "2023041219161407000009000012057"
    },
    {
      "businessDistrictSubject": {
        "mallGroupLabel": "20240316",
        "mallLabel": "20240323"
      },
      "merchantName": "家乐福商家",
      "storeName": "家乐福",
      "pmsLabel": "2023041219161407000009000012058"
    },
    {
      "businessDistrictSubject": {
        "mallGroupLabel": "20240316",
        "mallLabel": "20240322"
      },
      "merchantName": "家乐福商家",
      "storeName": "家乐福",
      "pmsLabel": "2023041219161407000009000012059"
    },
    {
      "businessDistrictSubject": {
        "mallGroupLabel": "20240316",
        "mallLabel": "20240322"
      },
      "merchantName": "家乐福商家",
      "storeName": "家乐福",
      "pmsLabel": "2023041219161407000009000012060"
    },
    {
      "businessDistrictSubject": {
        "mallGroupLabel": "20240316",
        "mallLabel": "20240322"
      },
      "merchantName": "家乐福商家",
      "storeName": "家乐福",
      "pmsLabel": "2023041219161407000009000012061"
    },
    {
      "businessDistrictSubject": {
        "mallGroupLabel": "20240316",
        "mallLabel": "20240322"
      },
      "merchantName": "家乐福商家",
      "storeName": "家乐福",
      "pmsLabel": "2023041219161407000009000012062"
    },
    {
      "businessDistrictSubject": {
        "mallGroupLabel": "20240316",
        "mallLabel": "20240322"
      },
      "merchantName": "家乐福商家",
      "storeName": "家乐福",
      "pmsLabel": "2023041219161407000009000012063"
    },
    {
      "businessDistrictSubject": {
        "mallGroupLabel": "20240316",
        "mallLabel": "20240322"
      },
      "merchantName": "家乐福商家",
      "storeName": "家乐福",
      "pmsLabel": "2023041219161407000009000012064"
    },
    {
      "businessDistrictSubject": {
        "mallGroupLabel": "20240316",
        "mallLabel": "20240322"
      },
      "merchantName": "家乐福商家",
      "storeName": "家乐福",
      "pmsLabel": "2023041219161407000009000012065"
    },
    {
      "businessDistrictSubject": {
        "mallGroupLabel": "20240316",
        "mallLabel": "20240322"
      },
      "merchantName": "家乐福商家",
      "storeName": "家乐福",
      "pmsLabel": "2023041219161407000009000012066"
    },
    {
      "businessDistrictSubject": {
      "mallGroupLabel": "20240316",
      "mallLabel": "20240322"
    },
      "merchantName": "家乐福商家",
      "storeName": "家乐福",
      "pmsLabel": "2023041219161407000009000012067"
    },
      {
      "businessDistrictSubject": {
      "mallGroupLabel": "20240316",
      "mallLabel": "20240322"
    },
      "merchantName": "家乐福商家",
      "storeName": "家乐福",
      "pmsLabel": "2023041219161407000009000012068"
    },
      {
      "businessDistrictSubject": {
      "mallGroupLabel": "20240316",
      "mallLabel": "20240321"
    },
      "merchantName": "家乐福商家",
      "storeName": "家乐福",
      "pmsLabel": "2023041219161407000009000012069"
    },
      {
      "businessDistrictSubject": {
      "mallGroupLabel": "20240316",
      "mallLabel": "20240321"
    },
      "merchantName": "家乐福商家",
      "storeName": "家乐福",
      "pmsLabel": "2023041219161407000009000012070"
    }
      ],
      "pageInfo": {
      "pageIndex": 3,
      "pageSize": 20,
      "totalItemCount": 104,
      "totalPageCount": 6
    },
      "result": {
      "resultCode": "SUCCESS",
      "resultMessage": "success.",
      "resultStatus": "S"
    }
    }