# Shoplazza 应用开发

> 开发、上架和运营 Shoplazza 应用的文档。

顶层索引：https://www.shoplazza.dev/zh-CN/llms.txt

## 快速入门

- [Shoplazza 应用快速入门](https://www.shoplazza.dev/zh-CN/docs/app/getting-started.md): 从零到上架 Shoplazza 应用的三步路径：创建应用、补齐核心能力与扩展、正式上线，并给出各环节文档入口。
- [应用概览](https://www.shoplazza.dev/zh-CN/docs/app/getting-started/overview.md): Shoplazza 应用是什么、能扩展哪些场景（商家后台、店铺前台、营销运营），以及商家如何安装与授权。
- [应用类型](https://www.shoplazza.dev/zh-CN/docs/app/getting-started/app-types.md): 对比 Shoplazza 公开应用与私有应用：分发方式、生命周期，以及嵌入式与独立式两种集成方式怎么选。
- [创建公开应用](https://www.shoplazza.dev/zh-CN/docs/app/getting-started/create-public-app.md): 构建 Shoplazza 公开应用的完整路径：注册合作伙伴账号、开发、测试，直到提交审核。
- [注册合作伙伴](https://www.shoplazza.dev/zh-CN/docs/app/getting-started/create-public-app/register-partner.md): 在开发者平台注册 Shoplazza 合作伙伴账号——创建、管理 Shoplazza 应用并获得收益的第一步。
- [创建应用](https://www.shoplazza.dev/zh-CN/docs/app/getting-started/create-public-app/create-app.md): 在开发者后台创建 Shoplazza 公开应用：应用配置、回调地址与权限、上架信息管理，以及四种定价模式的选择。
- [开发独立应用](https://www.shoplazza.dev/zh-CN/docs/app/getting-started/create-public-app/develop-app.md): Node.js + Express 教程第一篇：用 Shoplazza CLI 初始化应用、用 ngrok 做隧道，并实现独立应用的 OAuth 流程。
- [开发嵌入式应用](https://www.shoplazza.dev/zh-CN/docs/app/getting-started/create-public-app/embed-in-admin.md): Node.js + Express 教程第二篇：让 Shoplazza 应用跑在后台 iframe 中，并用 App Bridge 与 Session Token 完成鉴权。
- [测试应用](https://www.shoplazza.dev/zh-CN/docs/app/getting-started/create-public-app/test-app.md): 送审前测试 Shoplazza 应用：创建开发店铺、按你的后端情况选择安装方式，再验证核心功能与扩展。
- [提交审核](https://www.shoplazza.dev/zh-CN/docs/app/getting-started/create-public-app/submit-review.md): 提交 Shoplazza 应用审核：需要准备什么、首次全量人工审核与后续功能更新的区别，以及之后的流程。
- [创建私有应用](https://www.shoplazza.dev/zh-CN/docs/app/getting-started/create-private-app.md): 请商家在 Shoplazza 后台创建私有应用，让你的集成拿到调用 Open API 的 Access Token，并说明各字段含义。
- [创建支付应用](https://www.shoplazza.dev/zh-CN/docs/app/getting-started/create-payment-app.md): 支付应用让持牌支付服务商把支付方式接入 Shoplazza 结账页：跳转、iframe、直连卡支付，并给出阅读顺序。
- [Shoplazza 支付应用快速入门](https://www.shoplazza.dev/zh-CN/docs/app/getting-started/create-payment-app/getting-started.md): 上线 Shoplazza 支付应用的完整路径：成为支付合作伙伴、创建应用、获取 App ID、配置支付参数、安装与调试。
- [处理支付](https://www.shoplazza.dev/zh-CN/docs/app/getting-started/create-payment-app/processing-payment.md): Shoplazza 支付应用处理支付的流程：平台发来的请求、跳转 / iframe / 直连卡三种模式、重试策略与结果回调。
- [支付回调 API](https://www.shoplazza.dev/zh-CN/docs/app/getting-started/create-payment-app/payment-callbacks.md): Shoplazza 支付应用回传支付与退款结果的回调 API：完成支付、异步通知的请求参数与响应说明。
- [处理退款](https://www.shoplazza.dev/zh-CN/docs/app/getting-started/create-payment-app/processing-refund.md): Shoplazza 支付应用处理退款的流程：商家后台发起的退款请求、同步响应，以及最终结果的异步通知。

## 开发者工具

- [开发者工具概览](https://www.shoplazza.dev/zh-CN/docs/app/developer-tools.md): 对比 Shoplazza 应用开发的四类工具：AI Toolkit、Shoplazza CLI、App Bridge 与 OAuth SDK，按场景挑选合适的一种。
- [Shoplazza AI Toolkit 概述](https://www.shoplazza.dev/zh-CN/docs/app/developer-tools/ai-toolkit.md): Shoplazza AI Toolkit 让 AI 编码智能体用自然语言操作店铺、查阅开发者文档，由 Shoplazza CLI 做执行引擎，配合按业务域划分的 Agent Skills。
- [Shoplazza AI Toolkit 快速开始](https://www.shoplazza.dev/zh-CN/docs/app/developer-tools/ai-toolkit/get-started.md): 在 Claude Code、Codex CLI、Cursor IDE、Gemini CLI、Antigravity CLI 或 GitHub Copilot 里配置 Shoplazza AI Toolkit：安装 Shoplazza CLI、添加 Agent Skills、完成店铺认证，再发出第一条指令。
- [Agent Skills](https://www.shoplazza.dev/zh-CN/docs/app/developer-tools/ai-toolkit/skills.md): Agent Skills 是 Shoplazza AI Toolkit 按业务域划分的 SKILL.md 指引文件，讲清怎么用 /shoplazza 前缀调用、怎么选对业务域、怎么遵守安全协议。
- [安全与权限](https://www.shoplazza.dev/zh-CN/docs/app/developer-tools/ai-toolkit/safety-and-permissions.md): Shoplazza AI Toolkit 如何管住智能体的写操作：预览—复述—确认的安全协议、业务域与 OAuth 作用域，以及只读授权的用法。
- [商品](https://www.shoplazza.dev/zh-CN/docs/app/developer-tools/ai-toolkit/usage/products.md): Shoplazza AI Toolkit 中 shoplazza-products 技能的自然语言指令示例：上新商品、搜商品、改变体价格、补库存、加标签与上架。
- [折扣](https://www.shoplazza.dev/zh-CN/docs/app/developer-tools/ai-toolkit/usage/discounts.md): Shoplazza AI Toolkit 中 shoplazza-discounts 技能的自然语言指令示例：多档满减、折扣码、限时闪购，以及按安全协议下线活动。
- [订单](https://www.shoplazza.dev/zh-CN/docs/app/developer-tools/ai-toolkit/usage/orders.md): Shoplazza AI Toolkit 中 shoplazza-orders 技能的自然语言指令示例：查客户订单、发货、改运单号、按安全协议退款与标记已付款。
- [客户](https://www.shoplazza.dev/zh-CN/docs/app/developer-tools/ai-toolkit/usage/customers.md): Shoplazza AI Toolkit 中 shoplazza-customers 技能的自然语言指令示例：按邮箱或手机号查客户、新建客户、退订营销与管理收货地址。
- [店铺](https://www.shoplazza.dev/zh-CN/docs/app/developer-tools/ai-toolkit/usage/shop.md): Shoplazza AI Toolkit 中 shoplazza-shop 技能的自然语言指令示例：上传文件、加元字段、查销售分析、发博客与自定义页面、加 URL 重定向。
- [Webhook](https://www.shoplazza.dev/zh-CN/docs/app/developer-tools/ai-toolkit/usage/webhook.md): Shoplazza AI Toolkit 中 shoplazza-webhook 技能的自然语言指令示例：订阅店铺事件、查看与统计订阅、修改回调地址、删除订阅。
- [计费](https://www.shoplazza.dev/zh-CN/docs/app/developer-tools/ai-toolkit/usage/billing.md): Shoplazza AI Toolkit 中 shoplazza-billing 技能的自然语言指令示例：一次性收费、订阅收费、用量收费、查交易流水与取消订阅。
- [端到端工作流](https://www.shoplazza.dev/zh-CN/docs/app/developer-tools/ai-toolkit/end-to-end.md): 用一场夏季闪购完整演示 Shoplazza AI Toolkit：在一次会话里串起商品、折扣、订单与店铺多个技能。
- [Shoplazza AI Toolkit 排错](https://www.shoplazza.dev/zh-CN/docs/app/developer-tools/ai-toolkit/troubleshooting.md): 排查 Shoplazza AI Toolkit 的常见问题：智能体未认证、缺少 scope、技能没加载或用错业务域，以及 CLI 不认的参数。
- [无头与 CI](https://www.shoplazza.dev/zh-CN/docs/app/developer-tools/ai-toolkit/headless-ci.md): 在 CI 与后台任务里无浏览器运行 Shoplazza AI Toolkit：用 User Access Token 认证、在流水线安装、解析 JSON 输出并守住写操作。
- [Shoplazza CLI 概述](https://www.shoplazza.dev/zh-CN/docs/app/developer-tools/shoplazza-cli.md): Shoplazza CLI v2 带来了什么：三层命令体系、OAuth 2.0 认证与结构化输出，用于构建 Shoplazza 应用、主题和扩展。
- [安装 Shoplazza CLI](https://www.shoplazza.dev/zh-CN/docs/app/developer-tools/shoplazza-cli/install.md): 在 macOS、Windows 或 Linux 上通过 npm、安装脚本或 GitHub Release 二进制包安装 Shoplazza CLI，并验证版本、开启 Shell 补全。
- [Shoplazza CLI 快速上手](https://www.shoplazza.dev/zh-CN/docs/app/developer-tools/shoplazza-cli/quickstart.md): 三分钟走完 Shoplazza CLI 的安装、OAuth 店铺授权和第一条命令，再按应用或主题方向选择下一步。
- [认证](https://www.shoplazza.dev/zh-CN/docs/app/developer-tools/shoplazza-cli/authentication.md): Shoplazza CLI 的 OAuth 2.0 + PKCE 认证：浏览器登录、CI 非交互式登录、作用域选择、多店铺切换与凭证存储位置。
- [构建你的第一个应用](https://www.shoplazza.dev/zh-CN/docs/app/developer-tools/shoplazza-cli/tutorials/build-your-first-app.md): 约 15 分钟用 Shoplazza CLI 走完应用的完整生命周期：认证、创建脚手架、添加扩展、本地开发、部署并查看版本。
- [构建结账扩展](https://www.shoplazza.dev/zh-CN/docs/app/developer-tools/shoplazza-cli/tutorials/build-a-checkout-extension.md): 用 Shoplazza CLI 端到端构建 Checkout 扩展：创建项目、实时重载开发、构建、推送版本、激活并预览。
- [构建并发布主题](https://www.shoplazza.dev/zh-CN/docs/app/developer-tools/shoplazza-cli/tutorials/build-and-publish-a-theme.md): 用 Shoplazza CLI 基于 Nova 2023 创建主题脚手架，实时重载预览，拉取推送改动，再打包、分享并发布。
- [命令参考](https://www.shoplazza.dev/zh-CN/docs/app/developer-tools/shoplazza-cli/commands.md): 按主题分组的 Shoplazza CLI 命令总目录：认证、应用、主题、扩展、店铺数据、平台功能与工具命令，并附全局参数。
- [认证管理](https://www.shoplazza.dev/zh-CN/docs/app/developer-tools/shoplazza-cli/commands/auth.md): Shoplazza CLI 的 auth 命令：通过 OAuth 2.0 登录登出、查看凭证状态、列出已授权作用域，以及切换当前店铺。
- [应用开发](https://www.shoplazza.dev/zh-CN/docs/app/developer-tools/shoplazza-cli/commands/app.md): Shoplazza CLI 的 app 命令覆盖应用全生命周期：init、dev、deploy、config link、extension create、versions 以及 Function 的编译与发布。
- [主题开发](https://www.shoplazza.dev/zh-CN/docs/app/developer-tools/shoplazza-cli/commands/theme.md): Shoplazza CLI 的主题开发命令：基于 Nova 2023 创建脚手架，实时预览、拉取、推送、打包、分享预览链接，以及管理环境。
- [Checkout 扩展](https://www.shoplazza.dev/zh-CN/docs/app/developer-tools/shoplazza-cli/commands/checkout-extension.md): Shoplazza CLI 的 checkout-extension 命令：在终端完成 Checkout 扩展的脚手架、开发、构建、推送、部署与预览。
- [主题扩展](https://www.shoplazza.dev/zh-CN/docs/app/developer-tools/shoplazza-cli/commands/theme-extension.md): Shoplazza CLI 的 theme-extension 命令（别名 te）：创建、本地调试、构建、部署、关联与发布 Theme 扩展。
- [商品](https://www.shoplazza.dev/zh-CN/docs/app/developer-tools/shoplazza-cli/commands/products.md): Shoplazza CLI 的 products 命令：搜索、改价、调库存的快捷命令，以及变体、图片、集合与库存的 API 命令。
- [订单](https://www.shoplazza.dev/zh-CN/docs/app/developer-tools/shoplazza-cli/commands/orders.md): Shoplazza CLI 的 orders 命令：搜索类快捷命令，以及发货、运单号、退款、取消和物流相关的 API 命令。
- [客户](https://www.shoplazza.dev/zh-CN/docs/app/developer-tools/shoplazza-cli/commands/customers.md): Shoplazza CLI 的 customers 命令：+search 快捷命令，以及创建、更新和管理客户资料与收货地址的 API 命令。
- [折扣](https://www.shoplazza.dev/zh-CN/docs/app/developer-tools/shoplazza-cli/commands/discounts.md): Shoplazza CLI 的 discounts 命令：创建优惠码、闪购和满减活动的快捷命令，以及营销活动背后的 API 命令。
- [店铺](https://www.shoplazza.dev/zh-CN/docs/app/developer-tools/shoplazza-cli/commands/shop.md): Shoplazza CLI 的 shop 命令：+upload-file 快捷命令，以及店铺设置、内容、数据分析、Metafield、市场与语言的 API 命令。
- [计费](https://www.shoplazza.dev/zh-CN/docs/app/developer-tools/shoplazza-cli/commands/billing.md): Shoplazza CLI 的 billing 命令，用于 Shoplazza 应用向商家收费：一次性收费、周期性订阅、用量记录与交易查询。
- [Webhook](https://www.shoplazza.dev/zh-CN/docs/app/developer-tools/shoplazza-cli/commands/webhook.md): Shoplazza CLI 的 webhook 命令：创建、查询、更新、删除和统计事件订阅，把店铺事件推送到你的应用。
- [主题 API](https://www.shoplazza.dev/zh-CN/docs/app/developer-tools/shoplazza-cli/commands/themes-api.md): Shoplazza CLI 中 56 条底层主题 API 命令，用于管理主题、主题文件和版本、编辑会话、卡片、模板、应用嵌入和主题市场，并附页面编辑快捷命令。
- [原始 API](https://www.shoplazza.dev/zh-CN/docs/app/developer-tools/shoplazza-cli/commands/api.md): Shoplazza CLI 的 api rest 命令向任意 Shoplazza API 端点发送原始 HTTP 请求，用于快捷命令和 API 命令未覆盖的场景。
- [Schema 查看](https://www.shoplazza.dev/zh-CN/docs/app/developer-tools/shoplazza-cli/commands/schema.md): 用 shoplazza schema 自省 Shoplazza CLI：列出主题、深入某条命令、直接在终端查看它接受的参数。
- [Profile 管理](https://www.shoplazza.dev/zh-CN/docs/app/developer-tools/shoplazza-cli/commands/profile.md): Shoplazza CLI 的 profile 命令：为每个店铺添加 Profile、列出和查看 Profile、切换当前 Profile、修改其作用域、重命名或删除。
- [Agent Skills](https://www.shoplazza.dev/zh-CN/docs/app/developer-tools/shoplazza-cli/commands/skills.md): Shoplazza CLI 的 skills 命令：列出 CLI 二进制内置的 Agent Skills，打印某个技能的 SKILL.md 或其中的参考文件。
- [文档检索](https://www.shoplazza.dev/zh-CN/docs/app/developer-tools/shoplazza-cli/commands/docs.md): 用 shoplazza docs 检索 Shoplazza 开发者文档（文档页和接口文档），并以 Markdown 读取任意页面。
- [诊断检查](https://www.shoplazza.dev/zh-CN/docs/app/developer-tools/shoplazza-cli/commands/doctor.md): 运行 shoplazza doctor check 诊断 Shoplazza CLI 环境的配置、凭证目录、API 元数据与 Agent Skills 状态，便于在反馈问题前自查。
- [自更新](https://www.shoplazza.dev/zh-CN/docs/app/developer-tools/shoplazza-cli/commands/update.md): 运行 shoplazza update 把 Shoplazza CLI 自更新到 npm 上的最新版本，并了解可用的控制参数。
- [自动补全](https://www.shoplazza.dev/zh-CN/docs/app/developer-tools/shoplazza-cli/commands/completion.md): 用 Shoplazza CLI 生成 Shell 自动补全脚本，让终端在输入时自动补全命令、子命令和参数。
- [三层命令体系](https://www.shoplazza.dev/zh-CN/docs/app/developer-tools/shoplazza-cli/guides/command-layers.md): Shoplazza CLI 的三层命令体系：快捷命令、API 命令与原始 API，各自擅长什么，以及如何按任务挑选。
- [快捷命令](https://www.shoplazza.dev/zh-CN/docs/app/developer-tools/shoplazza-cli/guides/shortcuts.md): Shoplazza CLI 的快捷命令为高频操作预设了默认值：各主题提供哪些快捷命令、共用哪些参数，以及实际示例。
- [输出格式](https://www.shoplazza.dev/zh-CN/docs/app/developer-tools/shoplazza-cli/guides/output-formats.md): 控制 Shoplazza CLI 的输出：用 --format 选择 json、pretty、table、ndjson 或 csv，用 --jq 过滤、--fields 裁剪字段、--dry-run 预览请求。
- [配置文件](https://www.shoplazza.dev/zh-CN/docs/app/developer-tools/shoplazza-cli/guides/configuration.md): Shoplazza CLI 读取的 TOML 配置文件：shoplazza.app.toml、shoplazza.extension.toml 与 shoplazza.theme.toml、分环境配置，以及项目目录结构。
- [CI/CD 集成](https://www.shoplazza.dev/zh-CN/docs/app/developer-tools/shoplazza-cli/guides/ci-cd.md): 在 CI/CD 中使用 Shoplazza CLI：用用户访问令牌（UAT）完成非交互式认证，并参照 GitHub Actions 与 GitLab CI 示例配置流水线。
- [分页与过滤](https://www.shoplazza.dev/zh-CN/docs/app/developer-tools/shoplazza-cli/guides/pagination-and-filtering.md): 用搜索过滤、翻页参数、--fields 字段裁剪和 jq 表达式收窄 Shoplazza CLI 的结果集。
- [错误处理](https://www.shoplazza.dev/zh-CN/docs/app/developer-tools/shoplazza-cli/guides/error-handling.md): Shoplazza CLI 如何用 JSON 成功与错误信封、退出码报告失败，以及脚本或智能体该分别怎么处理。
- [配方](https://www.shoplazza.dev/zh-CN/docs/app/developer-tools/shoplazza-cli/guides/recipes.md): 即拷即用的 Shoplazza CLI 片段，用 --jq 串联多条命令：导出商品 ID、统计待处理订单、预览批量折扣、在 CI 中无人值守运行。
- [全局参数](https://www.shoplazza.dev/zh-CN/docs/app/developer-tools/shoplazza-cli/reference/global-flags.md): 适用于所有 Shoplazza CLI 命令的全局参数：--format、--profile、--no-input、--help，以及按命令提供的 --jq、--dry-run、--fields，含默认值与示例。
- [环境变量](https://www.shoplazza.dev/zh-CN/docs/app/developer-tools/shoplazza-cli/reference/environment-variables.md): Shoplazza CLI 读取的环境变量，如 SHOPLAZZA_UAT、SHOPLAZZA_CLI_PROFILE 与 SHOPLAZZA_CLI_FORMAT：在 CI 中如何设置，以及它与命令行参数、已保存登录状态的优先级。
- [退出码](https://www.shoplazza.dev/zh-CN/docs/app/developer-tools/shoplazza-cli/reference/exit-codes.md): Shoplazza CLI 返回的退出码：API、校验、认证、网络和内部错误，以及在 Shell 脚本中如何按码分支处理。
- [错误格式](https://www.shoplazza.dev/zh-CN/docs/app/developer-tools/shoplazza-cli/reference/error-format.md): Shoplazza CLI 写入 stderr 的结构化 JSON 错误结构：错误类型、字段、请求 ID，以及脚本中的程序化处理方式。
- [App 命令参考](https://www.shoplazza.dev/zh-CN/docs/app/developer-tools/shoplazza-cli/app-command.md): 旧版 Shoplazza CLI app 命令参考：应用开发的主题与命令总表，以及各条 app 命令和无前缀命令的详细说明。
- [App 命令使用指南](https://www.shoplazza.dev/zh-CN/docs/app/developer-tools/shoplazza-cli/app-command/usage-guide.md): 旧版 Shoplazza CLI app 命令组的使用指南：前置条件、从 init 到 versions list 的每条命令，以及两份 TOML 配置文件说明。
- [App 命令最佳实践](https://www.shoplazza.dev/zh-CN/docs/app/developer-tools/shoplazza-cli/app-command/best-practice.md): 按步骤走一遍旧版 Shoplazza CLI app 命令：准备环境、初始化应用、生成 extension、本地调试，最后部署发布。
- [Shoplazza CLI 排错](https://www.shoplazza.dev/zh-CN/docs/app/developer-tools/shoplazza-cli/troubleshooting.md): 排查 Shoplazza CLI 的常见故障：命令找不到、令牌过期、作用域不足、错误信封、参数不明和管道输出被污染。
- [App Bridge 概览](https://www.shoplazza.dev/zh-CN/docs/app/developer-tools/app-bridge.md): 嵌入式 Shoplazza 应用何时需要 App Bridge，这个 JavaScript 库提供的 Session Token、Backlink、SaveBar、Redirect 能力，以及安装方式。
- [App Bridge Actions 概述](https://www.shoplazza.dev/zh-CN/docs/app/developer-tools/app-bridge/actions.md): 安装 shoplazza-app-bridge 包并在 Shoplazza 应用入口文件初始化，再触发后台 action：Backlink、Contextual Save Bar 与 Redirect。
- [Contextual Save Bar](https://www.shoplazza.dev/zh-CN/docs/app/developer-tools/app-bridge/actions/contextual-save-bar.md): 在 Shoplazza 应用中显示或隐藏 App Bridge 的 Contextual Save Bar，并配置表单未保存时的保存与放弃按钮。
- [BackLink](https://www.shoplazza.dev/zh-CN/docs/app/developer-tools/app-bridge/actions/backlink.md): 在 Shoplazza 应用中用 App Bridge 的 backLink action 修改后台顶部左侧的返回按钮，包括按钮文案与点击事件。
- [Redirect](https://www.shoplazza.dev/zh-CN/docs/app/developer-tools/app-bridge/actions/redirect.md): 用 App Bridge 的 redirect action 把商家跳转到 Shoplazza 后台的其他路径，同时保持应用 iframe 的上下文。
- [Session Token](https://www.shoplazza.dev/zh-CN/docs/app/developer-tools/app-bridge/session-token.md): 嵌入式 Shoplazza 应用如何用 Session Token 鉴权：JWT 的各段结构、一分钟有效期，以及后端验签的做法。
- [API 库（SDK）](https://www.shoplazza.dev/zh-CN/docs/app/developer-tools/api-libraries.md): Go 与 PHP 版 OAuth SDK，用于处理 Shoplazza 应用的授权流程，并说明 Admin API 客户端库的推出进度。

## 扩展开发

- [扩展类型总览](https://www.shoplazza.dev/zh-CN/docs/app/extensions.md): 扩展让 Shoplazza 应用无需商家改代码就能嵌入平台：对比在线店铺与结账两类扩展载体并选择合适的一种。
- [关于在线店铺扩展](https://www.shoplazza.dev/zh-CN/docs/app/extensions/online-store.md): 在线店铺扩展通过主题扩展把 Shoplazza 应用的内容注入商家店铺前台，无需改动主题源码。
- [构建主题扩展](https://www.shoplazza.dev/zh-CN/docs/app/extensions/online-store/add-theme-extension.md): 构建 Shoplazza 主题扩展：初始化项目、创建 App Block 与 App Embed Block、在主题编辑器预览并排查问题。
- [主题扩展参考](https://www.shoplazza.dev/zh-CN/docs/app/extensions/online-store/reference.md): Shoplazza 主题扩展参考：shoplazza.extension.toml 配置、App Block、App Embed Block、snippets、schema、资源引用与多语言。
- [用 Deep Link 引导商家安装/启用扩展](https://www.shoplazza.dev/zh-CN/docs/app/extensions/online-store/deep-link.md): 构造 Deep Link，让商家一键把 Shoplazza 主题扩展放到主题编辑器的指定位置：参数、插入规则与错误码。
- [旧版主题扩展](https://www.shoplazza.dev/zh-CN/docs/app/extensions/online-store/legacy.md): 基于 shoplazza te 命令的旧版 Shoplazza 主题扩展文档存档，供尚未迁移到新流程的应用查阅。
- [旧版主题扩展入门指南](https://www.shoplazza.dev/zh-CN/docs/app/extensions/online-store/legacy/development.md): 旧版 Shoplazza 主题扩展（shoplazza te 命令）的开发与预览流程存档。
- [关于结账扩展](https://www.shoplazza.dev/zh-CN/docs/app/extensions/checkout.md): 结账扩展让 Shoplazza 应用在不接管整个结账页的前提下插入内容、读取结账上下文并隐藏原生模块。
- [构建结账扩展](https://www.shoplazza.dev/zh-CN/docs/app/extensions/checkout/add-checkout-extension.md): 用 shoplazza app 命令构建 Shoplazza 结账扩展：初始化项目、创建扩展、在结账页预览并发布。
- [结账扩展参考](https://www.shoplazza.dev/zh-CN/docs/app/extensions/checkout/extension-reference.md): Shoplazza 结账扩展机制参考：extend 函数、它渲染的 HTML 模板，以及用 deleteTarget 隐藏原生结账模块。
- [扩展点](https://www.shoplazza.dev/zh-CN/docs/app/extensions/checkout/extension-points.md): Shoplazza 结账扩展可渲染的全部扩展点：结账页与感谢页的各个插槽位置，以及传给 extend() 的名称。
- [CheckoutAPI 参考](https://www.shoplazza.dev/zh-CN/docs/app/extensions/checkout/checkout-api.md): CheckoutAPI 参考：Shoplazza 结账扩展用它读取订单、监听买家选择的变化并驱动结账页界面。
- [结账扩展场景教程](https://www.shoplazza.dev/zh-CN/docs/app/extensions/checkout/extension-recipes.md): Shoplazza 结账扩展实战场景：探测全部扩展点、隐藏原生模块、监听事件、自动填充卡上姓名、做包邮进度条。
- [旧版结账扩展](https://www.shoplazza.dev/zh-CN/docs/app/extensions/checkout/legacy.md): 基于 shoplazza checkout 命令的旧版 Shoplazza 结账扩展文档存档，供尚未迁移的应用查阅。
- [旧版结账扩展入门指南](https://www.shoplazza.dev/zh-CN/docs/app/extensions/checkout/legacy/getting-started.md): 旧版 Shoplazza 结账扩展（shoplazza checkout 命令）的开发流程存档：创建、调试、推送与发布。
- [结账扩展目标](https://www.shoplazza.dev/zh-CN/docs/app/extensions/checkout/legacy/extension-target.md): 旧版 Shoplazza 结账扩展中 deleteTarget 如何隐藏原生结账模块，以及可隐藏的 target 有哪些。
- [Function 扩展开发指南](https://www.shoplazza.dev/zh-CN/docs/app/extensions/function.md): 端到端构建 Shoplazza Function 扩展：用 JavaScript 编写购物车计价逻辑，编译为 WASM，用 CLI 发布、绑定到店铺并上线。

## 构建模块

- [构建模块概览](https://www.shoplazza.dev/zh-CN/docs/app/building-blocks.md): Shoplazza 应用对接平台的构建模块总览：认证、REST API、Webhooks、应用代理与应用计费，以及采用顺序。
- [认证概览](https://www.shoplazza.dev/zh-CN/docs/app/building-blocks/authentication.md): Shoplazza 应用的 OAuth 2.0 认证总览：授权码流程、可申请的访问权限范围，以及 HMAC 请求签名校验。
- [OAuth 鉴权](https://www.shoplazza.dev/zh-CN/docs/app/building-blocks/authentication/oauth-flow.md): 公开 Shoplazza 应用获取 Access Token 的 OAuth 2.0 授权码流程：参数说明、关键步骤、令牌刷新与存储要求。
- [HMAC 签名校验](https://www.shoplazza.dev/zh-CN/docs/app/building-blocks/authentication/signature-verification.md): 校验 Shoplazza OAuth 回调与 Webhook 请求体的 HMAC-SHA256 签名：算法步骤、参考实现与常见坑。
- [访问权限范围](https://www.shoplazza.dev/zh-CN/docs/app/building-blocks/authentication/access-scopes.md): Shoplazza 应用访问权限范围的完整清单，以及每个权限对应的 Open API 路径，方便按需申请权限。
- [Shoplazza REST API 概览](https://www.shoplazza.dev/zh-CN/docs/app/building-blocks/rest-api.md): Shoplazza REST API 概览：Admin API 能读写哪些商家数据、使用前提要求，以及各主题文档的入口。
- [API 使用方式](https://www.shoplazza.dev/zh-CN/docs/app/building-blocks/rest-api/api-usage.md): 用 Access Token 调用 Shoplazza REST API：带版本号的请求地址格式、调用示例，以及如何找到资源 ID。
- [API 版本策略](https://www.shoplazza.dev/zh-CN/docs/app/building-blocks/rest-api/versioning.md): Shoplazza Admin API 的版本策略：YYYY-MM 命名、发布节奏、可用版本、版本下线，以及迁移检查清单。
- [速率限制](https://www.shoplazza.dev/zh-CN/docs/app/building-blocks/rest-api/rate-limits.md): Shoplazza REST API 的速率限制机制：应用与店铺两个维度、漏桶算法、限流响应头，以及 429 响应的处理方式。
- [分页](https://www.shoplazza.dev/zh-CN/docs/app/building-blocks/rest-api/pagination.md): 用游标分页遍历 Shoplazza REST API 的大结果集：游标怎么工作、比 offset 分页好在哪、如何逐页取数。
- [公共参数](https://www.shoplazza.dev/zh-CN/docs/app/building-blocks/rest-api/public-parameters.md): Shoplazza REST API 所有接口共用的公共请求参数与公共响应字段，包含 Authorization 请求头与错误字段。
- [HTTP 状态码](https://www.shoplazza.dev/zh-CN/docs/app/building-blocks/rest-api/http-status.md): Shoplazza REST API 返回的 HTTP 状态码分别代表什么，以及请求失败时返回的错误内容。
- [Webhooks 概览](https://www.shoplazza.dev/zh-CN/docs/app/building-blocks/webhooks.md): Webhooks 把 Shoplazza 店铺事件实时推送给你的应用：工作方式、订阅方法与可订阅事件清单的入口。
- [Webhook 概览](https://www.shoplazza.dev/zh-CN/docs/app/building-blocks/webhooks/overview.md): Shoplazza Webhook 的完整机制：前置条件、注册订阅、推送格式与请求头、投递规则与签名校验。
- [支持的 Webhook 事件](https://www.shoplazza.dev/zh-CN/docs/app/building-blocks/webhooks/supported-webhook-events.md): Shoplazza 应用可订阅的 Webhook 事件全量清单，按资源分组，列出每个事件的 topic、所需权限与触发时机。
- [商品](https://www.shoplazza.dev/zh-CN/docs/app/building-blocks/webhooks/supported-webhook-events/products.md): products/*、procurements/*、suppliers/* 系列 Shoplazza Webhook 事件：商品、采购单与供应商发生变化时通知你的应用。
- [商品创建](https://www.shoplazza.dev/zh-CN/docs/app/building-blocks/webhooks/supported-webhook-events/products/create.md): 商品创建时触发。Shoplazza products/create Webhook 事件参考，含请求头与完整请求体字段。
- [商品更新](https://www.shoplazza.dev/zh-CN/docs/app/building-blocks/webhooks/supported-webhook-events/products/update.md): 商品更新时触发。Shoplazza products/update Webhook 事件参考，含请求头与完整请求体字段。
- [商品删除](https://www.shoplazza.dev/zh-CN/docs/app/building-blocks/webhooks/supported-webhook-events/products/delete.md): 商品删除时触发。Shoplazza products/delete Webhook 事件参考，含请求头与完整请求体字段。
- [供应商创建](https://www.shoplazza.dev/zh-CN/docs/app/building-blocks/webhooks/supported-webhook-events/products/suppliers-create.md): 供应商创建时触发。Shoplazza suppliers/create Webhook 事件参考，含请求头与完整请求体字段。
- [供应商更新](https://www.shoplazza.dev/zh-CN/docs/app/building-blocks/webhooks/supported-webhook-events/products/suppliers-update.md): 供应商更新时触发。Shoplazza suppliers/update Webhook 事件参考，含请求头与完整请求体字段。
- [供应商删除](https://www.shoplazza.dev/zh-CN/docs/app/building-blocks/webhooks/supported-webhook-events/products/suppliers-delete.md): 供应商删除时触发。Shoplazza suppliers/delete Webhook 事件参考，含请求头与完整请求体字段。
- [采购单创建](https://www.shoplazza.dev/zh-CN/docs/app/building-blocks/webhooks/supported-webhook-events/products/procurements-create.md): 采购单创建时触发。Shoplazza procurements/create Webhook 事件参考，含请求头与完整请求体字段。
- [采购单更新](https://www.shoplazza.dev/zh-CN/docs/app/building-blocks/webhooks/supported-webhook-events/products/procurements-update.md): 采购单更新时触发。Shoplazza procurements/update Webhook 事件参考，含请求头与完整请求体字段。
- [商品专辑](https://www.shoplazza.dev/zh-CN/docs/app/building-blocks/webhooks/supported-webhook-events/collections.md): collections/* 系列 Shoplazza Webhook 事件：覆盖商品专辑的创建、更新与删除，并关联对应的 Collection API。
- [商品专辑创建](https://www.shoplazza.dev/zh-CN/docs/app/building-blocks/webhooks/supported-webhook-events/collections/create.md): 商品专辑创建时触发。Shoplazza collections/create Webhook 事件参考，含请求头与完整请求体字段。
- [商品专辑更新](https://www.shoplazza.dev/zh-CN/docs/app/building-blocks/webhooks/supported-webhook-events/collections/update.md): 商品专辑更新时触发。Shoplazza collections/update Webhook 事件参考，含请求头与完整请求体字段。
- [商品专辑删除](https://www.shoplazza.dev/zh-CN/docs/app/building-blocks/webhooks/supported-webhook-events/collections/delete.md): 商品专辑删除时触发。Shoplazza collections/delete Webhook 事件参考，含请求头与完整请求体字段。
- [购物车](https://www.shoplazza.dev/zh-CN/docs/app/building-blocks/webhooks/supported-webhook-events/cart.md): cart/* 系列 Shoplazza Webhook 事件：购物车创建与更新时通知你的应用，可实时响应买家的加购行为。
- [购物车创建](https://www.shoplazza.dev/zh-CN/docs/app/building-blocks/webhooks/supported-webhook-events/cart/create.md): 购物车新增商品时触发。Shoplazza cart/create Webhook 事件参考，含请求头与完整请求体字段。
- [购物车更新](https://www.shoplazza.dev/zh-CN/docs/app/building-blocks/webhooks/supported-webhook-events/cart/update.md): 购物车商品更新时触发。Shoplazza cart/update Webhook 事件参考，含请求头与完整请求体字段。
- [订单](https://www.shoplazza.dev/zh-CN/docs/app/building-blocks/webhooks/supported-webhook-events/orders.md): orders/* 系列 Shoplazza Webhook 事件：覆盖订单从创建、支付、履约到退款、取消、完成的完整生命周期。
- [订单创建](https://www.shoplazza.dev/zh-CN/docs/app/building-blocks/webhooks/supported-webhook-events/orders/create.md): 订单创建时触发。Shoplazza orders/create Webhook 事件参考，含请求头与完整请求体字段。
- [订单更新](https://www.shoplazza.dev/zh-CN/docs/app/building-blocks/webhooks/supported-webhook-events/orders/update.md): 订单信息发生任意更新时触发。Shoplazza orders/update Webhook 事件参考，含请求头与完整请求体字段。
- [订单支付](https://www.shoplazza.dev/zh-CN/docs/app/building-blocks/webhooks/supported-webhook-events/orders/paid.md): 订单成功下单时触发（COD 除外，COD 表示支付成功）。Shoplazza orders/paid Webhook 事件参考，含请求头与完整请求体字段。
- [订单部分履约](https://www.shoplazza.dev/zh-CN/docs/app/building-blocks/webhooks/supported-webhook-events/orders/partially_fulfilled.md): 每次有商品发货但订单尚未全部发货时触发。Shoplazza orders/partially_fulfilled Webhook 事件参考，含请求头与完整请求体字段。
- [订单全部履约](https://www.shoplazza.dev/zh-CN/docs/app/building-blocks/webhooks/supported-webhook-events/orders/fulfilled.md): 订单内所有商品发货后触发。Shoplazza orders/fulfilled Webhook 事件参考，含请求头与完整请求体字段。
- [订单完成](https://www.shoplazza.dev/zh-CN/docs/app/building-blocks/webhooks/supported-webhook-events/orders/finished.md): 已支付订单走完售后流程、商品全部收货、退款退货全部完成时触发。Shoplazza orders/finished Webhook 事件参考，含请求头与完整请求体字段。
- [订单部分退款](https://www.shoplazza.dev/zh-CN/docs/app/building-blocks/webhooks/supported-webhook-events/orders/partially_refunded.md): 每次发生退款且订单金额尚未全部退还时触发。Shoplazza orders/partially_refunded Webhook 事件参考，含请求头与完整请求体字段。
- [订单退款](https://www.shoplazza.dev/zh-CN/docs/app/building-blocks/webhooks/supported-webhook-events/orders/refunded.md): 订单全额退款时触发。Shoplazza orders/refunded Webhook 事件参考，含请求头与完整请求体字段。
- [订单取消](https://www.shoplazza.dev/zh-CN/docs/app/building-blocks/webhooks/supported-webhook-events/orders/cancelled.md): 未完成订单取消时触发。Shoplazza orders/cancelled Webhook 事件参考，含请求头与完整请求体字段。
- [订单删除](https://www.shoplazza.dev/zh-CN/docs/app/building-blocks/webhooks/supported-webhook-events/orders/delete.md): 订单删除时触发。Shoplazza orders/delete Webhook 事件参考，含请求头与完整请求体字段。
- [履约](https://www.shoplazza.dev/zh-CN/docs/app/building-blocks/webhooks/supported-webhook-events/fulfillments.md): fulfillments/* 系列 Shoplazza Webhook 事件：覆盖订单发货的生命周期，包括履约创建与物流信息更新。
- [履约创建](https://www.shoplazza.dev/zh-CN/docs/app/building-blocks/webhooks/supported-webhook-events/fulfillments/create.md): 发生任意发货操作时触发。Shoplazza fulfillments/create Webhook 事件参考，含请求头与完整请求体字段。
- [履约更新](https://www.shoplazza.dev/zh-CN/docs/app/building-blocks/webhooks/supported-webhook-events/fulfillments/update.md): 物流信息更新时触发。Shoplazza fulfillments/update Webhook 事件参考，含请求头与完整请求体字段。
- [客户](https://www.shoplazza.dev/zh-CN/docs/app/building-blocks/webhooks/supported-webhook-events/customers.md): customers/* 系列 Shoplazza Webhook 事件：客户资料与客户分群发生变化时通知你的应用，并关联 Customer API。
- [客户创建](https://www.shoplazza.dev/zh-CN/docs/app/building-blocks/webhooks/supported-webhook-events/customers/create.md): C 端客户创建时触发。Shoplazza customers/create Webhook 事件参考，含请求头与完整请求体字段。
- [客户更新](https://www.shoplazza.dev/zh-CN/docs/app/building-blocks/webhooks/supported-webhook-events/customers/update.md): C 端客户更新时触发。Shoplazza customers/update Webhook 事件参考，含请求头与完整请求体字段。
- [客户删除](https://www.shoplazza.dev/zh-CN/docs/app/building-blocks/webhooks/supported-webhook-events/customers/delete.md): C 端客户删除时触发。Shoplazza customers/delete Webhook 事件参考，含请求头与完整请求体字段。
- [客户分群创建](https://www.shoplazza.dev/zh-CN/docs/app/building-blocks/webhooks/supported-webhook-events/customers/segment-create.md): C 端客户分群创建时触发。Shoplazza customers/segment_create Webhook 事件参考，含请求头与完整请求体字段。
- [客户分群更新](https://www.shoplazza.dev/zh-CN/docs/app/building-blocks/webhooks/supported-webhook-events/customers/segment-update.md): C 端客户分群更新时触发。Shoplazza customers/segment_update Webhook 事件参考，含请求头与完整请求体字段。
- [客户分群删除](https://www.shoplazza.dev/zh-CN/docs/app/building-blocks/webhooks/supported-webhook-events/customers/segment-delete.md): C 端客户分群删除时触发。Shoplazza customers/segment_delete Webhook 事件参考，含请求头与完整请求体字段。
- [应用](https://www.shoplazza.dev/zh-CN/docs/app/building-blocks/webhooks/supported-webhook-events/app.md): app/* 系列 Shoplazza Webhook 事件：应用卸载、过期、周期性与一次性收费状态更新、接近费用上限提醒，各自请求体不同。
- [应用卸载](https://www.shoplazza.dev/zh-CN/docs/app/building-blocks/webhooks/supported-webhook-events/app/uninstalled.md): 应用卸载时触发。Shoplazza app/uninstalled Webhook 事件参考，含请求头与完整请求体字段。
- [应用过期](https://www.shoplazza.dev/zh-CN/docs/app/building-blocks/webhooks/supported-webhook-events/app/expired.md): 应用过期时触发。Shoplazza app/expired Webhook 事件参考，含请求头与完整请求体字段。
- [应用一次性收费状态更新](https://www.shoplazza.dev/zh-CN/docs/app/building-blocks/webhooks/supported-webhook-events/app/purchases_one_time_update.md): 一次性收费状态更新时触发。Shoplazza app/purchases_one_time_update Webhook 事件参考，含请求头与完整请求体字段。
- [应用订阅状态更新](https://www.shoplazza.dev/zh-CN/docs/app/building-blocks/webhooks/supported-webhook-events/app/subscriptions_update.md): 周期性收费状态更新时触发。Shoplazza app/subscriptions_update Webhook 事件参考，含请求头与完整请求体字段。
- [应用订阅接近费用上限](https://www.shoplazza.dev/zh-CN/docs/app/building-blocks/webhooks/supported-webhook-events/app/subscriptions-capped.md): 使用费达到费用上限的 90% 时触发。Shoplazza app/subscriptions_approaching_capped_amount Webhook 事件参考，含请求头与完整请求体字段。
- [店铺](https://www.shoplazza.dev/zh-CN/docs/app/building-blocks/webhooks/supported-webhook-events/shop.md): shop/* 系列 Shoplazza Webhook 事件：店铺信息更新时通知你的应用，便于同步你缓存的店铺资料。
- [店铺更新](https://www.shoplazza.dev/zh-CN/docs/app/building-blocks/webhooks/supported-webhook-events/shop/update.md): 店铺信息更新时触发。Shoplazza shop/update Webhook 事件参考，含请求头与完整请求体字段。
- [店铺订阅](https://www.shoplazza.dev/zh-CN/docs/app/building-blocks/webhooks/supported-webhook-events/stores.md): stores/* 系列 Shoplazza Webhook 事件：店铺订阅发生变化时通知你的应用，当前包含 stores/subscribe 一个事件。
- [店铺订阅](https://www.shoplazza.dev/zh-CN/docs/app/building-blocks/webhooks/supported-webhook-events/stores/subscribe.md): 店铺订阅时触发。Shoplazza stores/subscribe Webhook 事件参考，含请求头与完整请求体字段。
- [应用计费概览](https://www.shoplazza.dev/zh-CN/docs/app/building-blocks/billing/overview.md): Shoplazza Billing API 能做什么：收费模式、扣款与结算、收入分成规则、应用退款与计费看板。
- [集成应用收款](https://www.shoplazza.dev/zh-CN/docs/app/building-blocks/billing/integration-guide.md): 在 Shoplazza 应用里完成向商家收费：先在开发者后台配置定价，再调用 Billing API 处理一次性、周期性与用量收费。
- [收款对象与流程](https://www.shoplazza.dev/zh-CN/docs/app/building-blocks/billing/apis-properties-and-flow.md): Shoplazza 应用计费涉及的对象与流转：一次性收费、周期性收费、用量收费、交易、退款、结算单与商家账单。
- [应用代理概览](https://www.shoplazza.dev/zh-CN/docs/app/building-blocks/app-proxy/overview.md): 应用代理（App Proxy）让 Shoplazza 应用在店铺前台域名下暴露路径：适用场景、所需权限、配置字段与创建步骤。

## 应用场景

- [结账页定制](https://www.shoplazza.dev/zh-CN/docs/app/use-cases/checkout.md): 在应用里定制 Shoplazza 结账页：在结账扩展点渲染自己的 UI，并用 CheckoutAPI 读写订单。
- [常见的结账页定制](https://www.shoplazza.dev/zh-CN/docs/app/use-cases/checkout/common-customizations.md): 每个 Shoplazza 结账扩展共用的骨架，以及各类常见改动对应的 CheckoutAPI 调用：订单自定义字段、商品行、地址表单、阻止提交和多语言。
- [结账页增删订单商品行](https://www.shoplazza.dev/zh-CN/docs/app/use-cases/checkout/modify-order-at-checkout.md): 用 Shoplazza 结账扩展和 CheckoutAPI 让买家在结账页增删运费险等增值服务商品，并处理金额变化。
- [订单与履约](https://www.shoplazza.dev/zh-CN/docs/app/use-cases/orders-and-fulfillment.md): 在应用里驱动 Shoplazza 订单全生命周期的教程合集：监听订单事件，再用 Open API 管理、发货与退款。
- [管理订单](https://www.shoplazza.dev/zh-CN/docs/app/use-cases/orders-and-fulfillment/manage-orders.md): 用 Open API 读取和管理 Shoplazza 店铺订单：列表查询、查询单个订单、更新订单与取消订单。
- [发货与履约](https://www.shoplazza.dev/zh-CN/docs/app/use-cases/orders-and-fulfillment/fulfill-orders.md): 用 Open API 在应用里给已支付的 Shoplazza 订单发货：创建履约、完成或取消履约，并回写物流单号。
- [退款与售后](https://www.shoplazza.dev/zh-CN/docs/app/use-cases/orders-and-fulfillment/refunds-and-post-sales.md): 用 Open API 处理 Shoplazza 订单退款：发起退款、查询退款记录，并读取买家发起的退货退换售后单。
- [用 Webhook 监听订单事件](https://www.shoplazza.dev/zh-CN/docs/app/use-cases/orders-and-fulfillment/listen-for-order-events.md): 订阅 Shoplazza 订单与履约 Webhook 事件，并在应用里接收、验签和分发，随订单状态变化做出响应。
- [商品管理](https://www.shoplazza.dev/zh-CN/docs/app/use-cases/product-merchandising.md): 在应用里做 Shoplazza 商品运营的教程合集：创建带变体和图片的商品、组织集合、设置库存并上架。
- [创建与更新商品](https://www.shoplazza.dev/zh-CN/docs/app/use-cases/product-merchandising/create-and-update-products.md): 用 Open API 在 Shoplazza 店铺里创建、更新、上下架和删除商品，并说明新建商品为何默认是草稿。
- [管理变体与图片](https://www.shoplazza.dev/zh-CN/docs/app/use-cases/product-merchandising/manage-variants-and-images.md): 给已有 Shoplazza 商品增删改变体与图片，并在同步价格库存时按 SKU 反查变体。
- [组织商品集合](https://www.shoplazza.dev/zh-CN/docs/app/use-cases/product-merchandising/organize-collections.md): 用 Open API 把 Shoplazza 商品归入手动集合和智能集合、往集合里加商品，并查询集合与关联记录。
- [管理库存](https://www.shoplazza.dev/zh-CN/docs/app/use-cases/product-merchandising/manage-inventory.md): 用 Open API 按位置设置和读取 Shoplazza 商品变体的库存，并理解库存项与位置之间的关系。
- [构建商品同步应用](https://www.shoplazza.dev/zh-CN/docs/app/use-cases/product-merchandising/build-product-sync-app.md): 让外部系统与 Shoplazza 商品库保持同步：安装时全量回补、订阅商品 Webhook、验签后拉取完整商品详情。
- [给购物车和订单添加自定义属性](https://www.shoplazza.dev/zh-CN/docs/app/use-cases/product-merchandising/add-custom-properties.md): 用 Ajax API 把买家在商品页填的刻字等信息带进 Shoplazza 购物车，一路带到订单，再从订单读回来。
- [按尺寸计价销售商品](https://www.shoplazza.dev/zh-CN/docs/app/use-cases/product-merchandising/sell-by-measurement.md): 用 Ajax API 的行项目属性按买家填写的尺寸给 Shoplazza 商品计价（按米卖布、按卷卖墙纸），并从订单读回。
- [用函数按商品加收附加费](https://www.shoplazza.dev/zh-CN/docs/app/use-cases/product-merchandising/add-surcharge-by-metafield.md): 用 Shoplazza cart_transform 函数把商品元字段里设置的附加费加到购物车和结账页的价格上，商品标价保持不变。

## 最佳实践

- [Shoplazza 应用最佳实践概览](https://www.shoplazza.dev/zh-CN/docs/app/best-practices.md): Shoplazza 应用送审前该遵守的最佳实践总览：安全、性能、隐私合规、本地化、无障碍与移动端适配。
- [安全](https://www.shoplazza.dev/zh-CN/docs/app/best-practices/security.md): Shoplazza 应用审核会查的安全实践：防范常见 Web 漏洞、TLS 加密、iframe 防护、安全处理令牌、校验 Webhook 签名。
- [性能](https://www.shoplazza.dev/zh-CN/docs/app/best-practices/performance.md): 让 Shoplazza 应用达到 Lighthouse 基准：后台页面加载快、OAuth 流程精简、注入店铺前台的脚本保持轻量。
- [隐私合规](https://www.shoplazza.dev/zh-CN/docs/app/best-practices/privacy-compliance.md): 在 Shoplazza 应用里合法处理商家与买家数据：最小化收集、获取同意、发布隐私政策、响应数据删除请求。
- [本地化](https://www.shoplazza.dev/zh-CN/docs/app/best-practices/localization.md): 从 Session Token 或 Shop API 读出商家语言，再把 Shoplazza 应用界面和上架信息翻译成对应语言。
- [无障碍](https://www.shoplazza.dev/zh-CN/docs/app/best-practices/accessibility.md): 让每个人都能用你的 Shoplazza 应用：键盘导航、语义化结构、表单标签、颜色对比度、媒体替代文本与触控目标尺寸。
- [移动端适配](https://www.shoplazza.dev/zh-CN/docs/app/best-practices/mobile-support.md): 商家在手机上打开后台时，Shoplazza 应用依然好用：响应式布局、小屏保留核心功能、按触控习惯设计控件。
- [不写欺骗性代码](https://www.shoplazza.dev/zh-CN/docs/app/best-practices/non-deceptive-code.md): Shoplazza 应用禁止的欺骗性做法：混淆代码、审核期间行为不一致、操纵搜索引擎或测试工具。

## 发布与运营

- [应用审核与运营](https://www.shoplazza.dev/zh-CN/docs/app/publish-and-operate.md): 提交 Shoplazza 应用之后会发生什么：审核时长、应用状态变化，以及通过审核后的运营工作。
- [应用上架规范](https://www.shoplazza.dev/zh-CN/docs/app/publish-and-operate/app-requirements.md): 所有 Shoplazza 公开应用送审时对照的上架规范：品牌、安装、引导、功能与质量、支持。
- [禁止的应用配置](https://www.shoplazza.dev/zh-CN/docs/app/publish-and-operate/app-requirements/prohibited-configurations.md): Shoplazza 应用商店不允许的应用类型，例如需要下载安装的桌面软件、高度依赖人工介入的应用。
- [安装与配置](https://www.shoplazza.dev/zh-CN/docs/app/publish-and-operate/app-requirements/installation-and-setup.md): Shoplazza 应用的安装要求：点击「添加应用」后立即走 OAuth 认证、只申请必要权限、给商家清晰的配置引导。
- [功能与质量](https://www.shoplazza.dev/zh-CN/docs/app/publish-and-operate/app-requirements/functionality-and-quality.md): Shoplazza 应用审核对功能与质量的要求：用户界面、性能、计费行为与应用状态。
- [应用性能](https://www.shoplazza.dev/zh-CN/docs/app/publish-and-operate/app-requirements/performance.md): Shoplazza 应用上架须达到的性能分数要求，以及衡量它对商家店铺前台影响的测试方法。
- [应用上架信息](https://www.shoplazza.dev/zh-CN/docs/app/publish-and-operate/app-requirements/listing.md): Shoplazza 应用上架信息的要求：功能介绍、界面展示与定价，让商家安装前就看懂这个应用。
- [应用测试用例](https://www.shoplazza.dev/zh-CN/docs/app/publish-and-operate/app-requirements/testcase.md): 提交 Shoplazza 应用时要附的测试说明该写什么，让审核人员能走通每个功能并给出准确反馈。
- [安全性与商家风险](https://www.shoplazza.dev/zh-CN/docs/app/publish-and-operate/app-requirements/security-and-merchant-risk.md): Shoplazza 应用审核会检查的安全要求，包括不得收集商家账号凭据，以及防范商家风险的规定。
- [数据与用户隐私](https://www.shoplazza.dev/zh-CN/docs/app/publish-and-operate/app-requirements/data-and-user-privacy.md): Shoplazza 应用送审须满足的数据与隐私要求：GDPR 义务、上架页附隐私政策链接，以及可存储数据的限制。
- [应用支持](https://www.shoplazza.dev/zh-CN/docs/app/publish-and-operate/app-requirements/support.md): 上架 Shoplazza 应用后的支持义务：提供联系邮箱、响应时效，以及商家可查阅的帮助文档。
- [应用审核流程](https://www.shoplazza.dev/zh-CN/docs/app/publish-and-operate/review-process.md): Shoplazza 如何审核提交的应用：审核团队检查什么、如何与你联系，以及通过或被拒之后会怎样。
- [应用审核规则](https://www.shoplazza.dev/zh-CN/docs/app/publish-and-operate/review-process/testing-your-app.md): Shoplazza 审核团队判断应用能否上架的规则：安装流程、权限申请、错误处理与上架信息的准确性。
- [常见应用被拒原因](https://www.shoplazza.dev/zh-CN/docs/app/publish-and-operate/review-process/common-app-rejections.md): Shoplazza 应用审核最常见的被拒原因，从添加应用后未立即走 OAuth 到申请多余权限，送审前逐条自查。
- [应用成功运营](https://www.shoplazza.dev/zh-CN/docs/app/publish-and-operate/app-success.md): Shoplazza 应用通过审核后该做什么：推广、评价管理与客户支持，这些直接影响安装量和被推荐的机会。
- [管理应用评价](https://www.shoplazza.dev/zh-CN/docs/app/publish-and-operate/app-success/managing-app-reviews.md): 运营 Shoplazza 应用的商家评价：评价如何影响排名、怎么邀请商家评价、负面评价如何回应。
- [支持您的应用](https://www.shoplazza.dev/zh-CN/docs/app/publish-and-operate/app-success/supporting-your-app.md): Shoplazza 应用上架后的支持责任：在上架信息中留联系方式，并在两个工作日内回复商家咨询。
- [通过 Shoplazza 社区推广应用](https://www.shoplazza.dev/zh-CN/docs/app/publish-and-operate/app-success/marketing-in-community.md): 在 Shoplazza 社区内推广应用：参与论坛、优化上架信息、利用商家反馈与口碑传播。
- [对外推广应用](https://www.shoplazza.dev/zh-CN/docs/app/publish-and-operate/app-success/external-marketing.md): 在 Shoplazza 平台之外推广已上架应用：社交媒体、邮件、视频教程、社区、线上研讨会与新闻稿。
- [禁止的应用行为](https://www.shoplazza.dev/zh-CN/docs/app/publish-and-operate/app-success/prohibited-actions.md): 可能导致 Shoplazza 应用被下架或 API 密钥被吊销的行为：损害商家体验、骚扰式营销与违反上架规范。
- [下架应用](https://www.shoplazza.dev/zh-CN/docs/app/publish-and-operate/unlist-your-app.md): Shoplazza 应用下架的两种情形：因违规被审核团队清理，或由你主动下架，以及下架后商家会看到什么。

## FAQ

- [Shoplazza 应用开发常见问题](https://www.shoplazza.dev/zh-CN/docs/app/qa.md): Shoplazza 应用开发常见问题解答：API 调用、授权、应用管理与账号管理，含问题原因与解决方案。