> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fluz.app/llms.txt
> Use this file to discover all available pages before exploring further.

# 概览

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

银行卡可以通过 **API**，或通过 Fluz 应用与网页版门户添加与管理。

<Note>
  **必须先将银行卡添加为备份支付方式，任何交易才能完成。**

  当用户通过 ACH 付款时，可能会在备份卡上暂时预授权本次交易金额。如果 ACH 付款清算成功，预授权会在 1–7 个工作日内释放；若未清算成功，则改为向备份卡扣款。
</Note>

***

## 你可以做什么

| 操作                                  | 变更                                                                       | 描述                          |
| ----------------------------------- | ------------------------------------------------------------------------ | --------------------------- |
| [添加银行卡](/features/add-bank-card)    | `addBankCard`                                                            | 将借记卡、信用卡或预付卡连同账单地址添加到用户账户。  |
| [更新银行卡](/features/add-bank-card)    | `updateBankCardNickname` · `updateBankCardPreferredMerchantCategoryCode` | 重命名卡片或设置其首选商户类别代码（MCC）。     |
| [删除银行卡](/features/delete-bank-card) | `deleteBankCard`                                                         | 通过将卡片状态设为 `INACTIVE` 来移除该卡。 |

所有银行卡变更都需要 `MANAGE_PAYMENT` 范围。

***

## 费用与返现卡类型会影响用户在购买中获得的实际返现率：

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

<Note>
  **借记卡获得的返现高于信用卡。**

  银行账户（ACH）不收取处理费，并获得商户的全额返现率。在用户可选择的情况下，ACH 最高，其次是借记卡，信用卡的费用最高。参见 [银行账户](/features/link-external-bank-accounts) 了解免手续费选项。
</Note>

***

## 要求**ope。** 每个银行卡变更都需要用户访问令牌上具有 `MANAGE_PAYMENT` 范围。

**账单地址。** 每张卡都必须关联一个地址。请提供新的 `billingAddress` 对象或已有的 `userAddressId`——二者择一。使用 `getUserAddresses` 查询以查找已存储的 `userAddressId`。

<Note>
  **只有个人应用可以通过 API 添加银行卡。**

  希望添加银行卡的公开可用应用需要完成 PCI 认证并提供 PCI 合规性声明。若你的应用未通过 PCI 认证，请引导用户通过 Fluz 应用或网页版门户添加银行卡。
</Note>

***

> 设定主卡、首选或备份卡，更新和删除卡片均可通过 API 完成。**选择哪个资金来源为主、首选或备份在 Fluz 控制台中管理**，并非通过 API。

***

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

```graphql theme={null}
query getWallet {
  getWallet {
    bankCards {
      bankCardId
      cardType
      lastFourDigits
      cardStatus
    }
  }
}
```

参见 [查看资金来源](/features/view-funding-sources) 获取完整字段参考。

***

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