[{"value":"创建购物车永久链接","id":"创建购物车永久链接","hLevel":2,"level":1},{"value":"自定义购物车永久链接","id":"自定义购物车永久链接","hLevel":2,"level":1,"children":[{"value":"商品信息","id":"商品信息","hLevel":3,"level":2},{"value":"结账信息","id":"结账信息","hLevel":3,"level":2},{"value":"折扣信息","id":"折扣信息","hLevel":3,"level":2}]},{"value":"购物车永久链接示例","id":"购物车永久链接示例","hLevel":2,"level":1}]

购物车永久链接

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

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

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

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

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

创建购物车永久链接

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

自定义购物车永久链接

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

商品信息

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

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

结账信息

你可以将期望客户使用的结账信息添加在链接中，可以按照此格式进行添加，多个结账信息需要用 & 符号进行串联：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}`