# 充值指令

在不创建 PaymentIntent 的情况下提供客户余额充值指令。

您可以在客户通过管理平台或 API 进行首笔付款之前向其显示银行账户详情。

## 创建或检索充值指令

#### 管理平台

### 创建充值指令

如何为您的客户创建充值说明：

1. 转到[客户页面](https://dashboard.stripe.com/customers)。
1. 在**支付方式**下，点击 **+** > **添加银行转账账户**。
1. 选择您要创建的银行转账账户所涉及的货币和国家/地区，然后点击**添加**。Stripe 为您的客户创建适当币种的现金余额。

### 检索充值说明

1. 转到[客户页面](https://dashboard.stripe.com/customers)。
1. 在**支付方式**下，选择现金余额的相关货币，然后点击**查看余额详情**。
1. 查看**银行转账充值说明**。

#### API

用 Customer Balance Funding Instructions API（客户余额充值指令 API）检索一组可从客户接收资金的 `financial_addresses`。为您的客户提供这些银行账户详情，以便他们可以通过任意 `supported_networks` 发起银行转账。

> 在*真实模式* (Use this mode when you’re ready to launch your app. Card networks or payment providers process payments)下，Stripe 为每个客户提供唯一一套银行转账信息。相反，在测试环境中，Stripe 向所有客户提供的都是无效的银行转账详情。与真实模式不同，这些无效的详情可能并不总是唯一。

#### 美国

```curl
curl https://api.stripe.com/v1/customers/{{CUSTOMER_ID}}/funding_instructions \
  -u "<<YOUR_SECRET_KEY>>:" \
  -d funding_type=bank_transfer \
  -d "bank_transfer[type]=us_bank_transfer" \
  -d currency=usd
```

#### 英国

```curl
curl https://api.stripe.com/v1/customers/{{CUSTOMER_ID}}/funding_instructions \
  -u "<<YOUR_SECRET_KEY>>:" \
  -d funding_type=bank_transfer \
  -d "bank_transfer[type]=gb_bank_transfer" \
  -d currency=gbp
```

#### 欧盟

对于单一欧元支付区 (SEPA) 内的充值指令，将 `bank_transfer[eu_bank_transfer][country]` 设置为  中的一个，以向客户显示本地化的 IBAN。

Stripe 针对 SEPA 国家的[银行转账费用](https://stripe.com/pricing/local-payment-methods)包含最多 1000 个虚拟银行账号 (VBAN)。如果需要 1000 个以上的 VBAN，请[联系我们](https://stripe.com/contact/sales)。

```curl
curl https://api.stripe.com/v1/customers/{{CUSTOMER_ID}}/funding_instructions \
  -u "<<YOUR_SECRET_KEY>>:" \
  -d funding_type=bank_transfer \
  -d "bank_transfer[type]=eu_bank_transfer" \
  -d "bank_transfer[eu_bank_transfer][country]=NL" \
  -d currency=eur
```

> 目前不能为西班牙 (ES) 创建新的本地化虚拟银行账号。请改为使用其他 EU VBAN 国家/地区。

#### 日本

```curl
curl https://api.stripe.com/v1/customers/{{CUSTOMER_ID}}/funding_instructions \
  -u "<<YOUR_SECRET_KEY>>:" \
  -d funding_type=bank_transfer \
  -d "bank_transfer[type]=jp_bank_transfer" \
  -d currency=jpy
```

#### MX

```curl
curl https://api.stripe.com/v1/customers/{{CUSTOMER_ID}}/funding_instructions \
  -u "<<YOUR_SECRET_KEY>>:" \
  -d funding_type=bank_transfer \
  -d "bank_transfer[type]=mx_bank_transfer" \
  -d currency=mxn
```

这些响应包含以下字段：

#### 美国

### 银行转账散列

| 字段                    | 值                         | 描述                            |
| --------------------- | ------------------------- | ----------------------------- |
| `type`                | `us_bank_transfer`        | 使用的银行转账类型。                    |
| `currency`            | `usd`                     | 银行转账支持的货币。                    |
| `country`             | `US`                      | 资金要转往的银行账户的两字母国家代码。           |
| `financial_addresses` | - `aba` 散列
  - `swift` 散列 | 金融机构地址列表。发送到任何地址的资金都将进入客户的余额。 |

### ABA 散列

| 字段                           | 值                                                                      | 描述                |
| ---------------------------- | ---------------------------------------------------------------------- | ----------------- |
| `type`                       | `aba`                                                                  | 金融机构地址类型。         |
| `supported_networks`         | - `ach`
  - `domestic_wire_us`                                         | 该地址支持的卡组织列表。      |
| `aba.account_number`         | 111222333444                                                           | ABA 账号。           |
| `aba.account_type`           | `支票账户`，`储蓄账户`                                                          | 银行账户的类型。          |
| `aba.routing_number`         | 444555666                                                              | ABA 路径号码。         |
| `aba.bank_name`              | Wells Fargo Bank, NA                                                   | 银行名称。             |
| `aba.bank_address`           | - `城市`
  - `country`
  - `第 1 行`
  - `第 2 行`
  - `postal_code`
  - `州` | 银行地址。             |
| `aba.account_holder_name`    | Powdur                                                                 | 拥有该银行账户的个人或公司的名称。 |
| `aba.account_holder_address` | - `城市`
  - `country`
  - `第 1 行`
  - `第 2 行`
  - `postal_code`
  - `州` | 拥有该银行账户的人或商家的地址。  |

### SWIFT 散列

| 字段                             | 值                                                                      | 描述                |
| ------------------------------ | ---------------------------------------------------------------------- | ----------------- |
| `type`                         | `swift`                                                                | 金融机构地址类型。         |
| `supported_networks`           | `swift`                                                                | 该地址支持的卡组织列表。      |
| `swift.account_number`         | 111222333444                                                           | SWIFT 账号。         |
| `swift.account_type`           | `支票账户`，`储蓄账户`                                                          | 银行账户的类型。          |
| `swift.swift_code`             | AAAA-BB-CC-123                                                         | SWIFT 代码。         |
| `swift.bank_name`              | Wells Fargo Bank, NA                                                   | 银行名称。             |
| `swift.bank_address`           | - `城市`
  - `country`
  - `第 1 行`
  - `第 2 行`
  - `postal_code`
  - `州` | 银行地址。             |
| `swift.account_holder_name`    | Powdur                                                                 | 拥有该银行账户的个人或公司的名称。 |
| `swift.account_holder_address` | - `城市`
  - `country`
  - `第 1 行`
  - `第 2 行`
  - `postal_code`
  - `州` | 拥有该银行账户的人或商家的地址。  |

#### 英国

### 银行转账散列

| 字段                    | 值                  | 描述                            |
| --------------------- | ------------------ | ----------------------------- |
| `type`                | `gb_bank_transfer` | 使用的银行转账类型。                    |
| `currency`            | `gbp`              | 银行转账支持的货币。                    |
| `country`             | `GB`               | 资金要转往的银行账户的两字母国家代码。           |
| `financial_addresses` | `sort_code` 散列     | 金融机构地址列表。发送到任何地址的资金都将进入客户的余额。 |

### 分类代码散列

| 字段                                 | 值                                                                      | 描述                |
| ---------------------------------- | ---------------------------------------------------------------------- | ----------------- |
| `type`                             | `sort_code`                                                            | 金融机构地址类型。         |
| `supported_networks`               | - `bacs`
  - `fps`                                                     | 该地址支持的卡组织列表。      |
| `sort_code.account_number`         | 98765432                                                               | 5 位数账号。           |
| `sort_code.sort_code`              | 200000                                                                 | 6 位数分类代码。         |
| `sort_code.bank_name`              | 巴克莱银行有限公司                                                              | 银行名称。             |
| `sort_code.bank_address`           | - `城市`
  - `country`
  - `第 1 行`
  - `第 2 行`
  - `postal_code`
  - `州` | 银行地址。             |
| `sort_code.account_holder_name`    | Powdur.                                                                | 拥有该银行账户的个人或公司的名称。 |
| `sort_code.account_holder_address` | - `城市`
  - `country`
  - `第 1 行`
  - `第 2 行`
  - `postal_code`
  - `州` | 拥有该银行账户的人或商家的地址。  |

#### 欧盟

### 银行转账散列

| 字段                    | 值                  | 描述                            |
| --------------------- | ------------------ | ----------------------------- |
| `type`                | `eu_bank_transfer` | 使用的银行转账类型。                    |
| `currency`            | `eur`              | 银行转账支持的货币。                    |
| `country`             | `NL`               | 资金要转往的银行账户的两字母国家代码。           |
| `financial_addresses` | `iban` hash        | 金融机构地址列表。发送到任何地址的资金都将进入客户的余额。 |

### IBAN 散列

| 字段                            | 值                                                                      | 描述                                            |
| ----------------------------- | ---------------------------------------------------------------------- | --------------------------------------------- |
| `type`                        | `iban`                                                                 | 金融机构地址类型。                                     |
| `supported_networks`          | `sepa`                                                                 | 该地址支持的卡组织列表。                                  |
| `iban.iban`                   | NL123456789                                                            | 客户需要付至的 IBAN。IBAN 的国家根据请求中传递的 `country` 参数选择。 |
| `iban.bic`                    | 1234                                                                   | 此 IBAN 的 BIC。                                 |
| `iban.country`                | `NL`                                                                   | 资金要转往的银行账户的两字母国家代码。                           |
| `iban.bank_name`              | 花旗银行欧洲公司                                                               | 银行名称。                                         |
| `iban.bank_address`           | - `城市`
  - `country`
  - `第 1 行`
  - `第 2 行`
  - `postal_code`
  - `州` | 银行地址。                                         |
| `iban.account_holder_name`    | Powdur.                                                                | 拥有该银行账户的个人或公司的名称。                             |
| `iban.account_holder_address` | - `城市`
  - `country`
  - `第 1 行`
  - `第 2 行`
  - `postal_code`
  - `州` | 拥有该银行账户的人或商家的地址。                              |

#### 日本

### 银行转账散列

| 字段                    | 值                  | 描述                                                       |
| --------------------- | ------------------ | -------------------------------------------------------- |
| `type`                | `jp_bank_transfer` | 使用的银行转账类型。                                               |
| `currency`            | `jpy`              | 银行转账支持的货币。                                               |
| `country`             | `JP`               | 资金要转往的银行账户的两字母国家代码。                                      |
| `financial_addresses` | `zengin` hash      | 金融机构地址列表。发送到任何地址的资金都将进入客户的余额。在日本，`zengin` 散列是列表中唯一的金融地址。 |

### Zengin 散列

| 字段                              | 值                                                                      | 描述               |
| ------------------------------- | ---------------------------------------------------------------------- | ---------------- |
| `type`                          | `zengin`                                                               | 金融机构地址类型。        |
| `supported_networks`            | `zengin`                                                               | 该地址支持的卡组织列表。     |
| `zengin.bank_code`              | 0009                                                                   | 4 位数银行代码。        |
| `zengin.bank_name`              | 三井住友銀行                                                                 | 银行名称。            |
| `zengin.bank_address`           | - `城市`
  - `country`
  - `第 1 行`
  - `第 2 行`
  - `postal_code`
  - `州` | 银行地址。            |
| `zengin.branch_code`            | 950                                                                    | 3 位数分行代码。        |
| `zengin.branch_name`            | 東京第二                                                                   | 分行名称。            |
| `zengin.account_type`           | `futsu`, `toza`                                                        | 账户类型。            |
| `zengin.account_holder_name`    | ストライプジャパン（カ　シュウノウダイコウ                                                  | 账户持有人姓名。         |
| `zengin.account_holder_address` | - `城市`
  - `country`
  - `第 1 行`
  - `第 2 行`
  - `postal_code`
  - `州` | 拥有该银行账户的人或商家的地址。 |
| `zengin.account_number`         | 1234567                                                                | 7 位数账号。          |

#### MX

### 银行转账散列

| 字段                    | 值                  | 描述                                                      |
| --------------------- | ------------------ | ------------------------------------------------------- |
| `type`                | `mx_bank_transfer` | 使用的银行转账类型。                                              |
| `currency`            | `mxn`              | 银行转账支持的货币。                                              |
| `country`             | `MX`               | 资金要转往的银行账户的两字母国家代码。                                     |
| `financial_addresses` | `spei` 散列          | 金融机构地址列表。发送到任何地址的资金都将进入客户的余额。在墨西哥，`spei` 散列是列表中唯一的金融地址。 |

### SPEI 散列

| 字段                            | 值                                                                      | 描述                |
| ----------------------------- | ---------------------------------------------------------------------- | ----------------- |
| `type`                        | `spei`                                                                 | 金融机构地址类型。         |
| `supported_networks`          | `spei`                                                                 | 该地址支持的卡组织列表。      |
| `spei.clabe`                  | 002180650612345670                                                     | 18 位 CLABE 账号。    |
| `spei.bank_code`              | 002                                                                    | 三位数银行代码。          |
| `spei.bank_name`              | BANAMEX                                                                | 银行机构的简短名称         |
| `spei.bank_address`           | - `城市`
  - `country`
  - `第 1 行`
  - `第 2 行`
  - `postal_code`
  - `州` | 银行地址。             |
| `spei.account_holder_name`    | Powdur                                                                 | 拥有该银行账户的个人或公司的名称。 |
| `spei.account_holder_address` | - `城市`
  - `country`
  - `第 1 行`
  - `第 2 行`
  - `postal_code`
  - `州` | 拥有该银行账户的人或商家的地址。  |

## 下载账户所有权确认书

有些客户可能会要求提供进一步保证，以确保他们将资金转入的账户确实是您的，因为账户可能会被列为归 Stripe 所有。为提供这种保证，您可以生成一封信函，向客户确认您对该账户的所有权。在这封信函中，Stripe 确认您是虚拟银行账户的所有者，而且该账户与您发给该客户的账户详情是相对应的。

下载账户所有权确认函：

1. 转到管理平台中的[客户页面](https://dashboard.stripe.com/customers)。

1. 选择要求进一步验证您对账户拥有所有权的客户。

1. 转到现金余额详情。该页面显示客户通过银行转账付款时必须使用的账户详情。

1. 点击此按钮，下载一封带有当天日期的 PDF 格式的确认函。
![账户所有权确认书下载按钮](https://b.stripecdn.com/docs-statics-srv/assets/vban-confirmation-letter-button.cfd3f902e44069f96d011b7fb8cba336.png)

下载账户所有权确认书