Payer Query

API Information

• Path: /api/v1/acct/queryPayer
• Method: POST
• Content-Type: application/json

Business Description

• Core payment interface
• Prerequisites: Query payer related information based on fields

Request Parameters

Headers

Request Headers

Parameter	Value	Required	Description
Content-Type	application/json	Yes	Request body type

Request Body

Main Parameters

Parameter	Type	Description	Required
size	integer	Records per page, default 10, -1 for all	M
current	integer	Current page, default 1	M
column	string	Field for sorting, default create_time	M
asc	boolean	Ascending order, default false	M
id	integer	Query by ID	C
merchantNo	integer	Merchant Number	C
subEntityType	string	Type: 0 Corporate 1 Individual	C
CompanyName	string	Company Chinese Name	C
CompanyNameEn	string	Company English Name	C
firstname	string	First Name	C
lastname	string	Last Name	C
country	string	Registration Country	C
registerNo	string	Registration Number	C
idType	string	ID Type	C
registerDate	string	Registration Date	C
sign	string	Signature	C

Request Example

Request

{
  "size": "10",
  "current": "1",
  "column": "create_time",
  "asc": "false",
  "id": 0,
  "merchantNo": 800538,
  "subEntityType": "0",
  "CompanyName": "",
  "CompanyNameEn": "",
  "firstname": "",
  "lastname": "",
  "country": "",
  "registerNo": "",
  "idType": "0",
  "registerDate": "",
  "sign": ""
}

Response

Response Headers

Parameter	Value	Required	Description
content-type	application/json;charset=UTF-8	Yes	Response body type

Response Parameters

Response Fields

Parameter	Type	Description
respCode	string	Response Code
respMsg	string	Response Message
data	object	Response Data
─records	array	Records

Response Example

Response

{
  "respCode": "20000",
  "respMsg": "Success",
  "data": {
    "records": [
      {
        "id": "1955195963342979072",
        "createTime": "2025-08-12 17:13:38",
        "merchantNo": "800149",
        "companyNameEn": null,
        "companyName": null,
        "country": "CN",
        "addressEn1": "Nanshan Science & Technology Park, Shenzhen",
        "addressEn2": "2",
        "addressEn3": "3",
        "registerNo": null,
        "registerDate": null,
        "postcode": "518057",
        "status": 0,
        "email": "1@qq.com",
        "areaCode": "+86",
        "phoneNumber": "15072871023",
        "state": "shandong",
        "city": "linzhe",
        "subEntityType": "1",
        "firstName": "zhang",
        "lastName": "san",
        "idType": "0",
        "idNumber": "371328198410041111",
        "birthDate": "1984-10-04",
        "idValidDateFrom": "2016-08-04",
        "idValidDateTo": "2026-08-04"
      }
    ],
    "total": 1,
    "size": 10,
    "current": 1,
    "orders": [
      {
        "column": "create_time",
        "asc": false
      }
    ],
    "hitCount": false,
    "searchCount": true,
    "pages": 1
  }
}