---
title: "购物车永久链接"

doc_type: static
doc_category: static
doc_version: v20270301
source_url:
  html: 'https://developer.shopline.com/zh-hans-cn/docs/apps/sales-channel/permanent-cart-links'
  md: 'https://developer.shopline.com/zh-hans-cn/docs/apps/sales-channel/permanent-cart-links.md'
---
# 购物车永久链接

购物车永久链接是一种能预加购商品至购物车，并将客户直接带到结账页的渠道。使用购物车永久链接可让你为客户提供多样顺畅的结账体验。

在创建购物车永久链接时，你可以选择要应用的商品、结账和折扣。客户通过链接点击，将会直接跳转到加载有对应商品、结账和折扣信息的结账页，直接处理和完成结账。

购物车永久链接具有持续性，顾名思义，生成后可以一直生效。你可将链接插入邮件，或应用于多种营销活动中，灵活便捷，带来更高的店铺转化。

通过本文，你可以了解到如下信息：

- 创建购物车永久链接
- 自定义购物车永久链接
- 购物车永久链接示例

## 创建购物车永久链接
你可以通过拼接商店的购物车页面链接，外加一个或多个商品 sku_id 来手动构建购物车永久链接。
要查看完整的购物车永久链接，参阅 [购物车永久链接示例](#购物车永久链接示例)。

## 自定义购物车永久链接
购物车永久链接支持你自定义在 URL 链接上添加商品、结账、折扣信息，具体使用方法如下：

### 商品信息

- 若使用购物车永久链接，必须保证链接上包含商品信息
- 你需要按照此格式将商品信息添加在你的购物车 URL 链接后面，多个商品需要用逗号分隔：`http://{handle}.myshopline.com/cart/{sku1_id}:{quantity},{sku2_id}:{quantity},...`
- 商品 `sku_id` 可以从对应商品详情页 URL 获取
![image.png](https://img.myshopline.com/image/official/b19bae59b3a24e5f8ac17bf0c48ca8ad.png)
- 你可以为商品添加 Properties（商品行自定义属性），用于刻字、备注、礼品包装等场景。Properties 通过 `properties[n]` 查询参数添加，`n` 为商品在链接商品列表中的位置索引，从 0 开始：
  - `properties[0]` 对应链接中的第一个商品
  - `properties[1]` 对应链接中的第二个商品
  - 依此类推
- 每个 `properties[n]` 的值需要将属性 JSON 数组进行 Base64 URL 编码后传入。属性字段包含：

| **字段** | **参数类型** | **说明** |
| --- | --- | --- |
| name | String | 属性名称。 |
| value | String | 属性值。 |
| type | String | 属性值类型。有效枚举值包含：<br /><ul><li>`text`：文本。</li><li>`picture`：图片。</li><li>`link`：链接。</li></ul> |
| show | Boolean | 该属性是否可见。<ul><li>`true`：该属性可见。</li><li>`false`：该属性不可见。</li></ul>|
| extInfo | String | 该属性下的扩展字段。 |
| additional | String | 关于该属性的附加信息字段。<br />例如，当该属性定义了文字相关的信息时，可以通过该字段附加文字的字号、字体、颜色等字段。<br />示例：`Additional fields`  |
| urls | String[] | URL 资源列表，仅当 `type` 字段的值为 `picture` 或 `link` 时有效。<ul><li>如果 `type` 为 `picture`，可通过 `urls` 渲染出缩略图。</li><li>如果 `type` 为 `link`，可通过 `urls` 中的第一个 URL 跳转到对应页面。</li></ul>示例：`["https://www.url.com"]` |
| roleVisibility | String | 该属性的可见对象。有效枚举值包括：<ul><li>`customer`：仅对客户可见</li><li>`merchant`：仅对商家可见</li><li>`all`：同时对客户和商家可见</li><li>`none`：同时对客户和商家不可见</li></ul> |

### 结账信息

- 你可以将期望客户使用的结账信息添加在链接中，可以按照此格式进行添加，多个结账信息需要用 `&` 符号进行串联：`http://{handle}.myshopline.com/cart/{sku1_id}:{quantity},{sku2_id}:{quantity}?checkout[email]=example@example.com&checkout[shipping_address][city]=NewYork`
- 所有支持的结账字段如下表格：

| **添加格式** | **对应结账页字段** | **字段描述** |
| --- | --- | ---|
| checkout[email] | email | 客户下单的邮箱。         |
| checkout[phone] | phone |  客户的电话号码，采用 E.164 标准电话号码格式，例如 `+16135551111`。   |
| checkout[shipping_address][name] | name |   客户的姓名。     |
| checkout[shipping_address][first_name] | firstName |  客户的名字。      |
| checkout[shipping_address][last_name] | lastName |   客户的姓氏。   |
| checkout[shipping_address][address1] | address1 | 地址的第一行，通常为街道地址或邮政信箱号码。   |
| checkout[shipping_address][address2] | address2 |地址的第二行，通常为公寓、套房或单元号。 |
| checkout[shipping_address][district] | receiverArea | 地址中的区域。 |
| checkout[shipping_address][city] | city |地址中的城市。 |
| checkout[shipping_address][province] | province |地址中的省、州或区。 |
| checkout[shipping_address][country] | country |地址中的国家。 |
| checkout[shipping_address][zip] | zip |地址中的邮政编码。|


### 折扣信息

- 你可以将折扣码添加在你的购物车 URL 链接后面，多个折扣码需要用逗号分隔：`http://{handle}.myshopline.com/cart/{sku1_id}:{quantity},{sku2_id}:{quantity}?discount={discount_code1},{discount_code2}`

---

## 购物车永久链接示例
| **添加项** | **是否必需** | **场景** | **示例** |
| --- | --- | --- | --- |
| 商品信息 | 必需 | 支持添加商品 SKU 和数量 | `http://{handle}.myshopline.com/cart/{sku1_id}:{quantity},{sku2_id}:{quantity},...` |
| Properties | 可选 | 支持为商品行添加自定义属性 | `http://{handle}.myshopline.com/cart/{sku1_id}:{quantity}?properties[0]=W3sibmFtZSI6ImVuZ3JhdmluZyIsInZhbHVlIjoiSGVsbG8gd29ybGQiLCJ0eXBlIjoidGV4dCIsInNob3ciOiJ0cnVlIiwiZXh0SW5mbyI6IiJ9XQ` |
| 结账信息 | 可选 | 支持添加结账信息 | `http://{handle}.myshopline.com/cart/{sku1_id}:{quantity},{sku2_id}:{quantity}?checkout[email]=example@example.com&checkout[shipping_address][city]=NewYork` |
| 折扣信息 | 可选 | 支持添加折扣码信息 | `http://{handle}.myshopline.com/cart/{sku1_id}:{quantity},{sku2_id}:{quantity}?discount={discount_code1},{discount_code2}` |


> **Tips**
>
> - 链接中不支持空格。
> - 结账信息中，标准地址数据出现匹配错误（比如省份字段应为广东，而链接上错误添加了省份为广州）则该数据将不被处理。
> - 链接中所有支持的符号均为半角格式。