付款人查询

接口信息

• 路径: /api/v1/acct/queryPayer
• 方法: POST
• Content-Type: application/json

业务说明

• 核心付款接口
• 前置条件:根据字段查询付款方的相关信息

请求参数

Headers

请求头

参数名	值	必填	说明
Content-Type	application/json	是	请求体类型

Request Body

主要参数

参数名	类型	说明	必填
size	integer	每页条数，默认 10, -1代表全部	M
current	integer	当前页，默认 1	M
column	string	需要进行排序的字段，默认使用 create_time	M
asc	boolean	是否正序排列，默认 false	M
id	integer	openId查询	C
merchantNo	integer	商户号	M
subEntityType	string	类型:0企业 1个人	C
CompanyName	string	企业中文名称	C
CompanyNameEn	string	企业英文	C
firstname	string	名(firstname)	C
lastname	string	姓(Lastname)	C
country	string	注册国家	C
registerNo	string	注册号码	C
idType	string	证件类型	C
registerDate	string	注册日期	C
sign	string	签名	M

请求示例

Request

{
  "merchantNo": 801129,
  "size": "10",
  "current": "1",
  "column": "create_time",
  "asc": false ,
  "sign":"d2ea92efff636320122021f65b613201403f6d34334cfbc7e589ce9f842282q5"
}

响应结果

响应头 Headers

参数名	值	必填	说明
content-type	application/json;charset=UTF-8	是	响应体类型

响应参数

响应字段

参数名	类型	说明
respCode	string	响应码
respMsg	string	响应信息
data	object
─records	array

响应示例

Response

{
  "respCode": "20000",
  "respMsg": "Success",
  "data": {
    "records": [
      {
        "id": "1984096429476806656",
        "createTime": "2025-10-31 11:13:46",
        "merchantNo": "801129",
        "companyNameEn": "keyma LTD.",
        "companyName": "卡玛有限公司yuan",
        "country": "GB",
        "addressEn1": "Nanshan Science & Technology Park, Shenzhen",
        "addressEn2": "2all",
        "addressEn3": "3",
        "registerNo": "4563456546",
        "registerDate": "2006-08-04",
        "postcode": "518057",
        "status": 0,
        "email": "324321@qq.com",
        "areaCode": "+86",
        "phoneNumber": "15072871023",
        "state": "London",
        "city": "London",
        "subEntityType": "0",
        "firstName": null,
        "lastName": null,
        "idType": "2",
        "idNumber": "4563456546",
        "birthDate": null,
        "idValidDateFrom": "2006-08-04",
        "idValidDateTo": "2046-08-04"
      },
      {
        "id": "1976553170621833216",
        "createTime": "2025-10-10 15:39:33",
        "merchantNo": "801129",
        "companyNameEn": "keyma LTD.",
        "companyName": "卡玛有限公司yuan",
        "country": "GB",
        "addressEn1": "Nanshan Science & Technology Park, Shenzhen",
        "addressEn2": "2all",
        "addressEn3": "3",
        "registerNo": "4563456546",
        "registerDate": "2006-08-04",
        "postcode": "518057",
        "status": 0,
        "email": "324321@qq.com",
        "areaCode": "+86",
        "phoneNumber": "15072871023",
        "state": "London",
        "city": "London",
        "subEntityType": "0",
        "firstName": null,
        "lastName": null,
        "idType": "2",
        "idNumber": "4563456546",
        "birthDate": null,
        "idValidDateFrom": "2006-08-04",
        "idValidDateTo": "2046-08-04"
      },
      {
        "id": "1976551157477548032",
        "createTime": "2025-10-10 15:31:33",
        "merchantNo": "801129",
        "companyNameEn": "keyma LTD.",
        "companyName": "卡玛有限公司yuan",
        "country": "GB",
        "addressEn1": "Nanshan Science & Technology Park, Shenzhen",
        "addressEn2": "2all",
        "addressEn3": "3",
        "registerNo": "4563456546",
        "registerDate": null,
        "postcode": "518057",
        "status": 0,
        "email": "324321@qq.com",
        "areaCode": "+86",
        "phoneNumber": "15072871023",
        "state": "London",
        "city": "London",
        "subEntityType": "0",
        "firstName": null,
        "lastName": null,
        "idType": "2",
        "idNumber": "4563456546",
        "birthDate": null,
        "idValidDateFrom": "2006-08-04",
        "idValidDateTo": "2046-08-04"
      },
      {
        "id": "1976550853239513088",
        "createTime": "2025-10-10 15:30:21",
        "merchantNo": "801129",
        "companyNameEn": null,
        "companyName": null,
        "country": "CN",
        "addressEn1": "Nanshan Science & Technology Park, Shenzhen",
        "addressEn2": "yuan2",
        "addressEn3": "yuan3",
        "registerNo": null,
        "registerDate": null,
        "postcode": "518057",
        "status": 0,
        "email": "272005999@qq.com",
        "areaCode": "+86",
        "phoneNumber": "15072871022",
        "state": "hubei",
        "city": "wuhan",
        "subEntityType": "1",
        "firstName": "li",
        "lastName": "yuan",
        "idType": "0",
        "idNumber": "371328198410044019",
        "birthDate": "2000-10-04",
        "idValidDateFrom": "2016-08-04",
        "idValidDateTo": "2026-08-04"
      }
    ],
    "total": 4,
    "size": 10,
    "current": 1,
    "orders": [
      {
        "column": "create_time",
        "asc": false
      }
    ],
    "hitCount": false,
    "searchCount": true,
    "pages": 1
  }
}