主用与备份资金来源

每个 Fluz 账户都通过一个默认资金来源为交易提供资金，它由两个角色组成——主用银行账户和备份银行卡。系统会先扣主用；当主用无法扣款时，备份卡会介入。本页介绍资金来源的工作方式，以及如何通过 API 或在应用中查看与更改这两个角色。

角色	在应用中的显示	必须是	目的
主用	首选账户	银行账户（ACH）	默认资金来源，每笔交易优先扣款。
备份	备份卡	银行卡（借记卡 / 信用卡 / 预付卡）	当主用资金来源无法扣款时进行扣款。

每个账户在任意时刻都恰好有一个主用和一个备份。为某个角色选择新的资金来源会替换之前的选择。

资金运作方式

当用户进行消费、为虚拟卡充值或向其 Fluz 余额存入资金时，Fluz 会首先从主用资金来源扣款——默认是通过 ACH 扣款的首选银行账户。由于 ACH 可能需要数日清算（且可能失败），备份卡起到安全网的作用：

当用户通过 ACH 付款时，可能会在备份卡上为交易金额设置临时预授权。
如果 ACH 付款清算成功，该预授权会在1–7 个工作日内释放。
如果 ACH 付款未清算，则会改为扣款备份卡。

❗️ 在交易完成前，必须已备案一张备份卡 Fluz 要求提供一张有效的银行卡作为备份，以便当主用资金来源失败时仍可完成结算。若没有备份卡，依赖 ACH 的交易将无法发起。

配置主用与备份

可以通过API或Fluz 应用 / 网页端管理主用与备份的选择。为某个角色选择新的资金来源会替换该账户此前的选择。

通过 API

📘 认证与权限范围这些操作需要用户访问令牌。读取（getDefaultFundingSource）使用 LIST_PAYMENT 范围；变更（setPrimaryFundingSource、setBackupFundingSource）使用 MANAGE_PAYMENT。

读取当前默认资金来源

返回该账户的两个角色。当未设置主用银行账户时，primary 为 null；当未设置备份卡时，backup 为 null。

Query

query {
  getDefaultFundingSource {
    primary { bankAccountId accountName status lastFour }
    backup  { bankCardId lastFourDigits cardType cardStatus }
  }
}

Response

{
  "data": {
    "getDefaultFundingSource": {
      "primary": {
        "bankAccountId": "d290f1ee-6c54-4b01-90e6-d701748f0851",
        "accountName": "Chase Total Checking",
        "status": "ENABLED",
        "lastFour": "6789"
      },
      "backup": {
        "bankCardId": "16fd2706-8baf-433b-82eb-8c7fada847da",
        "lastFourDigits": "4242",
        "cardType": "CREDIT",
        "cardStatus": "ACTIVE"
      }
    }
  }
}

响应字段

字段	类型	说明
`primary`	object \| null	主用银行账户；若未设置则为 `null`。
`primary.bankAccountId`	ID	已关联银行账户的 UUID。
`primary.accountName`	string	银行账户显示名称。
`primary.status`	enum	银行账户状态（例如 `ENABLED`）。
`primary.lastFour`	string	账户号后四位。
`backup`	object \| null	备份银行卡；若未设置则为 `null`。
`backup.bankCardId`	ID	银行卡的 UUID。
`backup.lastFourDigits`	string	银行卡后四位。
`backup.cardType`	enum	卡片类型 — `DEBIT`、`CREDIT` 或 `PREPAID`。
`backup.cardStatus`	enum	卡片状态（例如 `ACTIVE`）。

👍 一次调用，双重读取相同的 DefaultFundingSource 对象也会在 getWallet { defaultFundingSource { … } } 中返回——因此你可以在列出钱包内容的同一调用中读取当前选择。

设置主用资金来源（银行账户）

Mutation

mutation {
  setPrimaryFundingSource(input: { bankAccountId: "d290f1ee-6c54-4b01-90e6-d701748f0851" }) {
    primary { bankAccountId accountName }
    backup  { bankCardId lastFourDigits }
  }
}

Response

{
  "data": {
    "setPrimaryFundingSource": {
      "primary": {
        "bankAccountId": "d290f1ee-6c54-4b01-90e6-d701748f0851",
        "accountName": "Chase Total Checking"
      },
      "backup": {
        "bankCardId": "16fd2706-8baf-433b-82eb-8c7fada847da",
        "lastFourDigits": "4242"
      }
    }
  }
}

参数	类型	必填	说明
`input.bankAccountId`	ID (UUID)	是	关联到该账户且已启用的银行账户。将成为优先扣款的资金来源。

