> 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).

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

## 概要

Transaction Control は次の API で 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="/files/967237a680c4494c22843d7c5b7efb3eb736ec59" alt=""><figcaption><p>入れ子になった上限の種類: <code>カード上限</code>, <code>最大上限</code>、および <code>セキュリティ上限</code>.</p></figcaption></figure>

* `カード上限`
  * 承認時にカードに適用されます。
  * 次によって更新できます: **エンドユーザー** （経由） **D1 SDK**).
  * 次によって更新できます: **イシュア** （経由） **D1 API**からの **イシュアのバックエンド**.
* `最大上限`
  * 上限を設定する `カード上限`.
  * は次のみが更新できます: **イシュア** （経由） **D1 API**からの **イシュアのバックエンド**.
  * A `カード上限` は対応する `最大上限`.
* `セキュリティ上限`
  * を超えることはできません。
  * リスク管理のための追加の上限を提供します。
  * 特定の期間に対してすべての支払いカテゴリにわたって適用されます。 **D1 API** または **D1 SDK**.
  * は

### には公開されていません。

更新できません。 `カウンター（現在の金額）` D1 は各構成されたカテゴリと期間について累積の `カード上限`.

<figure><img src="/files/d949f87fffe53303a72198f88a1ec2e150bea6e4" alt=""><figcaption><p>現在の金額</p></figcaption></figure>

* カウンターを維持します。承認時にカウンターを更新し、次と照合します **イシュア** カテゴリと期間ごとに追跡されるカウンター。 `カウンター（現在の金額）` は **イシュアのバックエンド** を取得できます **D1 API**.
* カウンターを維持します。承認時にカウンターを更新し、次と照合します **エンドユーザー** カテゴリと期間ごとに追跡されるカウンター。 `カウンター（現在の金額）` は **からの** を取得できます **D1 SDK**.

## を使用して

イシュアアプリケーション `カード上限` を取得できます **D1 API** または **D1 SDK**.

<figure><img src="/files/beab0c28f4d4519d9f32e7552aefbb7e098f5e01" alt=""><figcaption><p>ユーザーエクスペリエンス</p></figcaption></figure>

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

### 支出上限を取得および更新するためのハイレベルなフロー。 <a href="#using-d1-backend-api" id="using-d1-backend-api"></a>

**フロー**

<figure><img src="/files/0bad35478b4d9d9055b38cc5149e60fba2e44a2f" alt=""><figcaption><p>D1 バックエンド API でコントロールを管理する <strong>現在の上限を取得して表示する</strong>.</p></figcaption></figure>

次を使用して現在の上限を取得します [現在の上限を取得して表示する](https://thales-dis-dbp.stoplight.io/docs/d1-caas/906ogh06j4ydz-get-card-settings) カード設定を取得

**を呼び出す**

<figure><img src="/files/9ef35161c09c58b312488bce3983a37ccb64bd1d" alt=""><figcaption><p>カードの現在の支出上限構成を取得するために。 <code>カード上限</code> 支出上限を更新する <strong>を更新する</strong>.</p></figcaption></figure>

次を使用して現在の上限を取得します [を更新する](https://thales-dis-dbp.stoplight.io/docs/d1-caas/qrvewq6c0276l-update-card-limits) を使用して `カード上限` カード上限を更新 `最大上限`).

### を更新して <a href="#using-d1-backend-api" id="using-d1-backend-api"></a>

**フロー**

<figure><img src="/files/dfa2aa0b771b7950464b2d74ff2a375ec8c202fb" alt=""><figcaption><p>（構成された範囲内で） <strong>からの</strong> を取得できます <strong>D1 SDK</strong>.</p></figcaption></figure>

D1 SDK API でコントロールを管理する **D1 SDK** クライアントで現在の上限を取得する `カード上限` を使用します **エンドユーザー**.

**を呼び出す**

<figure><img src="/files/6e8ebd990343ae844dcf81d877ab775dc3e25ea9" alt=""><figcaption><p>現在の <strong>からの</strong> を取得できます <strong>D1 SDK</strong>.</p></figcaption></figure>

D1 SDK API でコントロールを管理する **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 dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

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

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.