> For the complete documentation index, see [llms.txt](https://docs.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.multimarkets.org/client-api/more.../customer-social.md). # Customer/Social ## Get Third-Party Login Configuration Information > version=0.0.1 bizType=customer.app.CustomerThirdLoginService.config Guest Accessible ```json {"openapi":"3.0.1","info":{"title":"Default module","version":"1.0.0"},"tags":[{"name":"Customer/Social"}],"servers":[{"url":"https://prewppc-3.cmfbl.com/api","description":"PRE测试公司439"}],"security":[],"paths":{"/global/customer.app.CustomerThirdLoginService.config":{"post":{"summary":"Get Third-Party Login Configuration Information","deprecated":false,"description":"version=0.0.1 bizType=customer.app.CustomerThirdLoginService.config Guest Accessible","operationId":"config","tags":["Customer/Social"],"parameters":[{"name":"version","in":"header","description":"","required":true,"schema":{"type":"string"}},{"name":"companyId","in":"header","description":"","required":true,"schema":{"type":"string"}},{"name":"trace","in":"header","description":"","required":true,"schema":{"type":"string"}},{"name":"lang","in":"header","description":"","required":true,"schema":{"type":"string"}},{"name":"token","in":"header","description":"","required":false,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"thirdSource":{"type":"string","description":"Third-Party Sources: google, facebook, twitter, telegram, apple, metamask"}}}}}},"responses":{"200":{"description":"","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","description":"Status Return Code, code=0 indicates current request operation success, other codes handle exceptions"},"msg":{"type":"string","description":"Status description"},"bizCode":{"type":"string","description":"Module identifier code"},"tm":{"type":"integer","format":"int64","description":"Processing time (milliseconds)"},"trace":{"type":"string","description":"Tracking code"},"msgParams":{"type":"string","description":"Placeholder parameter string in return description, multiple parameters separated by commas"},"data":{"type":"object","properties":{"thirdSource":{"type":"string","title":"","description":"Third-Party Sources: google, facebook, twitter…"},"clientId":{"type":"string","title":"","description":"Client ID"},"developerAccount":{"type":"string","description":"Third-Party Development Account"}},"required":["thirdSource","clientId","developerAccount"],"description":"Data Body"}},"required":["code","data","msgParams","trace","tm","bizCode","msg"]}}},"headers":{}}}}}}} ``` ## Apple Third-party Login Verification > version=0.0.1\ > bizType=customer.app.CustomerThirdLoginService.appleVerify\ > Accessible after login ```json {"openapi":"3.0.1","info":{"title":"Default module","version":"1.0.0"},"tags":[{"name":"Customer/Social"}],"servers":[{"url":"https://prewppc-3.cmfbl.com/api","description":"PRE测试公司439"}],"security":[],"paths":{"/h/com.cats.customer.api.app.CustomerThirdLoginService/appleVerify":{"post":{"summary":"Apple Third-party Login Verification","deprecated":false,"description":"version=0.0.1\nbizType=customer.app.CustomerThirdLoginService.appleVerify\nAccessible after login","operationId":"appleVerify","tags":["Customer/Social"],"parameters":[],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"companyId":{"type":"integer","title":"Company ID"},"openId":{"type":"string","title":"Third-party Open ID","description":"Required on app end"},"identityToken":{"type":"string","title":"Identity Token","description":"Required on app end"},"email":{"type":"integer","title":"Optional on app end"},"code":{"type":"string","title":"Authorization Code","description":"Required on web end"},"idToken":{"type":"string","title":"token","description":"Required on web end"}},"required":["companyId"]}}}},"responses":{"200":{"description":"","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","title":"System General Return Code","description":"0-Success, other exceptions"},"msg":{"type":"string","title":"Return information"},"bizCode":{"type":"string","title":"Module identifier code"},"tm":{"title":"Processing time (milliseconds)","type":"integer"},"trace":{"type":"string","title":"Global link flag information"},"msgParams":{"type":"string","title":"Placeholder parameter string in return description, multiple parameters separated by commas"},"data":{"type":"object","properties":{"userId":{"type":"string","title":"Third-party userId"},"action":{"type":"string","title":"Next Operation Behavior","description":"login, bind, register"},"result":{"title":"Validation Result","type":"boolean"},"failReason":{"type":"string","title":"Validation Failure Reason"},"thirdSource":{"type":"string","title":"Third-party Login Source","description":"google,facebook,twitter…"},"email":{"type":"string","title":"Email"},"phone":{"type":"string","title":"Phone Number"}},"required":["userId","phone","email","thirdSource","failReason","result","action"]}},"required":["code","data","msgParams","trace","tm","bizCode","msg"]}}},"headers":{}}}}}}} ``` ## Facebook Third-party Login Verification > version=0.0.1\ > bizType=customer.app.CustomerThirdLoginService.facebookVerify\ > Access after login ```json {"openapi":"3.0.1","info":{"title":"Default module","version":"1.0.0"},"tags":[{"name":"Customer/Social"}],"servers":[{"url":"https://prewppc-3.cmfbl.com/api","description":"PRE测试公司439"}],"security":[],"paths":{"/third/login/customer.app.CustomerThirdLoginService.facebookVerify":{"post":{"summary":"Facebook Third-party Login Verification","deprecated":false,"description":"version=0.0.1\nbizType=customer.app.CustomerThirdLoginService.facebookVerify\nAccess after login","operationId":"facebookVerify","tags":["Customer/Social"],"parameters":[],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"accessToken":{"type":"string","description":"Verify accessToken"}}}}}},"responses":{"200":{"description":"","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","title":"System General Return Code","description":"0-Success, other exceptions"},"msg":{"type":"string","title":"Return information"},"bizCode":{"type":"string","title":"Module identifier code"},"tm":{"title":"Processing time (milliseconds)","type":"integer"},"trace":{"type":"string","title":"Global link flag information"},"msgParams":{"type":"string","title":"Placeholder parameter string in return description, multiple parameters separated by commas"},"data":{"type":"object","properties":{"userId":{"type":"string","title":"Third-party userId"},"action":{"type":"string","title":"Next Operation Behavior","description":"login, bind, register"},"result":{"title":"Validation Result","type":"boolean"},"failReason":{"type":"string","title":"Validation Failure Reason"},"thirdSource":{"type":"string","title":"Third-party Login Source","description":"google,facebook,twitter…"},"email":{"type":"string","title":"Email"},"phone":{"type":"string","title":"Phone Number"}},"required":["userId","phone","email","thirdSource","failReason","result","action"]}},"required":["code","data","msgParams","trace","tm","bizCode","msg"]}}},"headers":{}}}}}}} ``` ## Google Third-party Login Verification > version=0.0.1\ > bizType=customer.app.CustomerThirdLoginService.googleVerify\ > Accessible after login ```json {"openapi":"3.0.1","info":{"title":"Default module","version":"1.0.0"},"tags":[{"name":"Customer/Social"}],"servers":[{"url":"https://prewppc-3.cmfbl.com/api","description":"PRE测试公司439"}],"security":[],"paths":{"/h/com.cats.customer.api.app.CustomerThirdLoginService/googleVerify":{"post":{"summary":"Google Third-party Login Verification","deprecated":false,"description":"version=0.0.1\nbizType=customer.app.CustomerThirdLoginService.googleVerify\nAccessible after login","operationId":"googleVerify","tags":["Customer/Social"],"parameters":[],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"idToken":{"type":"string","title":"Token verification required for web"},"accessToken":{"type":"string","title":"Token verification required for app"}}}}}},"responses":{"200":{"description":"","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","title":"System General Return Code","description":"0-Success, other exceptions"},"msg":{"type":"string","title":"Return information"},"bizCode":{"type":"string","title":"Module identifier code"},"tm":{"type":"integer","title":"Processing time (milliseconds)"},"trace":{"type":"string","title":"Global link flag information"},"data":{"type":"object","properties":{"thirdSource":{"type":"string","title":"Third-party Login Source","description":"google,facebook,twitter…"},"result":{"type":"boolean","title":"Validation Result"},"phone":{"title":"Phone Number","type":"string"},"action":{"type":"string","title":"Next Operation Behavior","description":"login, bind, register"},"failReason":{"title":"Validation Failure Reason","type":"string"},"userId":{"type":"string","title":"Third-party userId"},"email":{"type":"string","title":"Email"},"token":{"type":"string","title":"Token verification"}},"required":["thirdSource","result","phone","action","failReason","userId","email","token"],"title":""},"msgParams":{"title":"Placeholder parameter string in return description, multiple parameters separated by commas","type":"string"}},"required":["code","msg","bizCode","tm","trace","data","msgParams"]}}},"headers":{}}}}}}} ``` ## Telegram third-party login verification > version=0.0.1\ > bizType=customer.app.CustomerThirdLoginService.telegramVerify\ > \###Version 0.0.2, used for third-party registration and login (no need for phone or email)\ > version=0.0.2\ > bizType=customer.app.CustomerThirdLoginService.telegramVerify\ > Access after login ```json {"openapi":"3.0.1","info":{"title":"Default module","version":"1.0.0"},"tags":[{"name":"Customer/Social"}],"servers":[{"url":"https://prewppc-3.cmfbl.com/api","description":"PRE测试公司439"}],"security":[],"paths":{"/third/login/customer.app.CustomerThirdLoginService.telegramVerify":{"post":{"summary":"Telegram third-party login verification","deprecated":false,"description":"version=0.0.1\nbizType=customer.app.CustomerThirdLoginService.telegramVerify\n###Version 0.0.2, used for third-party registration and login (no need for phone or email)\nversion=0.0.2\nbizType=customer.app.CustomerThirdLoginService.telegramVerify\nAccess after login","operationId":"metaMaskVerify","tags":["Customer/Social"],"parameters":[{"name":"companyId","in":"header","description":"","required":true,"schema":{"type":"string"}},{"name":"lang","in":"header","description":"","required":true,"schema":{"type":"string"}},{"name":"trace","in":"header","description":"","required":true,"schema":{"type":"string"}},{"name":"version","in":"header","description":"","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"userJsonStr":{"type":"string","title":"User authorization information provided as a JSON string"},"channelSource":{"type":"string","title":"Channel Source h5, pc"}},"required":["userJsonStr","channelSource"]}}}},"responses":{"200":{"description":"","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","title":"System General Return Code","description":"0-Success, other exceptions"},"msg":{"type":"string","title":"Return information","description":"Return information"},"bizCode":{"type":"string","title":"Module identifier code","description":"Module identifier code"},"tm":{"title":"Processing time (milliseconds)","type":"integer","description":"Processing time (milliseconds)"},"trace":{"type":"string","title":"Global link flag information","description":"Global link flag information"},"msgParams":{"type":"string","title":"Placeholder parameter string in return description, multiple parameters separated by commas","description":"Placeholder parameter string in return description, multiple parameters separated by commas"},"data":{"type":"object","properties":{"userId":{"type":"string","title":"Third-party userId","description":"Third-party userId"},"action":{"type":"string","title":"Next Operation Behavior","description":"login, bind, register"},"result":{"title":"Validation Result","type":"boolean","description":"Validation Result"},"failReason":{"type":"string","title":"Validation Failure Reason","description":"Validation Failure Reason"},"thirdSource":{"type":"string","title":"Third-party Login Source","description":"Third-party login sources, google, facebook, twitter…"},"email":{"type":"string","title":"Email","description":"Email"},"phone":{"type":"string","title":"Phone Number","description":"Phone Number"},"authToken":{"type":"string","description":"Third-party authorization credentials (returned version=0.0.2)"}},"required":["userId","phone","email","thirdSource","failReason","result","action","authToken"]}},"required":["code","data","msgParams","trace","tm","bizCode","msg"]}}},"headers":{}}}}}}} ``` ## Metamask third-party login verification > version=0.0.1\ > bizType=customer.app.CustomerThirdLoginService.metaMaskVerify\ > Access after login ```json {"openapi":"3.0.1","info":{"title":"Default module","version":"1.0.0"},"tags":[{"name":"Customer/Social"}],"servers":[{"url":"https://prewppc-3.cmfbl.com/api","description":"PRE测试公司439"}],"security":[],"paths":{"/third/login/customer.app.CustomerThirdLoginService.metaMaskVerify":{"post":{"summary":"Metamask third-party login verification","deprecated":false,"description":"version=0.0.1\nbizType=customer.app.CustomerThirdLoginService.metaMaskVerify\nAccess after login","operationId":"telegramVerify","tags":["Customer/Social"],"parameters":[],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"web3Signature":{"type":"string","title":"Signature verification"},"address":{"type":"string","title":"Wallet account address"},"timestamp":{"type":"integer","title":"Timestamp"}},"required":["web3Signature","address","timestamp"]}}}},"responses":{"200":{"description":"","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","title":"System General Return Code","description":"0-Success, other exceptions"},"msg":{"type":"string","title":"Return information"},"bizCode":{"type":"string","title":"Module identifier code"},"tm":{"title":"Processing time (milliseconds)","type":"integer"},"trace":{"type":"string","title":"Global link flag information"},"msgParams":{"type":"string","title":"Placeholder parameter string in return description, multiple parameters separated by commas"},"data":{"type":"object","properties":{"userId":{"type":"string","title":"Third-party userId"},"action":{"type":"string","title":"Next Operation Behavior","description":"login, bind, register"},"result":{"title":"Validation Result","type":"boolean"},"failReason":{"type":"string","title":"Validation Failure Reason"},"thirdSource":{"type":"string","title":"Third-party Login Source","description":"google,facebook,twitter…"},"email":{"type":"string","title":"Email"},"phone":{"type":"string","title":"Phone Number"}},"required":["userId","phone","email","thirdSource","failReason","result","action"]}},"required":["code","data","msgParams","trace","tm","bizCode","msg"]}}},"headers":{}}}}}}} ``` ## Twitter third-party login verification > version=0.0.1\ > bizType=customer.app.CustomerThirdLoginService.twitterVerify\ > Accessible after login ```json {"openapi":"3.0.1","info":{"title":"Default module","version":"1.0.0"},"tags":[{"name":"Customer/Social"}],"servers":[{"url":"https://prewppc-3.cmfbl.com/api","description":"PRE测试公司439"}],"security":[],"paths":{"/third/login/customer.app.CustomerThirdLoginService.twitterVerify":{"post":{"summary":"Twitter third-party login verification","deprecated":false,"description":"version=0.0.1\nbizType=customer.app.CustomerThirdLoginService.twitterVerify\nAccessible after login","operationId":"twitterVerify","tags":["Customer/Social"],"parameters":[],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"oauth_token":{"type":"string","title":"","description":"oauth_token"},"oauth_token_secret":{"type":"string","title":"","description":"oauth_token_secret"},"user_id":{"type":"string","title":"","description":"user_id"},"screen_name":{"type":"string","description":"screen_name"},"access_token":{"type":"string","description":"access_token"},"state":{"type":"string","description":"state"},"client_id":{"type":"string","description":"client_id"},"network":{"type":"string","description":"network"},"display":{"type":"string","description":"display"},"redirect_uri":{"type":"string","description":"redirect_uri"},"scope":{"type":"string","description":"scope"},"oauth_proxy":{"type":"string","description":"oauth_proxy"}},"required":["oauth_token","oauth_token_secret","scope","redirect_uri","display","network","client_id","state","access_token","screen_name","user_id","oauth_proxy"]}}}},"responses":{"200":{"description":"","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","title":"System General Return Code","description":"0-Success, other exceptions"},"msg":{"type":"string","title":"Return information"},"bizCode":{"type":"string","title":"Module identifier code"},"tm":{"title":"Processing time (milliseconds)","type":"integer"},"trace":{"type":"string","title":"Global link flag information"},"msgParams":{"type":"string","title":"Placeholder parameter string in return description, multiple parameters separated by commas"},"data":{"type":"object","properties":{"userId":{"type":"string","title":"Third-party userId"},"action":{"type":"string","title":"Next Operation Behavior","description":"login, bind, register"},"result":{"title":"Validation Result","type":"boolean"},"failReason":{"type":"string","title":"Validation Failure Reason"},"thirdSource":{"type":"string","title":"Third-party Login Source","description":"google,facebook,twitter…"},"email":{"type":"string","title":"Email"},"phone":{"type":"string","title":"Phone Number"}},"required":["userId","phone","email","thirdSource","failReason","result","action"]}},"required":["code","data","msgParams","trace","tm","bizCode","msg"]}}},"headers":{}}}}}}} ``` ## Third-party login > version=0.0.1\ > bizType=customer.app.CustomerThirdLoginService.login\ > Accessible to guests ```json {"openapi":"3.0.1","info":{"title":"Default module","version":"1.0.0"},"tags":[{"name":"Customer/Social"}],"servers":[{"url":"https://prewppc-3.cmfbl.com/api","description":"PRE测试公司439"}],"security":[],"paths":{"/third/login/customer.app.CustomerThirdLoginService.login":{"post":{"summary":"Third-party login","deprecated":false,"description":"version=0.0.1\nbizType=customer.app.CustomerThirdLoginService.login\nAccessible to guests","operationId":"login","tags":["Customer/Social"],"parameters":[{"name":"companyId","in":"header","description":"","required":true,"schema":{"type":"string"}},{"name":"lang","in":"header","description":"","required":true,"schema":{"type":"string"}},{"name":"trace","in":"header","description":"","required":true,"schema":{"type":"string"}},{"name":"version","in":"header","description":"","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"thirdSource":{"type":"string","description":"Third-Party Sources: google, facebook, twitter, telegram, apple, metamask"},"userId":{"type":"string","description":"Third-party userId"},"email":{"type":"string","description":"Email"},"phone":{"type":"string","description":"Phone Number"}},"required":["thirdSource","userId","email","phone"]}}}},"responses":{"200":{"description":"","content":{"application/json":{"schema":{"type":"object","properties":{"bizCode":{"type":"string","description":"Module identifier code"},"code":{"type":"string","description":"Status return code"},"msg":{"type":"string","description":"Status description"},"tm":{"type":"integer","format":"int64","description":"Processing time (milliseconds)"},"trace":{"type":"string","description":"Tracking code"},"msgParams":{"type":"string","description":"Placeholder parameter string in return description, multiple parameters separated by commas"},"data":{"type":"object","properties":{"id":{"type":"integer","format":"int64","description":"Customer ID"},"companyId":{"type":"integer","format":"int64","description":"Company"},"customerGroupId":{"type":"integer","format":"int64","description":"Customer group"},"customerNo":{"type":"string","description":"Customer account"},"kycAuditStatus":{"type":"integer","format":"int32","description":"Registration KYC audit status: 0 uncertified, jump to certification page, 1 pending review, 2 review passed, 3 review failed"},"kycAuditRemark":{"type":"string","description":"Registration KYC audit remarks, not empty if rejected"},"kycStatus":{"type":"integer","format":"int32","description":"KYC status"},"kycRemark":{"type":"string","description":"KYC status name"},"accountList":{"type":"object","description":"Trading Account List","properties":{}},"accountRemark":{"type":"string","description":"Whether the customer has a trading account note"},"loginPassStatus":{"type":"string","description":"Set password reminder flag, 1 for password required, 2 for not required"},"payPassStatus":{"type":"string","description":"Payment password existence status, 1 for non-existent, 2 for existent"},"email":{"type":"string","description":"Email"},"phone":{"type":"string","description":"Phone"},"phoneArea":{"type":"string","description":"Phone area code"},"name":{"type":"string","description":"Name"},"country":{"type":"string","description":"Country"},"type":{"type":"integer","format":"int32","description":"Group type <0 real, 1 demo, 2 guest>"},"deposit":{"type":"integer","format":"int32","description":"Depositable, 1 for depositable"},"withdraw":{"type":"integer","format":"int32","description":"Withdrawable, 1 for withdrawable"},"optional":{"type":"integer","format":"int32","description":"Customized flag 0 not added 1 added"},"activateStatus":{"type":"integer","format":"int32","description":"Activation status, 0 not activated, 1 activated"},"activateTime":{"type":"integer","format":"int64","description":"Activation time"},"companyKycStatus":{"type":"integer","format":"int32","description":"Company KYC account opening status, 1 for opened, 2 for not opened"},"status":{"type":"integer","format":"int32","description":"Status: 1 normal, 2 disabled, 3 deleted, 4 closed, 5 locked, 6 closing"},"thirdServerCode":{"type":"string","description":"Unique identifier from third-party system"},"source":{"type":"string","description":"Source"},"thirdLoginSource":{"type":"string","description":"Third-party login sources google, facebook, twitter"},"thirdUserId":{"type":"string","description":"Third-party userId"},"idCard":{"type":"string","description":"ID number"},"idCardType":{"type":"string","description":"ID type"},"thirdIntactMsg":{"type":"string","description":"Third-party login complete data"},"firstName":{"type":"string","description":"First name"},"lastName":{"type":"string","description":"Last name"},"isFund":{"type":"integer","format":"int32","description":"Whether a fund manager, 1 is yes, default 0 is no"},"assertPassStatus":{"type":"string","description":"Set fund password reminder flag, 1 requires setting password, 2 does not require"},"googleId":{"type":"integer","format":"int64","description":"Whether to enable MFA, greater than 0, enabled, otherwise not enabled"},"openAccountType":{"type":"integer","format":"int32","description":"Account type: 0. Individual 1. Enterprise "},"loginTime":{"type":"integer","format":"int64","description":"Login time"},"createTime":{"type":"integer","format":"int64","description":"Creation time"},"relationCustomerId":{"type":"integer","format":"int64","description":"Associated account id"},"companyType":{"type":"string","description":"Company type"},"registerSource":{"type":"integer","format":"int32","description":"Registration source"},"associationCompanyId":{"type":"integer","format":"int64","description":"Associated company Id"},"registerTime":{"type":"integer","format":"int64","description":"Registration Time"}}},"ok":{"type":"boolean"},"fail":{"type":"boolean"}}}}},"headers":{}}}}}}} ``` ## Third-party login (no need for phone, email) > version=0.0.1\ > bizType=customer.app.CustomerThirdLoginService.socialLogin\ > Guest access ```json {"openapi":"3.0.1","info":{"title":"Default module","version":"1.0.0"},"tags":[{"name":"Customer/Social"}],"servers":[{"url":"https://prewppc-3.cmfbl.com/api","description":"PRE测试公司439"}],"security":[],"paths":{"/third/login/customer.app.CustomerThirdLoginService.socialLogin":{"post":{"summary":"Third-party login (no need for phone, email)","deprecated":false,"description":"version=0.0.1\nbizType=customer.app.CustomerThirdLoginService.socialLogin\nGuest access","operationId":"login","tags":["Customer/Social"],"parameters":[{"name":"companyId","in":"header","description":"","required":true,"schema":{"type":"string"}},{"name":"lang","in":"header","description":"","required":true,"schema":{"type":"string"}},{"name":"trace","in":"header","description":"","required":true,"schema":{"type":"string"}},{"name":"version","in":"header","description":"","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"thirdSource":{"type":"string","description":"Third-party source telegram"},"userId":{"type":"string","description":"Third-party userId"},"authToken":{"type":"string","description":"Third-party authorization certificate","minLength":64,"maxLength":64}},"required":["thirdSource","userId","authToken"]}}}},"responses":{"200":{"description":"","content":{"application/json":{"schema":{"type":"object","properties":{"bizCode":{"type":"string","description":"Module identifier code"},"code":{"type":"string","description":"Status return code"},"msg":{"type":"string","description":"Status description"},"tm":{"type":"integer","format":"int64","description":"Processing time (milliseconds)"},"trace":{"type":"string","description":"Tracking code"},"msgParams":{"type":"string","description":"Placeholder parameter string in return description, multiple parameters separated by commas"},"data":{"type":"object","properties":{"id":{"type":"integer","format":"int64","description":"Customer ID"},"companyId":{"type":"integer","format":"int64","description":"Company"},"customerGroupId":{"type":"integer","format":"int64","description":"Customer group"},"customerNo":{"type":"string","description":"Customer account"},"kycAuditStatus":{"type":"integer","format":"int32","description":"Registration KYC audit status: 0 uncertified, jump to certification page, 1 pending review, 2 review passed, 3 review failed"},"kycAuditRemark":{"type":"string","description":"Registration KYC audit remarks, not empty if rejected"},"kycStatus":{"type":"integer","format":"int32","description":"KYC status"},"kycRemark":{"type":"string","description":"KYC status name"},"accountList":{"type":"object","description":"Trading Account List","properties":{}},"accountRemark":{"type":"string","description":"Whether the customer has a trading account note"},"loginPassStatus":{"type":"string","description":"Set password reminder flag, 1 for password required, 2 for not required"},"payPassStatus":{"type":"string","description":"Payment password existence status, 1 for non-existent, 2 for existent"},"email":{"type":"string","description":"Email"},"phone":{"type":"string","description":"Phone"},"phoneArea":{"type":"string","description":"Phone area code"},"name":{"type":"string","description":"Name"},"country":{"type":"string","description":"Country"},"type":{"type":"integer","format":"int32","description":"Group type <0 real, 1 demo, 2 guest>"},"deposit":{"type":"integer","format":"int32","description":"Depositable, 1 for depositable"},"withdraw":{"type":"integer","format":"int32","description":"Withdrawable, 1 for withdrawable"},"optional":{"type":"integer","format":"int32","description":"Customized flag 0 not added 1 added"},"activateStatus":{"type":"integer","format":"int32","description":"Activation status, 0 not activated, 1 activated"},"activateTime":{"type":"integer","format":"int64","description":"Activation time"},"companyKycStatus":{"type":"integer","format":"int32","description":"Company KYC account opening status, 1 for opened, 2 for not opened"},"status":{"type":"integer","format":"int32","description":"Status: 1 normal, 2 disabled, 3 deleted, 4 closed, 5 locked, 6 closing"},"thirdServerCode":{"type":"string","description":"Unique identifier from third-party system"},"source":{"type":"string","description":"Source"},"thirdLoginSource":{"type":"string","description":"Third-party login source telegram"},"thirdUserId":{"type":"string","description":"Third-party userId"},"idCard":{"type":"string","description":"ID number"},"idCardType":{"type":"string","description":"ID type"},"thirdIntactMsg":{"type":"string","description":"Third-party login complete data"},"firstName":{"type":"string","description":"First name"},"lastName":{"type":"string","description":"Last name"},"isFund":{"type":"integer","format":"int32","description":"Whether a fund manager, 1 is yes, default 0 is no"},"assertPassStatus":{"type":"string","description":"Set fund password reminder flag, 1 requires setting password, 2 does not require"},"googleId":{"type":"integer","format":"int64","description":"Whether to enable MFA, greater than 0, enabled, otherwise not enabled"},"openAccountType":{"type":"integer","format":"int32","description":"Account type: 0. Individual 1. Enterprise "},"loginTime":{"type":"integer","format":"int64","description":"Login time"},"createTime":{"type":"integer","format":"int64","description":"Creation time"},"relationCustomerId":{"type":"integer","format":"int64","description":"Associated account id"},"companyType":{"type":"string","description":"Company type"},"registerSource":{"type":"integer","format":"int32","description":"Registration source"},"associationCompanyId":{"type":"integer","format":"int64","description":"Associated company Id"},"registerTime":{"type":"integer","format":"int64","description":"Registration Time"}}},"ok":{"type":"boolean"},"fail":{"type":"boolean"}}}}},"headers":{}}}}}}} ``` ## Third-party registration > version=0.0.1\ > bizType=customer.app.CustomerThirdLoginService.register\ > Guest access ```json {"openapi":"3.0.1","info":{"title":"Default module","version":"1.0.0"},"tags":[{"name":"Customer/Social"}],"servers":[{"url":"https://prewppc-3.cmfbl.com/api","description":"PRE测试公司439"}],"security":[],"paths":{"/third/login/customer.app.CustomerThirdLoginService.register":{"post":{"summary":"Third-party registration","deprecated":false,"description":"version=0.0.1\nbizType=customer.app.CustomerThirdLoginService.register\nGuest access","operationId":"register","tags":["Customer/Social"],"parameters":[{"name":"companyId","in":"header","description":"","required":false,"schema":{"type":"string"}},{"name":"lang","in":"header","description":"","required":false,"schema":{"type":"string"}},{"name":"trace","in":"header","description":"","required":false,"schema":{"type":"string"}},{"name":"version","in":"header","description":"","required":false,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"country":{"type":"string","description":"Country"},"thirdSource":{"type":"string","description":"Third-Party Sources: google, facebook, twitter, telegram, apple, metamask"},"userId":{"type":"string","description":"Third-party userId"},"customerGroupId":{"type":"integer","format":"int64","description":"Client group ID"},"email":{"type":"string","description":"Email and phone number must exist one"},"phone":{"type":"string","description":"Phone Number"},"phoneArea":{"type":"string","description":"New phone area code"},"verifyCode":{"type":"string","description":"Verification code"},"sendToken":{"type":"string","description":"Verification code sending ticket"},"registerSource":{"type":"integer","format":"int32","minimum":1,"description":"Registration source: 1=mobile web: H5, 2=pc web: PC_Web, 3=system & backend registration: System, 4=Android native app: Android, 5=iOS native app: iOS, 6=HarmonyOS: HOS, 7=pc windows client: PC_Win, 8=pc mac client: PC_Mac, 9=other"},"utmSource":{"type":"string","description":"Advertising source (account opening link parameter source)"},"utmMedium":{"type":"string","description":"Advertising medium (account opening link parameter medium)"},"utmCampaign":{"type":"string","description":"Advertising campaign (account opening link parameter campaign)"},"utmContent":{"type":"string","description":"Advertising group (account opening link parameter content)"},"utmTerm":{"type":"string","description":"Keyword (account opening link parameter term)"},"lang":{"type":"string","description":"Language Information"},"thirdServerCode":{"type":"string","description":"Unique identifier from third-party system","maxLength":45},"thirdServerSource":{"type":"string","description":"Third-party system source, such as: agent=agent","maxLength":10},"registerDevice":{"type":"string","description":"Registered device model"}},"required":["country"]}}}},"responses":{"200":{"description":"","content":{"application/json":{"schema":{"type":"object","properties":{"bizCode":{"type":"string","description":"Module identifier code"},"code":{"type":"string","description":"Status return code"},"msg":{"type":"string","description":"Status description"},"tm":{"type":"integer","format":"int64","description":"Processing time (milliseconds)"},"trace":{"type":"string","description":"Tracking code"},"msgParams":{"type":"string","description":"Placeholder parameter string in return description, multiple parameters separated by commas"},"data":{"type":"object","properties":{"customerNo":{"type":"string","description":"Customer account"},"list":{"type":"array","description":"KYC authentication list information","items":{"$ref":"#/components/schemas/KycAuthVO"}},"companyId":{"type":"integer","format":"int64","description":"Company ID"},"ext1":{"type":"string","description":"Extension Field (Unused)"},"ext2":{"type":"string","description":"Extension Field (Unused)"},"email":{"type":"string","description":"Email"},"phone":{"type":"string","description":"Phone"},"phoneArea":{"type":"string","description":"Phone area code"},"name":{"type":"string","description":"Name"},"loginPassStatus":{"type":"string","description":"Set password reminder flag, 1 for password required, 2 for not required"},"payPassStatus":{"type":"string","description":"Payment password existence status, 1 for non-existent, 2 for existent"},"customerGroupId":{"type":"integer","format":"int64","description":"Customer group"},"country":{"type":"string","description":"Country"},"id":{"type":"integer","format":"int64","description":"Customer ID"},"optional":{"type":"integer","format":"int32","description":"Customized flag 0 not added 1 added"},"companyKycStatus":{"type":"integer","format":"int32","description":"Company KYC account opening status, 1 for opened, 2 for not opened"},"thirdServerCode":{"type":"string","description":"Unique identifier from third-party system"},"source":{"type":"string","description":"Source"},"capitalInStatus":{"type":"integer","format":"int32","description":"Deposit status: 1. Deposited, 2. Not deposited"},"openAccountType":{"type":"integer","format":"int32","description":"Account type: 0. Individual 1. Enterprise "},"companyType":{"type":"string","description":"Company type"},"associationCompanyId":{"type":"integer","format":"int64","description":"Associated company Id"},"registerTime":{"type":"integer","format":"int64","description":"Registration Time"},"apiCheckSwitch":{"type":"boolean","description":"API verification switch. true-verification is enabled"},"apiCheckRule":{"type":"string","description":"API Verification Rules. 1-Email; 2-SMS; 3-Google NFA; Enable multiple verifications at the same time, separated by commas."},"token":{"type":"string","description":"Login Token"}}},"ok":{"type":"boolean"},"fail":{"type":"boolean"}}}}},"headers":{}}}}}},"components":{"schemas":{"KycAuthVO":{"type":"object","properties":{"levelCode":{"type":"string","description":"Level Code"},"openAccountType":{"type":"integer","format":"int32","description":"Account type: 0. Individual 1. Enterprise "},"levelName":{"type":"string","description":"Level Name"},"pathName":{"type":"string","description":"KYC Path Name"},"pathCode":{"type":"string","description":"KYC Path Code"},"elementList":{"type":"array","description":"KYC Information List","items":{"$ref":"#/components/schemas/KycAuthElementVO"}}}},"KycAuthElementVO":{"type":"object","properties":{"elementCode":{"type":"string","description":"KYC element code"},"elementName":{"type":"string","description":"KYC element name"},"showType":{"type":"string","description":"KYC element display type"},"extend":{"type":"string","description":"KYC element extended attribute"},"elementValue":{"type":"string","description":"KYC element value"},"elementValueInputGroup":{"type":"string","description":"KYC element value, combination"},"elementCodeInputGroup":{"type":"string","description":"KYC element code, combination"}}}}}} ``` ## Third-party registration (no need for phone, email) > version=0.0.1\ > bizType=customer.app.CustomerThirdLoginService.socialRegister\ > Accessible for guests ```json {"openapi":"3.0.1","info":{"title":"Default module","version":"1.0.0"},"tags":[{"name":"Customer/Social"}],"servers":[{"url":"https://prewppc-3.cmfbl.com/api","description":"PRE测试公司439"}],"security":[],"paths":{"/third/login/customer.app.CustomerThirdLoginService.socialRegister":{"post":{"summary":"Third-party registration (no need for phone, email)","deprecated":false,"description":"version=0.0.1\nbizType=customer.app.CustomerThirdLoginService.socialRegister\nAccessible for guests","operationId":"register","tags":["Customer/Social"],"parameters":[{"name":"companyId","in":"header","description":"","required":false,"schema":{"type":"string"}},{"name":"lang","in":"header","description":"","required":false,"schema":{"type":"string"}},{"name":"trace","in":"header","description":"","required":false,"schema":{"type":"string"}},{"name":"version","in":"header","description":"","required":false,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"country":{"type":"string","description":"Country code"},"thirdSource":{"type":"string","description":"Third-party source telegram"},"userId":{"type":"string","description":"Third-party userId"},"authToken":{"type":"string","description":"Third-party authorization certificate","minLength":64,"maxLength":64},"registerSource":{"type":"integer","format":"int32","minimum":1,"description":"Registration source: 1=mobile web: H5, 2=pc web: PC_Web, 3=system & backend registration: System, 4=Android native app: Android, 5=iOS native app: iOS, 6=HarmonyOS: HOS, 7=pc windows client: PC_Win, 8=pc mac client: PC_Mac, 9=other"},"customerGroupId":{"type":"integer","format":"int64","description":"Client group ID"},"utmSource":{"type":"string","description":"Advertising source (account opening link parameter source)"},"utmMedium":{"type":"string","description":"Advertising medium (account opening link parameter medium)"},"utmCampaign":{"type":"string","description":"Advertising campaign (account opening link parameter campaign)"},"utmContent":{"type":"string","description":"Advertising group (account opening link parameter content)"},"utmTerm":{"type":"string","description":"Keyword (account opening link parameter term)"},"lang":{"type":"string","description":"Language Information"},"thirdServerCode":{"type":"string","description":"Unique identifier from third-party system","maxLength":45},"thirdServerSource":{"type":"string","description":"Third-party system source, such as: agent=agent","maxLength":10},"registerDevice":{"type":"string","description":"Registered device model"},"token":{"type":"string","description":"Login Token"}},"required":["country","thirdSource","userId","registerSource","authToken"]}}}},"responses":{"200":{"description":"","content":{"application/json":{"schema":{"type":"object","properties":{"bizCode":{"type":"string","description":"Module identifier code"},"code":{"type":"string","description":"Status return code"},"msg":{"type":"string","description":"Status description"},"tm":{"type":"integer","format":"int64","description":"Processing time (milliseconds)"},"trace":{"type":"string","description":"Tracking code"},"msgParams":{"type":"string","description":"Placeholder parameter string in return description, multiple parameters separated by commas"},"data":{"type":"object","properties":{"customerNo":{"type":"string","description":"Customer account"},"list":{"type":"array","description":"KYC authentication list information","items":{"$ref":"#/components/schemas/KycAuthVO"}},"companyId":{"type":"integer","format":"int64","description":"Company ID"},"ext1":{"type":"string","description":"Extension Field (Unused)"},"ext2":{"type":"string","description":"Extension Field (Unused)"},"email":{"type":"string","description":"Email"},"phone":{"type":"string","description":"Phone"},"phoneArea":{"type":"string","description":"Phone area code"},"name":{"type":"string","description":"Name"},"loginPassStatus":{"type":"string","description":"Set password reminder flag, 1 for password required, 2 for not required"},"payPassStatus":{"type":"string","description":"Payment password existence status, 1 for non-existent, 2 for existent"},"customerGroupId":{"type":"integer","format":"int64","description":"Customer group"},"country":{"type":"string","description":"Country"},"id":{"type":"integer","format":"int64","description":"Customer ID"},"optional":{"type":"integer","format":"int32","description":"Customized flag 0 not added 1 added"},"companyKycStatus":{"type":"integer","format":"int32","description":"Company KYC account opening status, 1 for opened, 2 for not opened"},"thirdServerCode":{"type":"string","description":"Unique identifier from third-party system"},"source":{"type":"string","description":"Source"},"capitalInStatus":{"type":"integer","format":"int32","description":"Deposit status: 1. Deposited, 2. Not deposited"},"openAccountType":{"type":"integer","format":"int32","description":"Account type: 0. Individual 1. Enterprise "},"companyType":{"type":"string","description":"Company type"},"associationCompanyId":{"type":"integer","format":"int64","description":"Associated company Id"},"registerTime":{"type":"integer","format":"int64","description":"Registration Time"},"apiCheckSwitch":{"type":"boolean","description":"API verification switch. true-verification is enabled"},"apiCheckRule":{"type":"string","description":"API Verification Rules. 1-Email; 2-SMS; 3-Google NFA; Enable multiple verifications at the same time, separated by commas."}}},"ok":{"type":"boolean"},"fail":{"type":"boolean"}}}}},"headers":{}}}}}},"components":{"schemas":{"KycAuthVO":{"type":"object","properties":{"levelCode":{"type":"string","description":"Level Code"},"openAccountType":{"type":"integer","format":"int32","description":"Account type: 0. Individual 1. Enterprise "},"levelName":{"type":"string","description":"Level Name"},"pathName":{"type":"string","description":"KYC Path Name"},"pathCode":{"type":"string","description":"KYC Path Code"},"elementList":{"type":"array","description":"KYC Information List","items":{"$ref":"#/components/schemas/KycAuthElementVO"}}}},"KycAuthElementVO":{"type":"object","properties":{"elementCode":{"type":"string","description":"KYC element code"},"elementName":{"type":"string","description":"KYC element name"},"showType":{"type":"string","description":"KYC element display type"},"extend":{"type":"string","description":"KYC element extended attribute"},"elementValue":{"type":"string","description":"KYC element value"},"elementValueInputGroup":{"type":"string","description":"KYC element value, combination"},"elementCodeInputGroup":{"type":"string","description":"KYC element code, combination"}}}}}} ```