Skip to content

自定义模式:使用您自己的按钮 ​

不用 SDK 自带的面板、按钮或横幅,而是用您网站上自己的「购买」按钮。用户点击按钮时,您调用 rakufun.quickBuy() 把商品信息交给 SDK,SDK 会在新标签页打开 RAKUFUN 的商品页,用户在那里完成购买。

什么时候用: 希望购买按钮的样式、文字、位置完全按自己的设计来,或者要把购买入口放进自己的弹窗、表单里。如果只想快速接入,用 默认模式 更省事。

接入步骤 ​

第一步:引入 SDK,并关掉自带的面板 ​

html
<script src="https://sdk.rakufun.com/rakufun-universal.min.js"></script>
<script>
  rakufun.disableAutoUI();
</script>

SDK 引入后,默认会在页面底部显示自己的购买面板。disableAutoUI() 就是用来关掉它的,紧跟在引入 SDK 的那一行后面写即可。不写的话,页面上会同时出现您的按钮和 SDK 的面板。

第二步:放一个您自己的按钮 ​

html
<button id="my-buy-button">立即购买</button>

按钮的样式、文字、位置都由您决定。

第三步:点击按钮时调用 quickBuy ​

javascript
document.getElementById('my-buy-button').addEventListener('click', async () => {
  const result = await rakufun.quickBuy({
    url: window.location.href,                   // 当前商品页的地址
    title: 'Bose QuietComfort 耳机',              // 商品名称
    price: '26800',                              // 价格,只写数字,不要带 ¥ 或逗号
    images: ['https://example.com/product.jpg']  // 商品图片,写完整地址
  });

  if (!result.success) {
    console.error('购买失败:', result.message);
    alert('购买失败,请重试');
  }
});

quickBuy 一定要在用户点击时调用。它会打开一个新标签页,不是由点击触发的话,浏览器可能会拦截。

完整示例 ​

把三步合在一起,可以直接复制到页面里试:

html
<!DOCTYPE html>
<html>
<head>
    <title>自定义购买按钮</title>
</head>
<body>
    <h1>Bose QuietComfort 耳机</h1>
    <img src="https://example.com/product.jpg" alt="商品图片">
    <p class="price">¥26,800</p>

    <!-- 您自己的按钮 -->
    <button id="my-buy-button">🛒 立即购买</button>

    <script src="https://sdk.rakufun.com/rakufun-universal.min.js"></script>
    <script>
        rakufun.disableAutoUI(); // 不显示 SDK 自带的底部面板

        document.getElementById('my-buy-button').addEventListener('click', async () => {
            const result = await rakufun.quickBuy({
                url: window.location.href,
                title: 'Bose QuietComfort 耳机',
                price: '26800',
                images: ['https://example.com/product.jpg'],
                description: '顶级降噪耳机'
            });
            if (!result.success) {
                console.error('购买失败:', result.message);
                alert('购买失败,请重试');
            }
        });
    </script>
</body>
</html>

quickBuy 的返回结果 ​

quickBuy 不会抛出异常,不需要写 try/catch,看返回的 result.success 就可以:

情况返回的 result说明
成功{ success: true, url, message, data }RAKUFUN 商品页已在新标签页打开,当前页面不会跳走
失败{ success: false, message, error }message 是失败原因,可以打印出来排查

可以传哪些商品信息 ​

上面的例子只传了几个字段。信息传得越完整,用户在 RAKUFUN 商品页看到的内容就越全。全部字段如下:

javascript
await rakufun.quickBuy({
  // 建议传入
  url: window.location.href,       // 当前商品页的地址
  title: "Nintendo Switch OLED",   // 商品名称
  price: "37980",                  // 价格,只写数字
  images: [                        // 商品图片,可以传多张
    "https://example.com/switch-1.jpg",
    "https://example.com/switch-2.jpg"
  ],

  // 可选
  description: "7 英寸 OLED 显示屏,64GB 存储空间",  // 商品描述,超过 2000 字符会被截断
  brand: "Nintendo",               // 品牌
  condition: "全新",                // 商品状态,如 全新 / 二手 / 展示品
  minQuantity: "1",                // 最低起购数量,不传默认 1
  maxStock: "100",                 // 最大库存数量,不传默认 99
  shippingInfo: "免运费",           // 运费信息
  deliveryTime: "3-5 个工作日",      // 预计配送时间
  precautions: "支持一年保修",       // 注意事项
  productParameters: "尺寸: 102mm × 242mm × 13.9mm, 重量: 约 320g"  // 规格参数
});

每个字段的详细说明见 API 文档 - 商品信息字段。

在 React、Vue 等框架中使用 ​

用法一样:引入 SDK 后调用一次 rakufun.disableAutoUI(),然后在按钮的点击事件里调用 window.rakufun.quickBuy()。以 React 为例:

jsx
function BuyButton({ product }) {
  const handleBuy = async () => {
    const result = await window.rakufun.quickBuy({
      url: window.location.href,
      title: product.title,
      price: product.price,
      images: product.images
    });
    if (!result.success) {
      alert('购买失败,请重试');
    }
  };

  return <button onClick={handleBuy}>立即购买</button>;
}

常见问题 ​

页面上除了我的按钮,还出现了 SDK 的底部面板? ​

没有调用 rakufun.disableAutoUI(),或者调用得太晚了。把它写在引入 SDK 那一行的紧后面。

点击按钮后没有打开新页面? ​

  1. 打开浏览器控制台,看有没有打印「购买失败」和失败原因
  2. 看浏览器地址栏是否提示拦截了弹出窗口。quickBuy 要在用户点击时调用,不要放在页面加载或定时器里
  3. 控制台如果提示 rakufun is not defined,说明 SDK 还没引入,检查 <script> 的地址和位置

调用 quickBuy 后,当前页面会跳走吗? ​

不会。RAKUFUN 商品页在新标签页打开,用户还停留在您的网站上。

日本的访客也会看到我的按钮吗? ​

会。其他三种模式在日本 IP 下默认不显示,是 SDK 替您隐藏了它自己的界面;自定义模式的按钮是您自己的,SDK 不会去隐藏它。如果只想让海外访客看到,请联系我们。

其他接入方式 ​


有疑问?联系我们:service@rakufun.com

基于 MIT 许可证发布