跳到主要内容
开发者

嵌入 BayChange 小组件

只需一行 HTML，即可将我们的兑换表单添加到您的网站。在其中发起的兑换会计入您的合作伙伴代码。

公开 REST API：暂未开放。目前您可以通过下方的小组件和合作伙伴链接集成 BayChange。请在您的账户中获取合作伙伴代码，账户中还提供带实时预览的代码生成器。

快速开始

将这段代码粘贴到需要显示表单的位置，并把 your-code 替换为您的合作伙伴代码。默认高度（720 px）可以完整容纳表单；如需精确适配，请添加下方的高度调整脚本。

HTML
<iframe
  src="https://baychange.com/embed?ref=your-code&amp;from=usdt.tron&amp;to=btc.btc"
  title="Crypto exchange by BayChange"
  width="100%" height="720"
  style="display:block;width:100%;max-width:480px;border:0;color-scheme:light"
  allow="clipboard-read; clipboard-write" loading="lazy"></iframe>

参数

所有参数都写在 iframe 地址中：https://baychange.com/embed?ref=…&from=…。所有参数均为可选。

refk7m2qxa您的合作伙伴代码（在账户中获取）。在小组件中发起的兑换计入您的名下。不填写时小组件也能正常使用，但不会计入任何佣金。
fromusdt.tron发送的币种，格式为 SYMBOL.NETWORK，不区分大小写。默认：波场上的 USDT。
tobtc.btc获得的币种。默认：BTC。
amount250发送数量，以“from”币种为单位。访客可以修改。
themelight表单周围的背景：light（白色，默认）或 transparent（透明）。
localezh界面语言：en, es, pt-br, tr, ru, uk, kk, uz, az, de, fr, it, pl, ja, zh, id, vi。默认：en。设置后小组件会在 /<语言代码>/embed 打开（您也可以直接使用该地址，例如 https://baychange.com/zh/embed?ref=your-code）。

事件

小组件通过 postMessage 向您的页面发送消息。请务必检查 event.origin 是否为 https://baychange.com。

baychange:ready—小组件加载完成。
baychange:resize{ height }小组件内容的高度（像素），可用于调整 iframe 的高度。
baychange:order_created{ order: { id, from, to, amountIn } }访客创建了订单。baychange.com 上的订单页面会在新标签页中打开。

自动调整 iframe 高度

HTML
<iframe
  src="https://baychange.com/embed?ref=your-code"
  title="Crypto exchange by BayChange"
  width="100%" height="720"
  style="display:block;width:100%;max-width:480px;border:0;color-scheme:light"
  allow="clipboard-read; clipboard-write" loading="lazy"></iframe>
<script>
window.addEventListener("message", function (e) {
  if (e.origin !== "https://baychange.com" || !e.data || e.data.type !== "baychange:resize") return;
  document.querySelectorAll('iframe[src^="https://baychange.com/embed"]').forEach(function (f) {
    if (f.contentWindow === e.source) f.style.height = e.data.height + "px";
  });
});
</script>

监听新订单

JavaScript
window.addEventListener("message", function (e) {
  if (e.origin !== "https://baychange.com" || !e.data) return;
  if (e.data.type === "baychange:order_created") {
    // e.data.order = { id, from, to, amountIn }
    console.log("BayChange order created", e.data.order.id);
  }
});

您的访客会看到什么

  1. 获取报价选择币种和数量，在发送任何币之前即可看到手续费和获得数量。
  2. 填写地址收币地址和退款地址会在表单中校验，与我们网站上的方式相同。
  3. 打开订单页面点击“开始兑换”会创建订单，并在新标签页中打开 baychange.com 上的订单页面，页面显示充值地址和实时状态。

限制与规则

  • 目前还没有公开 REST API。小组件和合作伙伴链接是现阶段唯一的集成方式。
  • 请勿为 iframe 设置 sandbox。如果必须设置，请添加 allow-scripts、allow-same-origin、allow-forms、allow-popups 和 allow-popups-to-escape-sandbox，否则表单和订单页面将无法正常工作。
  • iframe 宽度至少为 320 px。表单按 360–480 px 的宽度设计。
  • 请勿遮挡、裁剪表单或修改其样式，也不要在表单之外向访客索要钱包地址。
  • 显示充值地址的订单页面始终在 baychange.com 上打开，而不是在您的网站内。
  • 常规限制同样适用：各币种的最低数量、每位访客的请求次数限制，以及不提供服务的地区。
  • baychange:order_created 事件中的订单号可用于打开订单页面。请将其视为私密信息：不要公开，也不要记录在他人可以看到的日志中。

佣金、提取和合作伙伴规则：请见合作伙伴计划和《合作伙伴条款》。

获取合作伙伴代码