> For the complete documentation index, see [llms.txt](https://docs-cn.multimarkets.org/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs-cn.multimarkets.org/manager-api/geng-duo-.../ke-hu-fu-wu-xiang-guan.md). # 客户服务相关 ## 检测客户信息是否存在 > version=0.0.1\ > bizType=customer.app.CustomerWebApiService.checkCustomerExist ```json {"openapi":"3.0.1","info":{"title":"默认模块","version":"1.0.0"},"tags":[{"name":"客户服务相关"}],"servers":[{"url":"https://pre-api-test.cmfbl.com/openapi-b","description":"PRE环境-公司439"}],"security":[],"paths":{"/customer.app.CustomerWebApiService.checkCustomerExist":{"post":{"summary":"检测客户信息是否存在","deprecated":false,"description":"version=0.0.1\nbizType=customer.app.CustomerWebApiService.checkCustomerExist","tags":["客户服务相关"],"parameters":[{"name":"trace","in":"header","description":"全局链路唯一标志","required":true,"schema":{"type":"string"}},{"name":"companyId","in":"header","description":"公司ID","required":true,"schema":{"type":"string"}},{"name":"version","in":"header","description":"接口版本号","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"integer","description":"注册登录方式：1邮箱，2手机号码，3客户账号"},"loginName":{"type":"string","description":"账号：邮箱/手机号码"},"phoneArea":{"type":"string","description":"手机区号，区号默认为+86"},"emailArea":{"type":"string","description":"邮箱区号，区号默认为+86"}},"required":["type","loginName"]}}}},"responses":{"200":{"description":"","content":{"application/json":{"schema":{"type":"object","properties":{"bizCode":{"type":"string","title":"模块标识码","description":"模块标识码"},"code":{"type":"string","title":"状态返回码","description":"状态返回码"},"msg":{"type":"string","title":"状态描述","description":"状态描述"},"tm":{"type":"string","title":"处理时长（毫秒）","description":"处理时长（毫秒）"},"trace":{"type":"string","title":"跟踪码","description":"跟踪码"},"msgParams":{"type":"string","title":"返回描述中占位符参数串，多个参数间以,分割","description":"返回描述中占位符参数串，多个参数间以,分割"},"data":{"type":"integer","title":"1已存在,2不存在","description":"1已存在,2不存在"}},"required":["bizCode","code","tm"]}}},"headers":{}}}}}}} ``` ## 客户注册 > \`\`\`\ > 公司默认客户组资产列表示例：\*通过前端H5/PCUI数据提供\*\ > "tradeTypeCurrencyList":\ > \[\ > {\ > "allCurrency": "USDT",\ > "tradeType": "1",\ > "isWallet": "",\ > "alias": "",\ > "id": "1",\ > "name": "合约全仓"\ > },\ > {\ > "allCurrency": "USDT",\ > "tradeType": "2",\ > "isWallet": "",\ > "alias": "",\ > "id": "2",\ > "name": "合约逐仓"\ > },\ > {\ > "allCurrency": "USDT,USD,BTC,SAND,LINK,AAVE,DOGE,BCH,ETH,BNB,SOL,AVAX,SHIB,UNI,DOT,XRP,ADA,FIL,V10",\ > "tradeType": "3",\ > "isWallet": "",\ > "alias": "",\ > "id": "3",\ > "name": "杠杆"\ > },\ > {\ > "allCurrency": \ > "USDT,BTC,LINK,ETH,SAND,USD,REEF,ADA,AAVE,DOT,ARX4,BNB,DOGE,ARX10,V10,qa001,qa002,M10,XRP,SHIB,EOS,XEC,FIL,FFT,NFT,QA003,QA004,QA005,QA006,QA007,QA008",\ > "tradeType": "5",\ > "isWallet": "",\ > "alias": "",\ > "id": "5",\ > "name": "现货"\ > }\ > ]\ > \`\`\`\ > \`\`\`\ > 邮箱注册示例：\*登录密码(pwd)MD5加密\*\ > {\ > "email": "<16612339304927@qq.com>",\ > "emailArea": "+86",\ > "pwd": "dc483e80a7a0bd9ef71d8cf973673924",\ > "country": "CN",\ > "customerGroupId": 1,\ > "registerSource": 1,\ > "tradeTypeCurrencyList": \[...]\ > }\ > \`\`\`\ > \`\`\`\ > 手机注册示例：\*登录密码(pwd)MD5加密\*\ > {\ > "phone": "15167651757",\ > "country": "CN",\ > "customerGroupId": 1,\ > "registerSource": 1,\ > "tradeTypeCurrencyList": \[...],\ > "phoneArea": "+86",\ > "pwd": "dc483e80a7a0bd9ef71d8cf973673924"\ > }\ > \`\`\` ````json {"openapi":"3.0.1","info":{"title":"默认模块","version":"1.0.0"},"tags":[{"name":"客户服务相关"}],"servers":[{"url":"https://pre-api-test.cmfbl.com/openapi-b","description":"PRE环境-公司439"}],"security":[],"paths":{"/customer.admin.WhiteCustomerAdminApiService.addCusAndOpenAccountAndKyc":{"post":{"summary":"客户注册","deprecated":false,"description":"```\n公司默认客户组资产列表示例：*通过前端H5/PCUI数据提供*\n\"tradeTypeCurrencyList\":\n [\n {\n \"allCurrency\": \"USDT\",\n \"tradeType\": \"1\",\n \"isWallet\": \"\",\n \"alias\": \"\",\n \"id\": \"1\",\n \"name\": \"合约全仓\"\n },\n {\n \"allCurrency\": \"USDT\",\n \"tradeType\": \"2\",\n \"isWallet\": \"\",\n \"alias\": \"\",\n \"id\": \"2\",\n \"name\": \"合约逐仓\"\n },\n {\n \"allCurrency\": \"USDT,USD,BTC,SAND,LINK,AAVE,DOGE,BCH,ETH,BNB,SOL,AVAX,SHIB,UNI,DOT,XRP,ADA,FIL,V10\",\n \"tradeType\": \"3\",\n \"isWallet\": \"\",\n \"alias\": \"\",\n \"id\": \"3\",\n \"name\": \"杠杆\"\n },\n {\n \"allCurrency\": \n \"USDT,BTC,LINK,ETH,SAND,USD,REEF,ADA,AAVE,DOT,ARX4,BNB,DOGE,ARX10,V10,qa001,qa002,M10,XRP,SHIB,EOS,XEC,FIL,FFT,NFT,QA003,QA004,QA005,QA006,QA007,QA008\",\n \"tradeType\": \"5\",\n \"isWallet\": \"\",\n \"alias\": \"\",\n \"id\": \"5\",\n \"name\": \"现货\"\n }\n ]\n```\n```\n邮箱注册示例：*登录密码(pwd)MD5加密*\n{\n \"email\": \"16612339304927@qq.com\",\n \"emailArea\": \"+86\",\n \"pwd\": \"dc483e80a7a0bd9ef71d8cf973673924\",\n \"country\": \"CN\",\n \"customerGroupId\": 1,\n \"registerSource\": 1,\n \"tradeTypeCurrencyList\": [...]\n}\n```\n```\n手机注册示例：*登录密码(pwd)MD5加密*\n{\n \"phone\": \"15167651757\",\n \"country\": \"CN\",\n \"customerGroupId\": 1,\n \"registerSource\": 1,\n \"tradeTypeCurrencyList\": [...],\n \"phoneArea\": \"+86\",\n \"pwd\": \"dc483e80a7a0bd9ef71d8cf973673924\"\n}\n```","tags":["客户服务相关"],"parameters":[{"name":"trace","in":"header","description":"全局链路唯一标志","required":true,"schema":{"type":"string"}},{"name":"token","in":"header","description":"鉴权码","required":true,"schema":{"type":"string"}},{"name":"version","in":"header","description":"接口版本号","required":true,"schema":{"type":"string"}},{"name":"companyId","in":"header","description":"公司ID","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"phone":{"type":"string","description":"账号：手机号码"},"email":{"type":"string","description":"账号：邮箱"},"phoneArea":{"type":"string","description":"手机区号，区号默认为+86"},"emailArea":{"type":"string","description":"邮箱区号，区号默认为+86"},"pwd":{"type":"string","description":"登录密码，MD5加密、a123456"},"country":{"type":"string","description":"国家:CN=中国"},"registerSource":{"type":"integer","description":"注册来源:1=移动端web：H5，2=pcweb：PC_Web，3=系统&后台平仓：System，4=安卓原生app：Android，5=苹果原生app：iOS，6=鸿蒙OS：HOS，7=pc windows客户端：PC_Win,8=pc mac客户端：PC_Mac，9=不属于以上的：其他"},"customerGroupId":{"type":"number","description":"客户组ID:1=默认客户组; customerFroupId与tradeTypeCurrencyList相互对应"},"remark":{"type":"string","description":"备注"},"registerDevice":{"type":"string","description":"注册的设备型号"},"utmSource":{"type":"string","description":"广告来源(开户链接参数source)"},"utmMedium":{"type":"string","description":"广告媒介(开户链接参数medium)"},"utmCampaign":{"type":"string","description":"广告系列(开户链接参数campaign)"},"utmContent":{"type":"string","description":"广告组(开户链接参数content)"},"utmTerm":{"type":"string","description":"关键词(开户链接参数term)"},"tradeTypeCurrencyList":{"type":"array","items":{"type":"object","properties":{"allCurrency":{"type":"string","description":"资产币种，多个资产以,拼接"},"tradeType":{"type":"string","description":"玩法类型"}},"required":["allCurrency","tradeType"]},"description":"玩法币种集合"}},"required":["phone","country","customerGroupId","registerSource","tradeTypeCurrencyList","pwd"]}}}},"responses":{"200":{"description":"","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","description":"系统通用返回码。0-成功，其他异常"},"msg":{"type":"string","description":"返回信息"},"bizCode":{"type":"string","description":"模块标识码"},"tm":{"description":"处理时长（毫秒）","type":"number"},"trace":{"type":"string","description":"全局链路标志信息"},"msgParams":{"description":"返回描述中占位符参数串，多个参数间以,分割","type":"string","nullable":true},"data":{"type":"string","description":"返回结果,客户编号"}},"required":["code","msg","bizCode","tm","trace","msgParams","data"]}}},"headers":{}}}}}}} ```` ## 客户基础信息 > version=0.0.1\ > bizType=customer.admin.WhiteCustomerAdminApiService.page ```json {"openapi":"3.0.1","info":{"title":"默认模块","version":"1.0.0"},"tags":[{"name":"客户服务相关"}],"servers":[{"url":"https://pre-api-test.cmfbl.com/openapi-b","description":"PRE环境-公司439"}],"security":[],"paths":{"/customer.admin.WhiteCustomerAdminApiService.page":{"post":{"summary":"客户基础信息","deprecated":false,"description":"version=0.0.1\nbizType=customer.admin.WhiteCustomerAdminApiService.page","tags":["客户服务相关"],"parameters":[{"name":"trace","in":"header","description":"全局链路唯一标志","required":true,"schema":{"type":"string"}},{"name":"token","in":"header","description":"鉴权码","required":true,"schema":{"type":"string"}},{"name":"version","in":"header","description":"接口版本号","required":true,"schema":{"type":"string"}},{"name":"companyId","in":"header","description":"公司ID","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"customerNo":{"type":"string","description":"客户编号"},"size":{"type":"number","description":"每页显示多少行，默认20"},"current":{"type":"number","description":"当前页，默认1"}},"required":["customerNo"]}}}},"responses":{"200":{"description":"","content":{"application/json":{"schema":{"type":"object","properties":{"agentCustomerNo":{"type":"string","description":"代理编号","refType":null},"companyId":{"type":"integer","format":"int64","description":"公司","refType":null},"createTime":{"type":"integer","format":"int64","description":"创建时间/申请时间","refType":null},"customerGroupId":{"type":"integer","format":"int64","description":"客户组Id","refType":null},"customerGroupName":{"type":"string","description":"客户组名称","refType":null},"customerNo":{"type":"string","description":"客户账号","refType":null},"customerType":{"type":"integer","format":"int32","description":"客户类型0默认1代理2授信3活动结算","refType":null},"email":{"type":"string","description":"邮箱","refType":null},"firstAccountActivateTime":{"type":"integer","format":"int64","description":"交易账号首次激活时间","refType":null},"firstName":{"type":"string","description":"名","refType":null},"id":{"type":"integer","format":"int64","description":"id","refType":null},"idCard":{"type":"string","description":"证件号码","refType":null},"idCardType":{"type":"string","description":"证件类型","refType":null},"lastName":{"type":"string","description":"姓","refType":null},"loginTime":{"type":"integer","format":"int64","description":"登录时间","refType":null},"name":{"type":"string","description":"姓名","refType":null},"openAccountType":{"type":"integer","format":"int32","description":"开户类型：0.个人 1.企业 ","refType":null},"phone":{"type":"string","description":"手机","refType":null},"phoneArea":{"type":"string","description":"手机区号","refType":null},"registerSource":{"type":"integer","format":"int32","description":"注册来源","refType":null},"remark":{"type":"string","description":"备注","refType":null},"status":{"type":"integer","format":"int32","description":"状态:1正常、2禁用、3删除，4销户，5锁定，6销户中","refType":null},"tgUserId":{"type":"string","description":"tgUserId","refType":null},"tgUserName":{"type":"string","description":"tgUserName","refType":null},"thirdAccountNo":{"type":"string","description":"三方账户","refType":null},"thirdLoginSource":{"type":"string","description":"thirdLoginSource","refType":null},"thirdUserId":{"type":"string","description":"thirdUserId","refType":null},"unitId":{"type":"integer","format":"int64","description":"机构id","refType":null},"unitName":{"type":"string","description":"机构名称","refType":null},"updateTime":{"type":"integer","format":"int64","description":"更新时间","refType":null}},"title":"WhiteCustomerAdminPageVO"}}},"headers":{}}}}}}} ``` ## 客户详情 > version=0.0.1\ > bizType=customer.admin.WhiteCustomerAdminApiService.detail ```json {"openapi":"3.0.1","info":{"title":"默认模块","version":"1.0.0"},"tags":[{"name":"客户服务相关"}],"servers":[{"url":"https://pre-api-test.cmfbl.com/openapi-b","description":"PRE环境-公司439"}],"security":[],"paths":{"/customer.admin.WhiteCustomerAdminApiService.detail":{"post":{"summary":"客户详情","deprecated":false,"description":"version=0.0.1\nbizType=customer.admin.WhiteCustomerAdminApiService.detail","tags":["客户服务相关"],"parameters":[{"name":"trace","in":"header","description":"全局链路唯一标志","required":true,"schema":{"type":"string"}},{"name":"token","in":"header","description":"鉴权码","required":true,"schema":{"type":"string"}},{"name":"version","in":"header","description":"接口版本号","required":true,"schema":{"type":"string"}},{"name":"companyId","in":"header","description":"公司ID","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string","description":"类型信息，baseInfo=基础信息，tradeAccount=交易账户，kyc=kyc信息，allKyc=详情页面kyc信息，bankList=银行卡列表,walletList=钱包地址，otherInfo=其他"},"id":{"type":"string","description":"客户id"},"customerNo":{"type":"string","description":"客户编号"}},"required":["type","id","customerNo"]}}}},"responses":{"200":{"description":"","content":{"application/json":{"schema":{"type":"object","properties":{"accountList":{"type":"object","description":"交易账户列表","refType":null,"properties":{}},"accountRemark":{"type":"string","description":"客户是否有交易账户备注","refType":null},"activateStatus":{"type":"integer","format":"int32","description":"激活状态","refType":null},"activateTime":{"type":"integer","format":"int64","description":"激活时间","refType":null},"address":{"type":"string","description":"通讯地址","refType":null},"apiCheckRule":{"type":"string","description":"API 校验规则。1-邮件；2-短信；3-谷歌NFA；同时启用多个校验，以,分割。","refType":null},"apiCheckSwitch":{"type":"boolean","description":"API 校验开关","refType":null},"assertPassStatus":{"type":"string","description":"设置资金密码提醒标志，1需要设置密码，2不需要","refType":null},"associationCompanyId":{"type":"integer","format":"int64","description":"关联公司Id","refType":null},"companyId":{"type":"integer","format":"int64","description":"公司","refType":null},"companyKycStatus":{"type":"integer","format":"int32","description":"公司KYC开户状态，1开启2未开启","refType":null},"companyType":{"type":"string","description":"公司类型","refType":null},"country":{"type":"string","description":"国家","refType":null},"createTime":{"type":"integer","format":"int64","description":"创建时间","refType":null},"customerAgentMark":{"type":"string","description":"客户代理标示","refType":null},"customerGroupId":{"type":"integer","format":"int64","description":"客户组","refType":null},"customerNo":{"type":"string","description":"客户账号","refType":null},"customerType":{"type":"integer","format":"int32","description":"客户类型0默认1代理2授信3活动结算","refType":null},"deposit":{"type":"integer","format":"int32","description":"可存款,1可存款","refType":null},"earlyWarningLevel":{"type":"object","description":"预警水平","refType":null,"properties":{}},"email":{"type":"string","description":"邮箱","refType":null},"firstName":{"type":"string","description":"名","refType":null},"forceLevel":{"type":"object","description":"强平水平","refType":null,"properties":{}},"googleId":{"type":"integer","format":"int64","description":"是否开启MFA，大于0，开启，其余未开启","refType":null},"id":{"type":"integer","format":"int64","description":"客户id","refType":null},"idCard":{"type":"string","description":"证件号码","refType":null},"idCardType":{"type":"string","description":"证件类型","refType":null},"isFund":{"type":"integer","format":"int32","description":"是否为基金经理，1是，默认0否","refType":null},"kycAuditRemark":{"type":"string","description":"注册KYC审核备注,审核拒绝不为空","refType":null},"kycAuditStatus":{"type":"integer","format":"int32","description":"注册KYC审核状态:0未认证跳转到认证页面,1待审核,2审核通过,3审核不通过","refType":null},"kycRemark":{"type":"string","description":"KYC状态名称","refType":null},"kycStatus":{"type":"integer","format":"int32","description":"KYC状态","refType":null},"lastName":{"type":"string","description":"姓","refType":null},"loginPassStatus":{"type":"string","description":"设置密码提醒标志，1需要设置密码，2不需要","refType":null},"loginTime":{"type":"integer","format":"int64","description":"登陆时间","refType":null},"name":{"type":"string","description":"姓名","refType":null},"openAccountType":{"type":"integer","format":"int32","description":"开户类型：0.个人 1.企业 ","refType":null},"optional":{"type":"integer","format":"int32","description":"自选标志0未添加1已添加","refType":null},"payPassStatus":{"type":"string","description":"支付密码是否存在状态，1不存在，2存在","refType":null},"phone":{"type":"string","description":"手机","refType":null},"phoneArea":{"type":"string","description":"手机区号","refType":null},"postalCode":{"type":"string","description":"邮政编码","refType":null},"registerSource":{"type":"integer","format":"int32","description":"注册来源","refType":null},"registerTime":{"type":"integer","format":"int64","description":"注册时间","refType":null},"relationCustomerId":{"type":"integer","format":"int64","description":"关联账户id","refType":null},"source":{"type":"string","description":"来源","refType":null},"status":{"type":"integer","format":"int32","description":"状态:1正常、2禁用、3删除，4销户，5锁定，6销户中","refType":null},"thirdIntactMsg":{"type":"string","description":"第三方登录完整数据","refType":null},"thirdLoginSource":{"type":"string","description":"第三方登录源 google,facebook,twitter","refType":null},"thirdServerCode":{"type":"string","description":"第三方系统唯一编号","refType":null},"thirdUserId":{"type":"string","description":"第三方userId","refType":null},"type":{"type":"integer","format":"int32","description":"组类型 <0真实，1模拟，2游客>","refType":null},"unitId":{"type":"integer","format":"int64","description":"机构ID","refType":null},"unitName":{"type":"string","description":"机构名称","refType":null},"utmSource":{"type":"string","description":"广告来源","refType":null},"withdraw":{"type":"integer","format":"int32","description":"可取款,1可取款","refType":null},"withdrawLevel":{"type":"object","description":"取款水平","refType":null,"properties":{}}},"title":"CustomerAllInfoVO"}}},"headers":{}}}}}}} ``` ## 查询客户组列表 > version=0.0.1\ > bizType=customer.admin.CustomerGroupAdminApiService.groupList\ > B端鉴权之后可访问 ```json {"openapi":"3.0.1","info":{"title":"默认模块","version":"1.0.0"},"tags":[{"name":"客户服务相关"}],"servers":[{"url":"https://pre-api-test.cmfbl.com/openapi-b","description":"PRE环境-公司439"}],"security":[],"paths":{"/customer.admin.CustomerGroupAdminApiService.groupList":{"post":{"summary":"查询客户组列表","deprecated":false,"description":"version=0.0.1\nbizType=customer.admin.CustomerGroupAdminApiService.groupList\nB端鉴权之后可访问","tags":["客户服务相关"],"parameters":[{"name":"trace","in":"header","description":"全局链路唯一标志","required":true,"schema":{"type":"string"}},{"name":"companyId","in":"header","description":"公司ID","required":true,"schema":{"type":"string"}},{"name":"token","in":"header","description":"B端鉴权后token","required":true,"schema":{"type":"string"}},{"name":"version","in":"header","description":"接口版本号","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{}}}}},"responses":{"200":{"description":"","content":{"application/json":{"schema":{"type":"object","properties":{"bizCode":{"type":"string","description":"模块标识码"},"code":{"type":"string","description":"状态返回码"},"msg":{"type":"string","description":"状态描述"},"tm":{"type":"integer","format":"int64","description":"处理时长（毫秒）"},"trace":{"type":"string","description":"跟踪码"},"msgParams":{"type":"string","description":"返回描述中占位符参数串，多个参数间以,分割"},"data":{"type":"array","items":{"$ref":"#/components/schemas/CustomerGroupBizVO"},"description":"数据体"},"ok":{"type":"boolean"},"fail":{"type":"boolean"}}}}},"headers":{}}}}}},"components":{"schemas":{"CustomerGroupBizVO":{"type":"object","properties":{"name":{"type":"string","description":"组名称"},"id":{"type":"integer","format":"int64","description":"id"},"type":{"type":"integer","format":"int32","description":"组类型"},"openAccountType":{"type":"integer","format":"int32","description":"开户组类型,1是2否"},"tradeType":{"type":"integer","format":"int64","description":"玩法Id"},"assets":{"type":"string","description":"资产信息"}}}}}} ```