Skip to main content
标准托管链接流程将一切交由收件人处理：你铸造一个链接，Fluz 只有在收件人打开链接、完成验证并领取后才创建虚拟卡。 此流程反转了针对你已识别收件人的步骤。你先用 registerUser 自行注册收件人的身份和账单地址，然后用 generateVCShareLinks 并设置 shareMethod: EXISTING_USER 生成分享链接。Fluz 会在生成时就立即创建虚拟卡，而不是在领取时创建，并将其绑定到该唯一收件人。链接的投递与领取仍按常规方式进行；仅卡片创建提前。资金仍在领取时扣划，与标准流程相同——优先从 userCashBalanceId 扣除，若启用了相应功能且消费账户余额不足，则回退至你的预付款或奖励余额。
何时使用此流程而非普通分享链接
  • 你已经准确知道收件人是谁（通过用户 ID），并希望在通知他们之前就将卡片创建妥当，而不是等待他们领取。
  • 你需要严格保证只有目标收件人才能查看该链接——而不是“第一个点击的人”。
  • 你要向一批已知收件人发送，并需要收件人与卡片之间可预测的一对一映射。

​
开始之前

你需要一个 Bearer 访问令牌。两项操作均不接受 Basic auth。
用户注册默认未启用。 registerUser 是受限的 mutation——你的应用必须经 Fluz 明确批准后才能创建用户。请联系你的 Fluz 销售代表或客户经理以启用该功能。 来自未获批应用的调用将以 AUTH-0022 失败。如果收件人已经拥有 Fluz 账户，你可以跳过注册，直接使用他们现有的 recipientUserIds 调用 generateVCShareLinks。
参见认证了解如何铸造带范围的令牌。 开放式卡片演示

​
与标准流程的不同之处

标准流程见发送开放式卡片，完整领取流程见收件人体验。

​
备注与限制

  • recipientUserIds 必须引用已存在的 Fluz 用户。 如果收件人尚未注册，先用 registerUser 进行注册（本流程），或使用标准托管链接流程，让 Fluz 在领取时为其入驻。
  • recipientUserIds 的长度必须等于 quantity。 不匹配将返回验证错误且不会创建任何记录。
  • 卡片创建前移到生成时——资金划拨不会前移。 当你调用 generateVCShareLinks 时会创建虚拟卡对象并完成收件人绑定，但资金仍在领取时扣划，与标准流程相同：先从 userCashBalanceId 扣除，若设置了 usePrepaymentBalance / useRewardsBalance 且消费账户不足，则回退至你的预付款或奖励余额。
  • 注册权限按应用与环境分别授予。 为预发环境授予的权限不会继承到生产环境。参见部署到生产。
  • 绝不要在预发环境注册真实用户。 参见预发与正式。

​
后续步骤

发送开放式卡片

标准流程——生成链接并让 Fluz 在领取时发行卡片。

收件人体验

收件人在打开并领取托管链接时会看到什么。

注册客户

registerUser 的完整参考，包括错误处理与回退模式。