> ## 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 添加 | 通过 App / 网页添加 | 手续费                      | 最佳返现      |
| ----------------------------------- | --------- | ------------- | ------------------------ | --------- |
| **银行账户（ACH）**                       | ✗         | ✓             | 无                        | ✓ 全额      |
| **银行卡**（借记/信用/预付）                   | ✓         | ✓             | 借记卡：–1% · 信用卡/PayPal：–3% | 借记卡 > 信用卡 |
| **PayPal / Apple Pay / Google Pay** | ✗         | ✓             | –3%                      | 较低        |
| **Fluz 余额**                         | —         | —             | 无                        | 标准        |

> 💡 **银行账户无处理费，并可获得最高返现率。** 借记卡是次优选择。信用卡、PayPal、Apple Pay 和 Google Pay 均有处理费，会降低实际返现率。

***

## 按资金来源计算的返现率

以**商户返现率 4%**，购买 200 美元礼品卡为例：

```text theme={null}
ACH / Bank Account    → 4.0%  →  $8.00
Debit Card            → 3.0%  →  $6.00  (–1% processing fee)
Credit Card           → 1.0%  →  $2.00  (–3% processing fee)
PayPal / Apple Pay    → 1.0%  →  $2.00  (–3% processing fee)
```

***

## 通过 API 与 App / 网页可执行的操作

```mermaid theme={null}
flowchart LR
    subgraph API["🔌 API"]
        A1[Add Bank Card\naddBankCard mutation]
        A2[Update Bank Card\nnickname / MCC]
        A3[Delete Bank Card]
        A4[Read all funding sources\ngetWallet query]
    end

    subgraph Web["🌐 App / Web Portal Only"]
        W1[Add Bank Account\nvia Plaid Link]
        W2[Remove Bank Account]
        W3[Add PayPal]
        W4[Add Apple Pay / Google Pay]
        W5[Set primary / preferred /\nbackup payment method]
    end
```

> 🚧 **银行卡是唯一可通过 API 添加的资金来源。** 其他资金来源管理——银行账户、PayPal、Apple Pay、Google Pay，以及支付方式偏好——必须通过 Fluz 应用或网页门户完成。

***

## 银行账户

银行账户通过 **Plaid** 关联，并通过 ACH 结算。无手续费，可获得商户的全额返现率。

**添加方式：仅限 App 或网页门户。**

![在 Fluz 应用中添加银行账户](https://downloads.intercomcdn.com/i/o/836799999/6f3ab32e045b7011dd3bd0fb/How+to+manage+and+select+a+funding+source.gif)

*添加路径：菜单 → 资金来源 → 新增 → 银行账户 → 按照 Plaid 提示操作。*

> 💡 通过同一银行登录关联的所有账户都会连接，包括储蓄账户。用户应在关联后移除储蓄账户——大多数银行不允许从储蓄账户进行支付。

***

## 银行卡

银行卡（借记、信用或预付）可通过 **API** 或通过应用与网页门户添加。

**添加方式：** `addBankCard` **变更（API）或 App / 网页门户。**

![在 Fluz 应用中添加银行卡](https://downloads.intercomcdn.com/i/o/836809654/93aa3bc1b082cff44ef2a70c/How+to+manage+and+select+a+funding+source.gif)

*在网页添加：菜单 → 账户与卡片 → 银行卡 → 新增 → 输入卡片信息和账单地址。*

通过 API，银行卡支持以下操作：

* **添加** — `addBankCard`（需要 `MANAGE_PAYMENT` 权限范围）
* **更新昵称** — `updateBankCardNickname`
* **更新首选 MCC** — `updateBankCardPreferredMerchantCategoryCode`
* **删除** — `deleteBankCard`（将状态设为 `INACTIVE`）

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

***

## PayPal / Apple Pay / Google Pay

数字钱包只能通过应用或网页门户添加。它们会产生 –3% 的处理费，作用于实际返现率——与信用卡相同。

**添加方式：仅限 App 或网页门户。API 不支持。**

> 💡 部分商户会限制接受的支付方式。某些商户可能只接受 ACH 和借记卡，并禁止信用卡和数字钱包。这体现在 `getWallet` 返回的 `blockedPaymentTypes` 字段中。

***

## 通过 API 读取资金来源

`getWallet` 查询会返回与用户账户关联的所有资金来源、其当前状态，以及任何被屏蔽的支付类型。

```graphql theme={null}
query getWallet {
  getWallet {
    bankCards { bankCardId cardType lastFourDigits cardStatus }
    bankAccounts { bankAccountId type status lastFour }
    paypalAccounts { paypalVaultId status email }
    blockedPaymentTypes
    balances {
      rewardsBalance { availableBalance }
      cashBalance { availableBalance }
    }
  }
}
```

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

<br />