> 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/es/implement-transaction-control/implement-spending-limits-controls.md).

# Implementar controles de límites de gasto

Configurar y administrar los límites de gasto de la tarjeta mediante la API D1 o el SDK D1.

## Descripción general

Transaction Control proporciona APIs en la **API de D1** y **SDK de D1** para:

* Aplicar límites de gasto durante la autorización
* Actualizar límites de gasto en una tarjeta
* Recuperar los contadores de límites de gasto (importe actual)

Durante la autorización, Transaction Control compara el importe de la transacción con el contador acumulado para cada límite configurado.

Si una transacción supera un `límite de la tarjeta`, D1 rechaza la autorización con el estado `rechazada` y motivo `VELOCITY_CHECK_FAIL`:

* Ver [Obtener todas las operaciones de autorización de tarjeta](/transaction-control/es/integrate-the-d1-api/d1-api-reference/inbound-api-to-d1/card-api.md#get-v2-issuers-issuerid-cards-cardid-authorisations-operations).
* Ver [Notificar operaciones de autorización de tarjeta](/transaction-control/es/integrate-the-d1-api/d1-api-reference/outbound-api-from-d1/card-api.md#post-notifications-d1-v2-issuers-issuerid-authorisations).

### Categorías y períodos de límites compatibles

Los límites de gasto son definidos por el **Emisor** al incorporar un producto de tarjeta en D1.

Para un producto de tarjeta determinado, puedes definir límites independientes para cada categoría de pago:

* **Compras**
* **Retiros**

Para cada categoría, puedes definir uno o más límites para estos períodos:

* **Diario**
* **Semanal**
* **Mensual**
* **Anual**

Los períodos semanales, mensuales y anuales pueden ser `fijos` o `móviles`, según tu configuración.

### Tipos de límite

D1 admite tipos de límite anidados. Definen quién puede cambiar qué.

<figure><img src="https://1635496695-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>Tipos de límite anidados: <code>límites de tarjeta</code>, <code>límites máximos</code>, y <code>límites de seguridad</code>.</p></figcaption></figure>

* `límites de tarjeta`
  * Se aplican a la tarjeta en el momento de la autorización.
  * Pueden ser actualizados por el **Usuario final** (a través de **SDK de D1**).
  * Pueden ser actualizados por el **Emisor** (a través de **API de D1**) **backend del emisor**.
* `límites máximos`
  * Limitan el `límites de tarjeta`.
  * Solo pueden ser actualizados por el **Emisor** (a través de **API de D1**) **backend del emisor**.
  * Un `límite de la tarjeta` no puede superar su correspondiente `límite máximo`.
* `límites de seguridad`
  * Proporcionan un techo adicional para el control del riesgo.
  * Se aplican a todas las categorías de pago durante un período determinado.
  * No se exponen en la **API de D1** o **SDK de D1**.
  * No pueden actualizarse.

### Contadores (importe actual)

D1 mantiene un acumulado `importe actual` contador para cada categoría y período configurados. Actualiza el contador en el momento de la autorización y lo compara con `límites de tarjeta`.

<figure><img src="https://1635496695-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>Contadores registrados por categoría y período.</p></figcaption></figure>

* El **Emisor** puede recuperar el `importe actual` desde el **backend del emisor** usando el **API de D1**.
* El **Usuario final** puede recuperar el `importe actual` desde el **aplicación del emisor** usando el **SDK de D1**.

## Experiencia de usuario

Los límites de gasto se heredan del producto de tarjeta en el momento de creación o registro de la tarjeta. Luego puedes recuperar y actualizar `límites de tarjeta` usando el **API de D1** o **SDK de D1**.

<figure><img src="https://1635496695-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>Flujo de alto nivel para recuperar y actualizar los límites de gasto.</p></figcaption></figure>

## Flujo

### Gestionar controles con la API Backend de D1 <a href="#using-d1-backend-api" id="using-d1-backend-api"></a>

**Obtener y mostrar los límites actuales**

<figure><img src="https://1635496695-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>Recuperar los límites actuales usando <strong>Obtener configuración de la tarjeta</strong>.</p></figcaption></figure>

Llamar a [Obtener configuración de la tarjeta](/transaction-control/es/integrate-the-d1-api/d1-api-reference/inbound-api-to-d1/card-api.md#get-v2-issuers-issuerid-cards-cardid-settings) para recuperar la configuración actual de límites de gasto de una tarjeta.

**Actualizar límites de gasto**

<figure><img src="https://1635496695-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>Actualizar <code>límites de tarjeta</code> usando <strong>Actualizar límites de la tarjeta</strong>.</p></figcaption></figure>

Llamar a [Actualizar límites de la tarjeta](/transaction-control/es/integrate-the-d1-api/d1-api-reference/inbound-api-to-d1/card-api.md#patch-v2-issuers-issuerid-cards-cardid-limits) para actualizar `límites de tarjeta` (dentro del `límites máximos`).

### Gestionar controles con la API SDK de D1 <a href="#using-d1-backend-api" id="using-d1-backend-api"></a>

**Obtener y mostrar los límites actuales**

<figure><img src="https://1635496695-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>Recuperar los límites actuales en la <strong>aplicación del emisor</strong> usando el <strong>SDK de D1</strong>.</p></figcaption></figure>

Usa el **SDK de D1** para mostrar el `límites de tarjeta` al **Usuario final**.

**Actualizar límites de gasto**

<figure><img src="https://1635496695-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>Actualizar límites de gasto en la <strong>aplicación del emisor</strong> usando el <strong>SDK de D1</strong>.</p></figcaption></figure>

Usa el **SDK de D1** para permitir que el **Usuario final** actualice `límites de tarjeta` dentro del `límites máximos`.

## Configuración

Los límites de gasto se definen a nivel del producto de tarjeta. El **Emisor** selecciona qué límites de gasto habilitar y establece los valores predeterminados. Los valores predeterminados usan la moneda del producto de tarjeta.

Límites de gasto disponibles:

| Compra             | Retiro             |
| ------------------ | ------------------ |
| **Compra diaria**  | **Retiro diario**  |
| **Compra semanal** | **Retiro semanal** |
| **Compra mensual** | **Retiro mensual** |
| **Compra anual**   | **Retiro anual**   |

Los límites de gasto se heredan del producto de tarjeta en el momento de creación o registro de la tarjeta.

{% hint style="warning" %}
Los límites de gasto se heredan del producto de tarjeta. Después de la creación o el registro de la tarjeta, no puedes **añadir** o **eliminar** un límite de gasto. Solo puedes actualizar los límites existentes.
{% endhint %}

Como se explicó anteriormente, el **Usuario final** (a través de **SDK de D1**) y el **Emisor** (a través de **API de D1**) pueden actualizar `límites de tarjeta`.


---

# 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/es/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.