# Issuing の支出管理

Issuing を使用し、カードおよびカード保有者にルールを設定して支出を管理する方法をご紹介します。

支出コントロールを使用すると、[マーチャントカテゴリー](https://docs.stripe.com/issuing/categories.md) (ベーカリーなど)、[国](https://docs.stripe.com/api/issuing/authorizations/object.md#issuing_authorization_object-merchant_data-country)、[マーチャント ID](https://docs.stripe.com/api/issuing/authorizations/object.md#issuing_authorization_object-merchant_data-network_id)、[カードの提示状況](https://docs.stripe.com/api/issuing/authorizations/object.md#issuing_authorization_object-card_presence)をブロックしたり、認証ごとや月ごとの支出上限を設定したりできます。これらは、[カード](https://docs.stripe.com/api/issuing/cards/object.md#issuing_card_object-spending_controls)と[カード会員](https://docs.stripe.com/api/issuing/cardholders/object.md#issuing_cardholder_object-spending_controls)の作成時に `spending_controls` パラメーターを設定するか、後から更新することで適用できます。

> 加盟店 ID の支出管理はプライベートプレビューです。参加するには、発行ユーザーである必要があります。詳細の確認やアクセスのリクエストについては、[Stripe にお問い合わせ](https://stripe.com/contact)ください。

次の `spending_controls` パラメータを設定できます。

| パラメーター | 型 | 説明 |
| --- | --- | --- |
| `allowed_categories` | 配列 | オーソリを許可する[カテゴリー](https://docs.stripe.com/issuing/categories.md)のリスト。これ以外のカテゴリーはすべてブロックされます。 |
| `blocked_categories` | 配列 | オーソリを拒否する[カテゴリー](https://docs.stripe.com/issuing/categories.md)のリスト。これ以外のカテゴリーはすべて許可されます。 |
| `spending_limits` | 配列 | 金額ベースのルールを指定する[オブジェクト](https://docs.stripe.com/issuing/controls/spending-controls.md#spending-limits)のリスト。 |
| `allowed_merchant_countries` | 配列 | オーソリを許可する加盟店の[国](https://docs.stripe.com/api/issuing/authorizations/object.md#issuing_authorization_object-merchant_data-country)のリスト。その他すべての国からのオーソリはブロックされます。 |
| `blocked_merchant_countries` | 配列 | オーソリをブロックする加盟店の[国](https://docs.stripe.com/api/issuing/authorizations/object.md#issuing_authorization_object-merchant_data-country)のリスト。その他すべての国からのオーソリは許可されます。 |
| `allowed_card_presences` | 配列 | 許可される[カードの提示状況](https://docs.stripe.com/api/issuing/authorizations/object.md#issuing_authorization_object-card_presence)のリストです。それ以外のカード提示状況の認証はブロックされます。 |
| `blocked_card_presences` | 配列 | ブロックされる[カードの提示状況](https://docs.stripe.com/api/issuing/authorizations/object.md#issuing_authorization_object-card_presence)のリストです。それ以外のカード提示状況の認証は許可されます。 |

支出管理は、[リアルタイムのオーソリ](https://docs.stripe.com/issuing/controls/real-time-authorizations.md)の前に実行され、`issuing_authorization.request` の送信前に購入を拒否できるため、結果として `issuing_authorization.created` イベントが拒否されます。

## 利用限度額

利用限度額ルールにより、カテゴリに対する所定期間の支出総額が制限されます。

`spending_controls` の `spending_limits` パラメータは、次の構造の一連の仕様です。

| プロパティ | 型 | 説明 |
| --- | --- | --- |
| `amount` | 整数 | カードの通貨での最大支出額。他の通貨での金額は、この管理項目の評価時にカードの通貨に換算されます。この金額は、カードの通貨と[通貨の最小単位](https://docs.stripe.com/currencies.md#zero-decimal)で表されます。 |
| `interval` | 列挙型 | 金額の適用期間。指定できる値については、[カードの spending_controls](https://docs.stripe.com/api/issuing/cards/object.md#issuing_card_object-spending_controls-spending_limits-interval) をご覧ください。日付基準の期間はすべて UTC の0:00 に開始します。 |
| `categories` | 配列 (オプション) | この限度額を適用する[カテゴリー](https://docs.stripe.com/issuing/categories.md)のリスト。このフィールドを省略すると、限度額はすべてのカテゴリーに適用されます。 |

Stripe は自動的に次の制限を適用します。無効にするには、[ サポートに連絡 ](https://support.stripe.com/contact/login) してください。

- `spending_limits` を設定しない場合、1 日あたりのデフォルトの利用限度額 500 USD が新しく作成されたカードに適用されます。
- 設定したカードの利用限度額に加えて、設定できないデフォルトの利用限度額 10000 USD も各承認に適用されます。

支出額の集計は、ベストエフォート方式で行われます。支出額が生成されてから集計されるまでの間に最大 30 秒の遅延が発生する場合があります。

カードの利用限度額は、そのカードが置き換えるすべてのカードに適用されます (つまり、その [replacement_for](https://docs.stripe.com/api/issuing/cards/object.md#issuing_card_object-replacement_for) カードや_その_カードの `replacement_for` カードなど)。カード会員の利用限度額は、すべてのカードに適用されます。

各利用限度額は、独自のカテゴリにのみ適用されます。利用限度額自体は、カテゴリをブロックしないため、特定の事業形態への支出を制限するには、`allowed_categories` または `blocked_categories` と組み合わせて使用する必要があります。

カード保有者の利用限度額に重複がある場合 (たとえば、そのカードのオーソリ当たり 100 USD と 50 USD など)、最も厳しい支出管理が適用されます。

追加のチップや手数料を[後から登録](https://docs.stripe.com/issuing/purchases/transactions.md?issuing-capture-type=over_capture)できるため、利用限度額を超過することがあります。

## 例

以下の例では、カードおよびカード保有者に対してさまざまな支出管理を使用する方法を示します。

#### API

### あるカード会員が持つすべてのカードに対して月次の利用限度額を設定する

```curl
curl https://api.stripe.com/v1/issuing/cardholders/{{ISSUINGCARDHOLDER_ID}} \
  -u "<<YOUR_SECRET_KEY>>:" \
  -d "spending_controls[spending_limits][0][amount]=300000" \
  -d "spending_controls[spending_limits][0][interval]=monthly"
```

### カードの支出額と使用可能カテゴリを制限する

```curl
curl https://api.stripe.com/v1/issuing/cards/{{ISSUINGCARD_ID}} \
  -u "<<YOUR_SECRET_KEY>>:" \
  -d "spending_controls[allowed_categories][0]=car_rental_agencies" \
  -d "spending_controls[spending_limits][0][amount]=8000" \
  -d "spending_controls[spending_limits][0][interval]=per_authorization"
```

### 特定のカテゴリーに対するカードの週単位の支出額を制限

```curl
curl https://api.stripe.com/v1/issuing/cards/{{ISSUINGCARD_ID}} \
  -u "<<YOUR_SECRET_KEY>>:" \
  -d "spending_controls[spending_limits][0][amount]=4000" \
  -d "spending_controls[spending_limits][0][interval]=weekly" \
  -d "spending_controls[spending_limits][0][categories][0]=fast_food_restaurants"
```

### カードの提示状況を制限

```curl
curl https://api.stripe.com/v1/issuing/cards/{{ISSUINGCARD_ID}} \
  -u "<<YOUR_SECRET_KEY>>:" \
  -d "spending_controls[blocked_card_presences][]=not_present"
```

#### ダッシュボード

[ダッシュボード](https://dashboard.stripe.com/test/issuing/overview)から支出管理にアクセスし、カード保有者に支出管理を設定して、保有するすべてのカードに管理を適用するか、特定のカードに管理を適用するかを選択できます。

1. [ダッシュボード](https://dashboard.stripe.com/test/issuing/overview)で、カードまたはカード会員の詳細ページに移動し、利用上限を確認します。
2. 利用上限を編集するには、**編集**をクリックして利用上限モーダルを開き、変更を加えます。
3. 変更を加えたら、**変更を保存**をクリックします。