要让 DApp 接上币安钱包并完成上线,核心路径是:集成 Binance Web3 Connect SDK(EVM 链使用 window.binancew3w.ethereum)→ 在币安钱包浏览器内完成自测 → 通过 Web3 钱包开放平台提交申请 → 等待质量控制测试。连接与签名是开发者可控的部分,上线验收则取决于你是否通过了币安按自测清单执行的逐项检查。审核结果通常在 7 个工作日内给出,但"申请通过"不等于"一定展示",质量控制不过关照样会被拒。
先分清你在接什么:钱包环境与链类型
币安 Web3 钱包的集成方式取决于两个变量:DApp 是否运行在币安钱包浏览器内,以及目标链是 EVM 兼容链还是非 EVM 链。这决定了你该调用哪个注入对象,而不是一套代码到处套。
如果你做的是 EVM 兼容链(BNB Chain、以太坊等),并且 DApp 在币安钱包内置浏览器中打开,币安会向全局注入 window.binancew3w.ethereum。连接钱包的标准做法是先检测这个对象是否存在,再调用 eth_requestAccounts。如果它不存在,说明用户不在币安钱包环境里,应该引导用户打开币安 App 或给出其他连接方式。
如果目标是 TON,注入的是 window.binancew3w.tonconnect,遵循 Ton Connect 协议,版本目前为 2。DApp 在钱包外打开时,需要使用 HTTP Bridge API 而不是 JS Bridge。比特币和 Tron 也各有独立的 provider 或适配器,不能混用 EVM 的调用方式。
一个常见的误判:以为集成了 RainbowKit 或 wagmi 就自动支持币安钱包。币安提供了 @binance/w3w-rainbow-connector-v2 这类连接器包,你需要把它加进钱包列表里,用户才能在连接弹窗中看到币安钱包选项。没有加连接器,前端不会凭空出现币安入口。
连接:拿到地址之后,先处理链不匹配的问题
连接成功只意味着你拿到了用户地址和当前 chainId。接下来最常见的故障是链不匹配。币安自测手册把 Network not supported for this wallet 列为高频问题,原因是项目网站没有在用户连接时检测并切换到 DApp 需要的链。修复方式不是等用户手动切,而是在连接回调里读取 window.ethereum 的 chainId,如果和目标链不一致,主动请求切换或给出明确的切换提示。
另一个容易被忽略的细节是监听链和账户变化。币安 EVM provider 支持 accountsChanged 和 chainChanged 事件。如果用户在你的 DApp 开着的时候在钱包里切了账户或切了链,你不监听这两个事件,界面显示的状态就会和用户实际钱包状态脱节,后续发起的交易可能从错误地址或错误链上发出。
签名与交易:验的是结果,不是"弹了窗口"
自测清单里对签名的要求很直接:签名值必须是有效的;对交易的要求是:整个交易流程成功,并且能在链上查到。弹出了签名窗口、用户点了确认,不等于签名可用;交易哈希返回了,也不等于链上执行成功。
EVM 链的发交易调用是 eth_sendTransaction,参数里需要填 from、to、value、gasLimit 等字段。返回的 txHash 应该拿去区块浏览器核对执行状态,而不是只在前端打印一下就结束。签名场景同理:拿 personal_sign 或 eth_signTypedData 返回的签名值,用对应的地址做一次恢复验证,确认签名确实由该地址生成。这一步不做,上线后用户遇到"签名无效"的报错,你很难判断是钱包问题还是自己的参数问题。
自测手册还提到一个排查技巧:如果链上操作的 gas 费异常高,可以先换 Trust Wallet 或 MetaMask 测试。如果只在币安钱包里偏高,可能是币安 RPC 侧的问题,需要联系币安对接人,而不是反复改自己的合约调用。
自测:币安拒掉申请,很多时候是因为这一步没做够
币安对自测的态度写得很明确:自测质量低下的项目,币安保留拒绝申请的权利。自测不是走形式,它是后续质量控制测试的预演,你自测时漏掉的问题,审核时同样会被发现。
自测要在最新版币安 Web3 钱包浏览器里完成,iOS 和 Android 两端都要过。自测清单覆盖的东西比"能连上"多得多:连接是否稳定且没有页面跳转;币安 Logo 是否在 Web 和 App 端都有正确曝光;Swap、Approve 等各类发交易场景是否都成功;gas 费是否在正常范围;字体和图标显示是否正常;DApp 内的所有 URL 是否都能在币安内直接打开;以及项目是否会在支持的情况下自动切换到用户当前链。
移动端还有一个容易卡住的点:确保币安 App 更新到最新版本。部分登录问题来自 SDK 状态或网络/VPN 连接,而不是代码错误。如果你的 DApp 依赖 WalletConnect 作为桌面端回退方案,需要知道一个已知问题:通过 WalletConnect 扫码连接币安钱包后,wagmi 状态可能一直显示 disconnected,发交易会报 ConnectorNotConnectedError。这不是你配置错了,有开发者报告过同类问题;如果遇到,优先引导用户使用币安钱包内置浏览器或注入式 provider 完成核心流程。
上线验收:提交之后会发生什么
自测完成后,通过币安 Web3 钱包开放平台提交申请。登录开放平台,阅读 Vendor Agreement,在 dApp 页面点击申请并填写表单,内容包括 DApp 名称、URL、分类、联系人 Telegram、受限国家、英文介绍、社交链接、可公开查看的安全审计链接、链名称和活动主视觉等。提交后状态变为"审核中"。
币安会在申请获批后的 5 到 7 个工作日内,按照自测清单执行质量控制测试。这里有一个关键区别需要理解:申请状态显示 Approved,不代表 DApp 会自动出现在币安 Web3 钱包的 Discover 板块。只有通过质量控制测试的 DApp 才会被展示,入口路径是 Web3 → Discover → dApps。币安明确写出,只有完成集成(包括 Logo 曝光)并通过自测清单所有项目的 DApp 才会被列入。
如果你在 7 个工作日后没有收到结果,或者状态长期停在审核中,可以通过申请时填写的 Telegram 联系人渠道跟进。币安没有提供一个公开的独立申诉入口,联系信息是提交表单时你自己填的那个。
上线前的最后核验
在提交申请之前,用下面这套标准做一次内部判断,任何一项不过关,先修再交:
| 核验项 | 通过标准 |
|---|---|
| 连接稳定性 | 在币安钱包浏览器内连接不跳转、不掉线,iOS 和 Android 均正常 |
| 链处理 | 连接后自动检测并提示/切换到目标链,不出现 Network not supported |
| 签名有效性 | 返回的签名值可以用对应地址恢复验证 |
| 交易可查 | 每笔发交易都有 txHash,且在区块浏览器上确认成功 |
| Logo 曝光 | 币安 Logo 在 Web 端和 App 端均正确显示 |
| 事件监听 | accountsChanged 和 chainChanged 能正确更新前端状态 |
如果这些你都过了一遍,提交申请时心里会有底。审核团队做的事情和你刚做的自测用的是同一套清单,差别只在于他们不会替你猜哪些场景你没测。
参考资料
- Binance·DApp Self-Listing Manual,页面发布或更新日期:2026-08-13;核查日期:2026-10-19。
- Binance·DApp Self-Listing Manual (中文版),页面发布或更新日期:2026-08-27;核查日期:2026-10-19。
- Binance·EVM-Compatible Provider,页面发布或更新日期:2026-09-07;核查日期:2026-10-19。
- Binance·Ton Provider,页面发布或更新日期:2026-09-29;核查日期:2026-10-19。
- Binance·Bitcoin Provider,页面发布或更新日期:2026-07-23;核查日期:2026-10-19。
- Binance·Tron Provider,页面发布或更新日期:页面未标明更新日期;核查日期:2026-10-19。
- Binance·DApp Self-Testing Manual,页面发布或更新日期:2026-10-01;核查日期:2026-10-19。
- GitHub·[bug] Connecting with WalletConnect QR code does not work,页面发布或更新日期:2024-12-28;核查日期:2026-10-19。



