为确保您的平台与 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: 用于接收接口token;
7.Telegram 联系人: 接收接口token的解密密码的Telegram账号;
8.IPs: 沙箱环境服务器出口IP白名单,多个IP用半角逗号隔开(例如:192.168.1.1,192.168.1.2);
9.需要支持的加密货币列表。我们目前支持:"BTC","ETH","USDT","USDC"; 如需调整,请单独联系
10.需要支持的法币列表。我们目前支持:"USD,GBP,EUR,CHF,CAD,JPY,AUD,TWD,BRL,HKD,COP,CZK,DKK,DOP,EGP,HRK,IDR,ILS,JOD,KES,KWD,LKR,MAD,MXN,MYR,NGN,NOK,NZD,OMR,PEN,PKR,PLN,RON,SEK,THB,TRY,VND,ZAR" 如需调整,请单独联系
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/ 登录密码我们会在通知附件里附上。
开发者工具是您在沙箱环境进行自主测试的核心辅助平台,提供以下功能:
| 功能 | 说明 |
|---|---|
| KYC审批/拒绝 | 模拟合规审核流程,对注册用户的KYC申请进行通过或拒绝操作 |
| 账户管理 | 执行关户等账户状态管理操作 |
| 充值模拟 | 为测试账号手动注入法币或加密货币余额 |
| Webhook模拟 | 触发 trade-notify、trade-execute、settlement-update 等Webhook事件 |
| 结算模拟 | 模拟交易结算流程,验证结算通知机制 |
通过开发者工具,您可以自主完成所有测试场景的模拟,无需联系 Legend 技术团队介入。
1.3 测试流程
- IP白名单配置:提交沙箱环境服务器出口IP,我们将配置至沙箱环境API白名单
- 创建测试账号:在您的测试站点(如
https://test.yourplatform.com/otc)引导测试用户完成KYC流程 - 自主激活账号:使用开发者工具审批该测试账号的KYC申请
- 配置测试余额:通过开发者工具为测试账号注入所需测试余额(如 50,000 USD)
- 联合调试:Legend技术团队提供支持,协助完成端到端调试
- QA验证:Legend QA团队将介入进行全流程测试并录制操作视频,作为向合规团队演示的交付物
1.4 测试注意事项
| 注意事项 | 说明 |
|---|---|
| 交易对选择 | 沙箱环境暂不支持 USDT 交易对,请使用 BTC/USD 等交易对(如输入 0.01 BTC) |
| 余额补充 | 如需更多测试余额,可通过开发者工具自主添加 |
| 卖币流程测试 | 如需测试卖出流程,请提供测试URL。交易成功后,系统应将用户卖出的币种存入指定测试钱包 |
| 注:仅支持入金的交易所可忽略卖币测试 |
第二阶段:生产环境上线准备
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,KWD,LKR,MAD,MXN,MYR,NGN,NOK,NZD,OMR,PEN,PKR,PLN,RON,SEK,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-notifytrade-executekyc-status- 其他相关回调接口
双向IP白名单配置
| 方向 | 配置要求 | 说明 |
|---|---|---|
| 您的服务器 | 将Legend服务器出口IP加入白名单 | 防止未授权访问您的回调接口 |
| Legend服务器 | 将您的服务器出口IP加入白名单 | 确保API调用授权,未授权IP调用将返回:{"error": "Access restricted"} |
2.4 获取生产环境API Token(可选)
如需调用Legend REST API(如构建数据报表),可申请生产环境API Token。申请时需提供发起请求的服务器IP地址。
第三阶段:上线与观察
3.1 最终验证
完成所有配置后,Legend团队(技术、QA、产品)将与您的团队共同在生产环境执行完整业务流程验证。Legend QA团队将进行上线前回归测试,确保生产环境与沙箱环境功能一致。
3.2 上线观察期
服务正式上线后,Legend团队将密切观察系统运行1-2周,并与您的团队保持沟通,确保系统平稳运行。
重要提示
| 提示 | 说明 |
|---|---|
| 环境隔离 | 沙箱环境与生产环境的凭证、IP白名单完全独立,严禁混用 |
| IP配置 | 必须分别在沙箱环境和生产环境完成两次独立的IP白名单配置 |
| 自主测试 | 善用开发者工具,可大幅提升测试效率,减少沟通成本 |
| 凭证安全 | 所有生产环境凭证通过加密方式传输,需使用Telegram接收解密密码 |
