> For the complete documentation index, see [llms.txt](https://docs.payments.thalescloud.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.payments.thalescloud.io/transaction-control/ja/implement-transaction-control/implement-spending-limits-controls.md).

# 利用限度額制御を実装する

D1 API または D1 SDK を使用してカードの利用限度額を設定および管理します。

## 概要

Transaction Control は次の API を提供します **D1 API** と **D1 SDK** 次のとおりです:

* 認可時に支出上限を強制する
* カード上の支出上限を更新する
* 支出上限カウンター（現在額）を取得する

認可時に、Transaction Control は取引金額を、構成済みの各上限の累積カウンターと比較します。

取引が構成済みの `カード上限`を超えると、D1 はステータス `declined` および理由 `VELOCITY_CHECK_FAIL`:

* 参照 [すべてのカード認可オペレーションを取得](/transaction-control/ja/integrate-the-d1-api/d1-api-reference/inbound-api-to-d1/card-api.md#get-v2-issuers-issuerid-cards-cardid-authorisations-operations).
* 参照 [カード認可オペレーションを通知](/transaction-control/ja/integrate-the-d1-api/d1-api-reference/outbound-api-from-d1/card-api.md#post-notifications-d1-v2-issuers-issuerid-authorisations).

### サポートされている上限カテゴリと期間

支出上限は **イシュア** が D1 でカードプロダクトをオンボーディングするときに定義します。

特定のカードプロダクトについて、各支払いカテゴリごとに個別の上限を定義できます:

* **購入**
* **引き出し**

各カテゴリについて、次の期間に対して 1 つ以上の上限を定義できます:

* **日次**
* **週次**
* **月次**
* **年次**

週次、月次、年次の期間は `固定` または `ローリング`であり、設定によって異なります。

### 上限タイプ

D1 はネストされた上限タイプをサポートします。どのユーザーが何を変更できるかを定義します。

<figure><img src="https://2324381009-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FHmPuatDdrQt7vDstf0NP%2Fuploads%2FOh2PpLXtHOWIzCZHhowA%2Fimage.png?alt=media&amp;token=af22b8c1-185c-4a3a-9d91-af4ecd34617c" alt=""><figcaption><p>ネストされた上限タイプ: <code>カード上限</code>, <code>最大上限</code>、および <code>セキュリティ上限</code>.</p></figcaption></figure>

* `カード上限`
  * 認可時にカードに適用されます。
  * によって更新できます **エンドユーザー** （経由で **D1 SDK**).
  * によって更新できます **イシュア** （経由で **D1 API**）から **イシュアのバックエンド**.
* `最大上限`
  * 〜に上限を設定する `カード上限`.
  * によってのみ更新できます **イシュア** （経由で **D1 API**）から **イシュアのバックエンド**.
  * ある `カード上限` は対応する `最大上限`.
* `セキュリティ上限`
  * を超えることはできません。
  * 特定の期間について、すべての支払いカテゴリに適用されます。
  * 〜には公開されません **D1 API** または **D1 SDK**.
  * 更新できません。

### カウンター（現在額）

D1 は、 `現在額` カウンターを、構成済みの各カテゴリおよび期間ごとに累積的に保持します。認可時にカウンターを更新し、次と照合します `カード上限`.

<figure><img src="https://2324381009-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FHmPuatDdrQt7vDstf0NP%2Fuploads%2FqEdGPICIBXGBh0Ju0Knc%2Fimage.png?alt=media&amp;token=08a0035d-7312-4239-9971-9e9854778e93" alt=""><figcaption><p>カテゴリと期間ごとに追跡されるカウンター。</p></figcaption></figure>

* その **イシュア** は `現在額` を取得できます **イシュアのバックエンド** から **D1 API**.
* その **エンドユーザー** は `現在額` を取得できます **イシュアアプリケーション** から **D1 SDK**.

## ユーザー体験

支出上限は、カード作成時または登録時にカードプロダクトから継承されます。その後、取得および更新できます `カード上限` から **D1 API** または **D1 SDK**.

<figure><img src="https://2324381009-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FHmPuatDdrQt7vDstf0NP%2Fuploads%2FgxEvOc4BrsoptXx2ITsq%2FUX%20-%20Card%20limits.svg?alt=media&amp;token=d7fa54af-b5b4-496a-a0e1-c89744a55290" alt=""><figcaption><p>支出上限を取得および更新するための高レベルなフロー。</p></figcaption></figure>

## フロー

### D1 Backend API でコントロールを管理 <a href="#using-d1-backend-api" id="using-d1-backend-api"></a>

**現在の上限を取得して表示**

<figure><img src="https://2324381009-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FHmPuatDdrQt7vDstf0NP%2Fuploads%2FWbNDCUa5a5OEUQNLVgmn%2FFlow%20-%20Get%20and%20display%20current%20limits.svg?alt=media&amp;token=f9e40488-5508-47bc-95c7-692e1119420e" alt=""><figcaption><p>を使用して現在の上限を取得 <strong>カード設定を取得</strong>.</p></figcaption></figure>

呼び出す [カード設定を取得](/transaction-control/ja/integrate-the-d1-api/d1-api-reference/inbound-api-to-d1/card-api.md#get-v2-issuers-issuerid-cards-cardid-settings) カードの現在の支出上限設定を取得するために。

**支出上限を更新**

<figure><img src="https://2324381009-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FHmPuatDdrQt7vDstf0NP%2Fuploads%2FVoGumt31a1U5EpDhuTCH%2FFlow%20-%20Update%20spending%20limits.svg?alt=media&amp;token=d2cd77a3-fc9d-4537-9239-f55b56b6d480" alt=""><figcaption><p>更新 <code>カード上限</code> を使用して <strong>カード上限を更新</strong>.</p></figcaption></figure>

呼び出す [カード上限を更新](/transaction-control/ja/integrate-the-d1-api/d1-api-reference/inbound-api-to-d1/card-api.md#patch-v2-issuers-issuerid-cards-cardid-limits) を更新するために `カード上限` （設定された `最大上限`).

### D1 SDK API でコントロールを管理 <a href="#using-d1-backend-api" id="using-d1-backend-api"></a>

**現在の上限を取得して表示**

<figure><img src="https://2324381009-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FHmPuatDdrQt7vDstf0NP%2Fuploads%2FD1ori6Lfz7UynOY5fXFE%2FFlow%20-%20Get%20and%20display%20current%20limits-1.svg?alt=media&amp;token=f4f71ed3-79c2-4e94-9289-6503e4d98740" alt=""><figcaption><p>〜内の現在の上限を取得 <strong>イシュアアプリケーション</strong> から <strong>D1 SDK</strong>.</p></figcaption></figure>

〜を使用して **D1 SDK** 現在の `カード上限` 〜に **エンドユーザー**.

**支出上限を更新**

<figure><img src="https://2324381009-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FHmPuatDdrQt7vDstf0NP%2Fuploads%2F2Ngaa8gMPsZrv2C4FPAn%2FFlow%20-%20Update%20spending%20limits-1.svg?alt=media&amp;token=07287396-56e5-41e7-afa6-0692da8a6b2f" alt=""><figcaption><p>D1 SDK で支出上限を更新 <strong>イシュアアプリケーション</strong> から <strong>D1 SDK</strong>.</p></figcaption></figure>

〜を使用して **D1 SDK** 〜に〜させるために **エンドユーザー** 更新 `カード上限` 設定された `最大上限`.

## 設定

支出上限はカードプロダクトレベルで定義されます。 **イシュア** どの支出上限を有効にするかを選択し、既定値を設定します。既定値はカードプロダクトの通貨を使用します。

利用可能な支出上限:

| 購入       | 引き出し       |
| -------- | ---------- |
| **日次購入** | **日次引き出し** |
| **週次購入** | **週次引き出し** |
| **月次購入** | **月次引き出し** |
| **年次購入** | **年次引き出し** |

支出上限は、カード作成時または登録時にカードプロダクトから継承されます。

{% hint style="warning" %}
支出上限はカードプロダクトから継承されます。カード作成または登録後は、 **追加** または **削除** 支出上限を追加または削除することはできません。既存の上限のみを更新できます。
{% endhint %}

前述のとおり、 **エンドユーザー** （経由で **D1 SDK**）と **イシュア** （経由で **D1 API**）は更新できます `カード上限`.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.payments.thalescloud.io/transaction-control/ja/implement-transaction-control/implement-spending-limits-controls.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.