诺云开放平台

Appearance

供应商基本信息与收款信息 ​

请求路径 ​

  • 请求方式：POST
  • 请求头：Content-Type:application/json
  • 接口地址：https://gateway.nuoyunapi.com/Api/Supplier/getSupplierList/2.0.0
  • 频率限制：10秒1000次

说明 ​

  • 分页返回供应商基本信息和该供应商最新的有效收款账户信息。
  • 未配置收款账户时，settlement 中的字段返回对应类型的零值。
  • 商户 uid 由 API 鉴权结果带入，仅返回当前账号的数据，请求参数无需传入 uid。
  • 接口不返回供应商登录密码、支付原始报文、协议签署地址等敏感信息。

请求参数 ​

参数必选类型描述
page是integer页码，从 1 开始
page_size是integer每页数量，范围 1～100
supplier_id否integer供应商 ID，精确查询
supplier_name否string供应商名称，模糊查询
status否integer供应商状态：1-启用，2-停用；不传表示全部

请求示例 ​

json
{
    "page": 1,
    "page_size": 20,
    "supplier_name": "示例供应商",
    "status": 1
}

响应参数 ​

参数必选类型描述
code是integer状态码：200-成功，400-失败
msg是string提示信息
trace_id否string链路追踪 ID
data是object响应内容

data 参数结构 ​

参数必选类型描述
total是integer符合条件的供应商总数
list是array供应商列表

list 参数结构 ​

参数必选类型描述
supplier_id是integer供应商 ID
supplier_name是string供应商名称
province是string省
city是string市
district是string区县
address是string详细地址
manager_name是string负责人姓名
manager_phone是string负责人手机号
status是integer供应商状态：1-启用，2-停用
supplier_system_status是integer供应商系统状态：1-启用，2-停用
merchant_status是integer商户号状态：1-未开通，2-已开通
remark是string备注
create_time是string创建时间
update_time是string更新时间
settlement是object收款信息

settlement 参数结构 ​

参数必选类型描述
account_id是integer结算账户 ID
account_name是string结算账户名称
account_status是integer账户状态：1-启用，2-禁用，3-未启用
open_status是integer开户状态：1-已开户，2-未开户
merchant_no是string支付渠道商户编号
merchant_name是string支付渠道商户名称
collect_status是integer收款状态：0-未知，1-已开通，2-未开通
collect_switch是integer收款开关：1-开启，2-关闭
pay_method是string收款渠道
application_status是integer开户申请状态：1-审核中，2-审核退回，3-协议签署中，4-开户中，5-已完成

响应示例 ​

json
{
    "code": 200,
    "msg": "Success",
    "trace_id": "trace_****",
    "data": {
        "total": 1,
        "list": [
            {
                "supplier_id": 10001,
                "supplier_name": "示例供应商",
                "province": "示例省",
                "city": "示例市",
                "district": "示例区",
                "address": "示例路",
                "manager_name": "供应商负责人",
                "manager_phone": "138****8000",
                "status": 1,
                "supplier_system_status": 1,
                "merchant_status": 2,
                "remark": "",
                "create_time": "2026-09-01 10:00:00",
                "update_time": "2026-09-18 10:00:00",
                "settlement": {
                    "account_id": 60001,
                    "account_name": "示例结算账户",
                    "account_status": 1,
                    "open_status": 1,
                    "merchant_no": "merchant_****",
                    "merchant_name": "示例商户",
                    "collect_status": 1,
                    "collect_switch": 1,
                    "pay_method": "示例收款渠道",
                    "application_status": 5
                }
            }
        ]
    }
}

状态码说明 ​

状态码描述
200成功
400失败，如参数格式不正确

鉴权说明 ​

本接口为 OpenAPI 2.0.0 接口，需使用 API 鉴权（X-Ca-Key、X-Ca-Secret 或 X-Ca-Timestamp + X-Ca-Md5 签名），详见 接口签名介绍。