设置备份资金来源（银行卡）

Mutation

mutation {
  setBackupFundingSource(input: { bankCardId: "16fd2706-8baf-433b-82eb-8c7fada847da" }) {
    primary { bankAccountId accountName }
    backup  { bankCardId lastFourDigits }
  }
}

Response

{
  "data": {
    "setBackupFundingSource": {
      "primary": {
        "bankAccountId": "d290f1ee-6c54-4b01-90e6-d701748f0851",
        "accountName": "Chase Total Checking"
      },
      "backup": {
        "bankCardId": "16fd2706-8baf-433b-82eb-8c7fada847da",
        "lastFourDigits": "4242"
      }
    }
  }
}

参数	类型	必填	说明
`input.bankCardId`	ID (UUID)	是	该账户上的一张处于激活状态的银行卡。将成为回退资金来源。

📘 两个变更都会返回账户的完整 DefaultFundingSource 每个变更都会在修改后返回主用 + 备份——因此一次调用即可更新其中一个角色并确认结果状态。

校验规则

bankAccountId 必须是已关联且已启用的银行账户；bankCardId 必须是在该账户上且为激活状态的银行卡。
主用必须是银行账户，备份必须是银行卡——不匹配将被拒绝。
设置某个角色会替换该账户此前的选择（任一时刻仅一个主用与一个备份）。

错误

情况	`errorName`	`code`	`statusCode`	`message`
未找到/不属于/未启用的银行账户	`InvalidBankAccount`	`BA-0001`	400	Please verify that your account is active and up-to-date and try again.
未找到/不属于/未激活的银行卡	`InvalidBankCard`	`BC-0001`	400	Looks like this bank card is not a valid card, please select a new card and try again
输入格式错误（如非 UUID）	`InvalidArguments`	`ARG-0001`	422	Invalid arguments received (not user-friendly)

Example error

{
  "errors": [
    {
      "message": "Please verify that your account is active and up-to-date and try again.",
      "extensions": {
        "errorName": "InvalidBankAccount",
        "code": "BA-0001",
        "statusCode": 400,
        "userFriendly": true
      }
    }
  ],
  "data": {
    "setPrimaryFundingSource": null
  }
}

结构化错误位于 extensions 下，以 code / errorName 为键。statusCode 是一种语义化状态（例如 400、422），承载在 extensions 中——即使发生错误，GraphQL 传输本身也会返回HTTP 200，失败信息位于 errors 数组中且 data.<field> 为 null。请通过检查 errors 数组来检测失败，而不是 HTTP 状态码。 某些错误还会携带可选的 codeNumber 和 notificationDetails 字段，userFriendly 表示 message 是否可直接展示给终端用户。

在应用 / 网页端

在网页端

从账户菜单打开账户与卡片（或访问 /accounts-and-cards）。
在页面顶部的默认资金来源部分：
- 选择管理首选账户以挑选用作默认资金来源的银行账户。
- 选择管理备份卡以挑选当首选账户无法扣款时用于扣款的银行卡。
你的选择将立即保存。

在移动端

打开菜单并点按账户与卡片。
在默认资金来源下，点按管理首选账户或管理备份卡。
从你已关联的资金来源中选择。你的选择会立即保存。

如果你尚无符合条件的资金来源，应用会提示你先添加——首选账户需要银行账户，备份则需要银行卡。

API 与应用 / 网页端的可操作项对比

任务	API	应用 / 网页端
添加、更新或删除银行卡	✓	✓
关联或移除银行账户（Plaid）	✓	✓
设置哪一个资金来源为主用 / 备份	✓	✓

参见银行卡与银行账户，了解通过 API 可用的底层资金来源操作。

资格要求与备注

主用支付方式必须是已关联的银行账户；备份必须是银行卡。
企业账户必须完成KYB 审核后，才能设置资金来源，从而设置默认资金来源。
某些资金来源可能会因特定商户或账户限额而受限，无法被选择为默认。

📘 想了解更多？与我们的专家交流以获取更多信息或申请演示。

​资金运作方式

​配置主用与备份

​通过 API

​读取当前默认资金来源

​设置主用资金来源（银行账户）

​设置备份资金来源（银行卡）

​校验规则

​错误

​在应用 / 网页端

​API 与应用 / 网页端的可操作项对比

​资格要求与备注

资金运作方式

配置主用与备份

通过 API

读取当前默认资金来源

设置主用资金来源（银行账户）

设置备份资金来源（银行卡）

校验规则

错误

在应用 / 网页端

API 与应用 / 网页端的可操作项对比

资格要求与备注