上线前的准备

为确保您的平台与 Legend Gateway 的集成顺利上线,请按照以下指南完成从沙箱测试到生产环境部署的全流程准备。

第一阶段:沙箱环境集成测试

1.1 环境配置准备

在开始集成测试前,请提供以下信息给Legend用于配置沙箱环境账号:

1.homepage_url: 您的官网地址;
2.landing_url:用户在您的网站上访问Legend服务的url
3.api_url: 回调接口地址(需以"/"结尾,例如:https://exchange.com/api/);
4.api_key: 用于鉴权,可选;
5.associated_email: 用于在Legend注册账户的邮箱;
6.联系人email: 用于集成过程中的沟通;
7.Telegram 联系人: 用于集成过程中沟通的Telegram账号;
8.需要支持的加密货币列表。我们目前支持:"BTC","ETH","USDT","USDC"; 如需调整,请单独联系
9.需要支持的法币列表。我们目前支持:"USD,GBP,EUR,CHF,CAD,JPY,AUD,TWD,BRL,HKD,COP,CZK,DKK,DOP,EGP,HRK,IDR,ILS,JOD,KES,KRW,KWD,LKR,MAD,MXN,MYR,NGN,NOK,NZD,OMR,PEN,PKR,PLN,RON,SEK,SGD,THB,TRY,VND,ZAR" 如需调整,请单独联系

沙箱环境的 API Token、IP 白名单、Webhook 回调地址已不再在此申请——三者均由你在 DevTools 中自助配置,详见下方 1.2 开发者工具使用指南。

api_url说明

需要包含域名+路径/。例如您的trade-notify回调地址是https://exchange.com/api/trade-notify ,则api_url就是 https://exchange.com/api/ 要以斜杆“/” 结尾。

沙盒环境Legend的IP白名单

52.30.86.215,54.81.240.195,44.198.65.130

1.2 开发者工具使用指南

开发者工具地址: https://otcsb.legendtrading.com/integration/login 登录密码我们会在通知附件里附上。

开发者工具(DevTools)是您在沙箱环境进行自主测试的核心辅助平台,提供以下功能:

功能说明
API Token 管理自助生成并管理用于调用 /app/* 接口的 REST API Token —— 系统设置 → REST API Token → +生成新 Token
IP 白名单自助添加沙箱服务器出口 IP —— 系统设置 → IP 白名单
Webhook 配置设置 Legend 回调的 API_URL,并可发送测试回调 —— 系统设置 → Webhook 配置
KYC审批/拒绝模拟合规审核流程,对注册用户的KYC申请进行通过或拒绝操作
账户管理执行关户等账户状态管理操作
充值模拟为测试账号手动注入法币或加密货币余额
Webhook模拟触发 trade-notify、trade-execute、settlement-update 等Webhook事件
结算模拟模拟交易结算流程,验证结算通知机制
退款审批模拟财务审批一笔待处理的电汇退款——退款随即完成并触发 settlement-update(settled)Webhook。退款发起走您自己的 /app/refund API 集成,此处仅完成审批环节

通过 DevTools,您可以自主完成所有测试场景的模拟,无需联系 Legend 技术团队介入。

⚠️

DevTools 仅存在于沙箱环境。生产环境没有自助入口——生产的 API Token、IP 白名单与 Webhook 回调地址均由 Legend 按申请配置(见第二阶段)。

首次生成 Token 的完整步骤见概述与认证。

1.3 测试流程

  1. 沙箱环境配置:在 DevTools 中生成 REST API Token、将沙箱服务器出口 IP 加入 IP 白名单、设置 Webhook 回调地址——三项均在系统设置页完成,无需向 Legend 申请。步骤见概述与认证。
  2. 创建测试账号:在您的测试站点(如 https://test.yourplatform.com/otc)引导测试用户完成KYC流程
  3. 自主激活账号:使用 DevTools 审批该测试账号的KYC申请
  4. 配置测试余额:通过 DevTools 为测试账号注入所需测试余额(如 50,000 USD)
  5. 联合调试:Legend技术团队提供支持,协助完成端到端调试
  6. QA验证:Legend QA团队将介入进行全流程测试并录制操作视频,作为向合规团队演示的交付物

1.4 测试注意事项

注意事项说明
交易对选择沙箱环境暂不支持 USDT 交易对,请使用 BTC/USD 等交易对(如输入 0.01 BTC)
余额补充如需更多测试余额,可通过开发者工具自主添加
卖币流程测试如需测试卖出流程,请提供测试URL。交易成功后,系统应将用户卖出的币种存入指定测试钱包
注:仅支持入金的交易所可忽略卖币测试

1.5 集成验收

进入生产环境准备之前,集成需先通过验收:

  1. 贵方提供集成凭证:
    • 完整的 UI 录屏或截图(覆盖完整用户流程)
    • 一个在沙箱环境已完成 KYC 的用户,以及对应的一笔交易 ID
  2. Legend 校验:我们核验沙箱数据并复核 UI。
  3. 完成商务合同签署。

验收通过后,进入第二阶段生产环境上线准备。

第二阶段:生产环境上线准备

2.1 环境配置申请

完成沙箱测试后,请单独提交生产环境账号申请:

1.homepage_url: 您的官网地址;
2.api_url: 回调接口地址(需以"/"结尾,例如:https://exchange.com/api/);
3.api_key: 用于鉴权,可选;
4.associated_email: 用于在Legend注册账户的邮箱;
5.联系人email: 用于接收接口token;
6.Telegram 联系人: 接收接口token的解密密码的Telegram账号;
7.IPs: 沙箱环境服务器出口IP白名单,多个IP用半角逗号隔开(例如:192.168.1.1,192.168.1.2);
8.需要支持的加密货币列表。我们目前支持:"BTC","ETH","USDT","USDC","BNB";
9.需要支持的法币列表。我们目前支持:"USD,GBP,EUR,CHF,CAD,JPY,AUD,TWD,BRL,HKD,COP,CZK,DKK,DOP,EGP,HRK,IDR,ILS,JOD,KES,KRW,KWD,LKR,MAD,MXN,MYR,NGN,NOK,NZD,OMR,PEN,PKR,PLN,RON,SEK,SGD,THB,TRY,VND,ZAR"
10.允许的交易对列表。目前我们支持:"BTCUSD", "BTCGBP", "BTCEUR", "BTCCHF", "BTCCAD", "BTCJPY", "BTCAUD", "BTCTWD", "BTCBRL", "BTCHKD", "BTCCOP", "BTCCZK", "BTCDKK", "BTCDOP", "BTCEGP", "BTCHRK", "BTCIDR", "BTCILS", "BTCJOD", "BTCKES", "BTCKWD", "BTCLKR", "BTCMAD", "BTCMXN", "BTCMYR", "BTCNGN", "BTCNOK", "BTCNZD", "BTCOMR", "BTCPEN", "BTCPKR", "BTCPLN", "BTCRON", "BTCSEK", "BTCTHB", "BTCTRY", "BTCVND", "BTCZAR", "ETHUSD", "ETHGBP", "ETHEUR", "ETHCHF", "ETHCAD", "ETHJPY", "ETHAUD", "ETHTWD", "ETHBRL", "ETHHKD", "ETHCOP", "ETHCZK", "ETHDKK", "ETHDOP", "ETHEGP", "ETHHRK", "ETHIDR", "ETHILS", "ETHJOD", "ETHKES", "ETHKWD", "ETHLKR", "ETHMAD", "ETHMXN", "ETHMYR", "ETHNGN", "ETHNOK", "ETHNZD", "ETHOMR", "ETHPEN", "ETHPKR", "ETHPLN", "ETHRON", "ETHSEK", "ETHTHB", "ETHTRY", "ETHVND", "ETHZAR", "USDTUSD", "USDTGBP", "USDTEUR", "USDTCHF", "USDTCAD", "USDTJPY", "USDTAUD", "USDTTWD", "USDTBRL", "USDTHKD", "USDTCOP", "USDTCZK", "USDTDKK", "USDTDOP", "USDTEGP", "USDTHRK", "USDTIDR", "USDTILS", "USDTJOD", "USDTKES", "USDTKWD", "USDTLKR", "USDTMAD", "USDTMXN", "USDTMYR", "USDTNGN", "USDTNOK", "USDTNZD", "USDTOMR", "USDTPEN", "USDTPKR", "USDTPLN", "USDTRON", "USDTSEK", "USDTTHB", "USDTTRY", "USDTVND", "USDTZAR", "USDCUSD", "USDCGBP", "USDCEUR", "USDCCHF", "USDCCAD", "USDCJPY", "USDCAUD", "USDCTWD", "USDCBRL", "USDCHKD", "USDCCOP", "USDCCZK", "USDCDKK", "USDCDOP", "USDCEGP", "USDCHRK", "USDCIDR", "USDCILS", "USDCJOD", "USDCKES", "USDCKWD", "USDCLKR", "USDCMAD", "USDCMXN", "USDCMYR", "USDCNGN", "USDCNOK", "USDCNZD", "USDCOMR", "USDCPEN", "USDCPKR", "USDCPLN", "USDCRON", "USDCSEK", "USDCTHB", "USDCTRY", "USDCVND", "USDCZAR", "BTCUSDT", "ETHUSDT"

2.2 获取生产环境安全参数

我们将为您分配以下生产环境专属参数:

{
  "APP_ID": "YourPlatform",
  "APP_URL": "https://www.yourplatform.com/otc",
  "APP_KEY": "your_public_key",
  "APP_SECRET": "your_secret_key",
  "APP_PASSPHRASE": "your_passphrase"
}

2.3 回调接口与IP白名单配置

生产环境Legend的IP白名单

63.33.225.14,54.246.168.77,52.73.84.127,34.195.245.216

回调接口地址

请提供生产环境部署的Webhook回调接口地址:

  • trade-notify
  • trade-execute
  • kyc-status
  • 其他相关回调接口

双向IP白名单配置

方向配置要求说明
您的服务器将Legend服务器出口IP加入白名单防止未授权访问您的回调接口
Legend服务器将您的服务器出口IP加入白名单确保API调用授权,未授权IP调用将返回:{"error": "Access restricted"}

2.4 获取生产环境API Token(可选)

如需调用Legend REST API(如构建数据报表),可申请生产环境API Token。生产环境没有 DevTools,需人工申请——申请时请提供发起请求的服务器IP地址。

第三阶段:上线与观察

3.1 最终验证

完成所有配置后,Legend团队(技术、QA、产品)将与您的团队共同在生产环境执行完整业务流程验证。Legend QA团队将进行上线前回归测试,确保生产环境与沙箱环境功能一致。

测试账号邮箱:使用测试账号进行生产验证时,请在邮箱本地部分加上 +test+{交易所名称}+{编号} 后缀——例如 [email protected] 改为 [email protected]。这样合规人员能识别出测试账号并尽快审批,无需再走内部流程确认是否为测试账号。

3.2 上线观察期

服务正式上线后,Legend团队将密切观察系统运行1-2周,并与您的团队保持沟通,确保系统平稳运行。

重要提示

提示说明
环境隔离沙箱环境与生产环境的凭证、IP白名单完全独立,严禁混用
IP配置需完成两次独立的IP白名单配置——沙箱环境由你在 DevTools 中自行添加,生产环境由 Legend 按申请添加
自主测试善用 DevTools,可大幅提升测试效率,减少沟通成本
凭证安全沙箱 Token 由你在 DevTools 中生成、不经他人之手。生产环境凭证通过加密方式传输,需使用Telegram接收解密密码