Subotiz 会在结账流程、API 集成或后台管理操作中创建 客户资料，确保每一笔 订阅 与支付都能准确对应到唯一的 账单身份。客户资料通常在账单流程的早期生成，用于统一管理发票、订阅方案与支付记录，确保后续账单与订阅数据的一致性。本文将介绍客户资料的创建入口、客户类型的分配规则，以及创建过程中会收集哪些信息。
客户资料的创建方式
Subotiz 支持通过多种入口创建客户资料，适用于不同业务场景：
- 通过 API 创建：当 API 请求中包含外部客户 ID 或邮箱时，系统会新建客户资料。若仅传入 Subotiz 客户 ID 且未匹配到已有记录，则不会新建资料。
- 通过结账流程创建：当结账会话开始时，系统会根据提供的标识检查是否存在已有客户资料；若未匹配到，则会自动新建客户资料，用于记录该次账单身份。
- 通过后台导入创建：商家可通过后台的客户导入功能，使用标准化模板批量创建或更新客户资料。导入时，系统同样会基于邮箱或外部客户 ID 进行识别与匹配。详细操作请参考：客户｜客户导入
分配客户类型
客户类型由购物车内容自动决定：
- 会员：购物车中包含至少一个订阅商品时创建。
- 游客：购物车仅包含一次性商品时创建。
避免重复客户资料
Subotiz 会基于统一的优先级逻辑，判断是否应复用已有客户资料或创建新资料。只有在提供有效标识时，系统才会新建客户资料。
匹配顺序为：
- 客户 ID：仅用于查找现有客户；如未匹配，不会新建资料。
- 外部客户 ID：如未匹配到现有资料，将新建客户资料。
- 邮箱：如未匹配到现有资料，将新建客户资料。
该机制可有效避免重复客户资料，确保账单、订阅与客户身份在系统内保持一致。
收集的客户信息
只要提供了至少一个有效标识，Subotiz 即可创建客户资料，并自动收集相关联系与账单信息，来源包括结账表单、支付方式或 API 请求。 系统在创建客户资料时，会根据可获取的信息来源，自动填充以下字段：
字段 |
来源 |
|---|---|
邮箱 |
从结账表单收集或通过 API 传入 |
姓名 |
从支付方式获取（如信用卡姓名、PayPal 姓名） |
电话 |
可选，从结账表单或 API 获取 |
地址 |
可选，从支付方式或 API 获取 |
自定义信息（Metadata） |
可选，通过 API 传入 |
创建时机
- API 创建：系统在接收到有效的 API 请求时即时生成客户资料。
- 结账创建：在结账过程中，若未找到匹配的客户资料，则自动新建。
升级游客资料
当游客客户后续使用相同标识（通常为邮箱）购买订阅商品时，系统会自动将其资料升级为会员类型。升级过程中：
- 原有客户 ID 保持不变。
- 客户类型更新为「会员」。
- 若有新的有效数据（如姓名、地址），系统会自动补充缺失字段。
Subotiz 会通过客户 ID、外部客户标识或邮箱统一关联交易记录，确保客户资料在订阅与支付生命周期内保持一致。游客资料在检测到订阅行为时会自动升级，帮助商家持续维护一个干净、可靠的账单系统。