管理已关联的银行卡

银行卡（借记卡、信用卡或预付卡）是在 Fluz 上最灵活的资金来源，也是唯一可通过编程方式添加的资金来源。银行卡用于支付礼品卡购买、为虚拟卡交易提供资金、向你的 Fluz 余额存款，并作为其他支付方式所需的备用支付方式。可以通过 API 或通过 Fluz 应用与网页门户添加和管理银行卡。

必须先将银行卡添加为备用支付方式，任何交易才能完成。当用户通过 ACH 支付时，可能会在备用卡上对交易金额进行临时预授权。如果 ACH 付款结清，预授权会在 1–7 个工作日内释放；如果未结清，则会改为向备用卡扣款。

你可以做什么

操作	Mutation	描述
添加银行卡	`addBankCard`	将借记卡、信用卡或预付卡与用户账户绑定，并附带账单地址。
更新银行卡	`updateBankCardNickname` · `updateBankCardPreferredMerchantCategoryCode`	重命名卡片或设置其首选商户类别码（MCC）。
删除银行卡	`deleteBankCard`	通过将卡片状态设置为 `INACTIVE` 来移除卡片。

所有银行卡相关的 mutation 都需要 MANAGE_PAYMENT scope。

费用与返现卡片类型会影响用户在一次购买中获得的有效返现率：

卡片类型	处理费	相对返现
借记卡	–1%	更高
信用卡	–3%	更低
预付卡	因卡而异	因卡而异

借记卡的返现高于信用卡。银行账户（ACH）不收取处理费，并获得完整的商户返现率。若用户可选择，ACH 最高，其次是借记卡，信用卡费用最高。无手续费选项见银行账户。

要求权限。每个银行卡相关的 mutation 都需要用户访问令牌具备 `MANAGE_PAYMENT` scope。

账单地址。 每张卡必须关联一个地址。提供新的 billingAddress 对象或现有的 userAddressId 二选一，不可同时提供。使用 getUserAddresses 查询以查找已存储的 userAddressId。

只有个人应用可以通过 API 添加银行卡。希望添加银行卡的公开应用需要完成 PCI 认证并提交 PCI 合规性证明。如果你的应用未通过 PCI 认证，请引导用户通过 Fluz 应用或网页门户添加银行卡。

通过 API 可设置主卡、首选卡或备用卡，以及更新和删除卡片。选择哪个资金来源作为主卡、首选或备用在 Fluz 控制台中管理，而非通过 API。

读取银行卡使用 `getWallet` 查询可返回用户账户上的所有银行卡，以及其类型、末四位和当前状态。

query getWallet {
  getWallet {
    bankCards {
      bankCardId
      cardType
      lastFourDigits
      cardStatus
    }
  }
}

完整字段参考见查看资金来源。

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

​你可以做什么

​费用与返现卡片类型会影响用户在一次购买中获得的有效返现率：

​要求权限。 每个银行卡相关的 mutation 都需要用户访问令牌具备 MANAGE_PAYMENT scope。

​读取银行卡使用 getWallet 查询可返回用户账户上的所有银行卡，以及其类型、末四位和当前状态。

你可以做什么

费用与返现卡片类型会影响用户在一次购买中获得的有效返现率：

要求权限。每个银行卡相关的 mutation 都需要用户访问令牌具备 `MANAGE_PAYMENT` scope。

读取银行卡使用 `getWallet` 查询可返回用户账户上的所有银行卡，以及其类型、末四位和当前状态。