# 从你自己的页面销售定制商品

> 如果你搭建了自己的页面，让顾客自己设计商品并实时看到价格，这个页面就能把这件商品原样加入你的 Shoprocket 购物车。你的服务器会用签名密钥给商品签名，所以没有人能在浏览器里改价格。

帮助中心 / 集成 - 更新于 2026年11月12日

有些商品的价格取决于顾客的选择。定制书架越长越贵，凉棚的价格取决于尺寸和所用的木材。现在不少卖家会为此搭建自己的页面，常常借助 AI 建站工具：顾客拖动几个滑块，就能看到价格随之变化。

这个页面可以把设计好的成品加入你的 Shoprocket 购物车。顾客随后照常结账，你的其他商品也在同一个购物车里，订单、邮件和发票会显示他做的每一个选择。

**价格带有签名，所以顾客无法修改。** 网页自己发送的价格，任何人都能在浏览器里改掉。因此价格由你自己的服务器计算，并用一把保密的密钥签名。商品加入购物车之前，Shoprocket 会先检查签名，只要有任何改动就会拒绝。

这需要开发者，或者能在服务器上运行代码的 AI 建站工具，因为签名必须在服务器上完成，而不是在网页里。

## 开始之前

签名密钥在 **API 密钥** 页面，它属于 **开发者工具** 应用。如果侧边栏的 **设置** 下看不到 **API 密钥**，请前往 **应用**，在 **开发者** 下找到 **开发者工具** 并点击 **添加**。参见 [添加和移除应用](https://shoprocket.io/zh/help/the-apps-page.md)。

你还需要在商品目录中有一件商品，用来存放这件定制商品，例如“定制书架”。定制商品会沿用该商品的税费设置和配送选项，图片也一样，除非你的服务器发送了自己的图片。如果你不想让顾客直接按标价单独购买这件商品，请把它设为 **咨询**（参见 [接收报价请求和咨询](https://shoprocket.io/zh/help/quotes-and-enquiries.md)）。顾客仍然可以购买这件商品的已签名定制商品。

## 创建签名密钥

1. 在后台进入 **设置 > API 密钥**。
2. 在 **签名密钥** 卡片中，点击 **创建签名密钥**。
3. 复制 **密钥 ID** 和 **密钥**，然后点击 **我已保存**。

![“签名密钥”卡片，显示新密钥的密钥 ID 和密钥，以及复制按钮](https://shoprocket.io/img/help/sell-custom-priced-items/signing-key.webp)

密钥只会显示这一次。请把它保存在你的服务器上，让页面的代码能够读取，千万不要放进网页本身。

## 把已签名的商品加入购物车

你的服务器先写出一份简短的商品描述并签名，再由你的页面把结果交给购物车。描述包含：

- 它属于哪件商品，以及单件价格（使用店铺的币种）
- 在购物车里显示的名称，例如“书架，120 厘米，橡木”
- 顾客的选择，以标签和值的列表呈现，例如“长度：120 厘米”
- 单件的重量（如果你按重量收运费）
- 设计的图片（如果已经在网上），以 https:// 开头的网址形式提供
- 价格的有效期，最长为从现在起 30 天

开发者可以在 [已签名的购物车商品](https://shoprocket.io/docs/signed-items.md) 中找到确切的格式和可直接复制的示例。之后你的页面只需一行代码就能加入商品，购物车的打开方式和其他商品一样：

```js
Shoprocket.cart.add({ signed: signedItemFromYourServer, quantity: 1 });
```

顾客可以在购物车里修改数量，但无法修改价格。两个不同的设计会保留为两件独立的商品。

## 你的顾客会看到什么

商品会以你起的名称显示在购物车里，配有它自己的图片，下方列出顾客的每一项选择。图片是你的服务器发送的那张，如果没有发送，则是商品本身的图片。结账后，同样的选择会出现在后台的订单里、订单确认邮件中以及发票上。

要让每位客户看到自己的设计，你的页面可以保存一张设计图，并在添加商品之前把它上传到购物车：

```js
const { token } = await Shoprocket.cart.uploadFile(snapshot);
Shoprocket.cart.add({ signed: signedItemFromYourServer, image: token, quantity: 1 });
```

Shoprocket 会保留图片的自有副本，所以你不需要把它存放在别处。如果客户始终没有结账，图片会随购物车一起删除。你的服务器以网址形式发送的图片，也会在下单时被复制。无论哪种情况，即使原始文件之后被删除，订单及其邮件仍会继续显示这张图片。

折扣码和自动折扣对已签名的商品和其他商品一样有效。商品自身的促销价和数量折扣都不会改变这个价格，因为你的服务器签名的价格就是最终价格。

如果你按重量收运费，以服务器签名的重量为准。否则，使用该商品自己的配送设置。

## 在固定时间内保留价格

每件签名商品都会注明其价格的有效期，因此您可以在固定时间内兑现报价。例如，如果您给一座凉亭报价 1,000，并同意将这个价格保留 14 天，您的服务器就为该商品签名，有效期为 14 天后。价格最长可保留 30 天。

顾客会在购物车中该商品下方看到“价格保留至”及日期。在该日期之前，他们可以按此价格付款。

过了该日期，即使商品仍在购物车中，他们也无法再按此价格购买。顾客尝试付款时，购物车会在该商品下方显示“此价格已过期，请重新报价。”，并提供一个移除按钮。然后他们可以回到您的页面获取新价格。

如果顾客在价格过期前已经下单，或已批准 PayPal 付款，则不会受到任何阻拦。订单将按您签名的价格完成。

## 更换或吊销密钥

- **更换密钥**：当开发者离职，或你怀疑密钥泄露时使用。点击 **更换密钥**。旧密钥还能继续使用 7 天，所以在你把服务器更新为新密钥期间，页面不会中断。旧密钥会显示它停止的日期。
- **吊销密钥**：想让它立即失效时使用。点击 **吊销** 并确认。用它签名的商品将无法再加入购物车，已经在顾客购物车里的商品会在结账时被拒绝。

## 相关文章

- [创建 API 密钥](https://shoprocket.io/zh/help/api-keys.md)
- [在任何网站上嵌入 Shoprocket](https://shoprocket.io/zh/help/embed-on-any-website.md)
- [附加项和个性化](https://shoprocket.io/zh/help/product-add-ons-and-personalisation.md)

[在后台打开 API 密钥](https://app.shoprocket.io/go/settings/api-keys)

---

- HTML version: https://shoprocket.io/zh/help/sell-custom-priced-items
- Language: 中文 (zh)
- Also in: [العربية](https://shoprocket.io/ar/help/sell-custom-priced-items.md), [Deutsch](https://shoprocket.io/de/hilfe/eigene-seite-massgefertigte-artikel-verkaufen.md), [Ελληνικά](https://shoprocket.io/el/help/sell-custom-priced-items.md), [English](https://shoprocket.io/help/sell-custom-priced-items.md), [Español](https://shoprocket.io/es/ayuda/vender-articulos-a-medida-desde-tu-propia-pagina.md), [Français](https://shoprocket.io/fr/aide/vendre-articles-sur-mesure-depuis-votre-page.md), [עברית](https://shoprocket.io/he/help/sell-custom-priced-items.md), [हिन्दी](https://shoprocket.io/hi/help/sell-custom-priced-items.md), [Bahasa Indonesia](https://shoprocket.io/id/bantuan/jual-barang-pesanan-khusus-dari-halaman-anda-sendiri.md), [Italiano](https://shoprocket.io/it/aiuto/vendere-articoli-su-misura-dalla-tua-pagina.md), [日本語](https://shoprocket.io/ja/help/sell-custom-priced-items.md), [Lietuvių](https://shoprocket.io/lt/pagalba/parduokite-pagal-uzsakyma-pagamintas-prekes-is-savo-puslapio.md), [Norsk](https://shoprocket.io/nb/hjelp/selge-skreddersydde-varer-fra-din-egen-side.md), [Nederlands](https://shoprocket.io/nl/hulp/maatwerk-artikelen-verkopen-vanaf-je-eigen-pagina.md), [Polski](https://shoprocket.io/pl/pomoc/sprzedawaj-produkty-na-miare-z-wlasnej-strony.md), [Português](https://shoprocket.io/pt/ajuda/vender-itens-sob-medida-na-sua-propria-pagina.md), [Română](https://shoprocket.io/ro/ajutor/vinde-articole-la-comanda-din-propria-pagina.md), [Русский](https://shoprocket.io/ru/help/sell-custom-priced-items.md), [ไทย](https://shoprocket.io/th/help/sell-custom-priced-items.md), [Türkçe](https://shoprocket.io/tr/yardim/kendi-sayfanizdan-ozel-uretim-urunler-satin.md)
