> 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

## Resumen

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

* Hacer cumplir límites de gasto durante la autorización
* Actualizar límites de gasto en una tarjeta
* Recuperar contadores de límite de gasto (monto actual)

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

Si una transacción excede un `límite de tarjeta`, D1 rechaza la autorización con el estado `rechazado` y la razón `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 periodos de límite compatibles

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

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

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

Para cada categoría, puede definir uno o más límites para estos periodos:

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

Los periodos semanales, mensuales y anuales pueden ser `fijos` o `rodantes`, según su configuración.

### Tipos de límite

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

<figure><img src="/files/a7b21c6826eedae83528d69c4a2178fcd63f39b5" 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** (vía **SDK D1**).
  * Pueden ser actualizados por el **Emisor** (vía **API D1**) desde el **backend del Emisor**.
* `límites máximos`
  * Limitar el `límites de tarjeta`.
  * Solo pueden ser actualizados por el **Emisor** (vía **API D1**) desde el **backend del Emisor**.
  * Un `límite de tarjeta` no puede exceder su correspondiente `límite máximo`.
* `límites de seguridad`
  * Proporcionan un techo adicional para el control de riesgos.
  * Se aplican a través de todas las categorías de pago para un periodo dado.
  * No se exponen en el **API D1** o **SDK D1**.
  * No pueden ser actualizados.

### Contadores (monto actual)

D1 mantiene un `contador de` monto actual `límites de tarjeta`.

<figure><img src="/files/5825c515022c0280846c0ca7c2242933d5d41e29" alt=""><figcaption><p>acumulado para cada categoría y periodo configurados. Actualiza el contador en el momento de la autorización y lo compara con</p></figcaption></figure>

* Contadores rastreados por categoría y periodo. **Emisor** El `contador de` puede recuperar el **backend del Emisor** desde el **API D1**.
* Contadores rastreados por categoría y periodo. **Usuario final** El `contador de` puede recuperar el **usando el** desde el **SDK D1**.

## Aplicación del Emisor

Experiencia de usuario `límites de tarjeta` desde el **API D1** o **SDK D1**.

<figure><img src="/files/459aa035f45d9cdf67073dbc1e74b179403d17e4" alt=""><figcaption><p>Los límites de gasto se heredan del producto de tarjeta en el momento de la creación o registro de la tarjeta. Luego puede recuperar y actualizar</p></figcaption></figure>

## Flujo de alto nivel para recuperar y actualizar los límites de gasto.

### Flujo <a href="#using-d1-backend-api" id="using-d1-backend-api"></a>

**Administrar controles con la API Backend de D1**

<figure><img src="/files/4df76509624dd32d5cf2477f90043d6f0d701c3e" alt=""><figcaption><p>Obtener y mostrar límites actuales <strong>Recuperar límites actuales usando</strong>.</p></figcaption></figure>

Obtener configuración de tarjeta [Recuperar límites actuales usando](https://thales-dis-dbp.stoplight.io/docs/d1-caas/906ogh06j4ydz-get-card-settings) Llame a

**para recuperar la configuración actual de límites de gasto para una tarjeta.**

<figure><img src="/files/cf5d8e1e8654ec8a5426c815f550d8fd2f1cd0fc" alt=""><figcaption><p>Actualizar límites de gasto <code>límites de tarjeta</code> Actualizar <strong>usando</strong>.</p></figcaption></figure>

Obtener configuración de tarjeta [usando](https://thales-dis-dbp.stoplight.io/docs/d1-caas/qrvewq6c0276l-update-card-limits) Actualizar límites de tarjeta `límites de tarjeta` para actualizar `límites máximos`).

### (dentro del <a href="#using-d1-backend-api" id="using-d1-backend-api"></a>

**Administrar controles con la API Backend de D1**

<figure><img src="/files/2c33f81c84bbc2bf4399695cf6f117ea5624f990" alt=""><figcaption><p>Administrar controles con la API SDK de D1 <strong>usando el</strong> desde el <strong>SDK D1</strong>.</p></figcaption></figure>

Recuperar límites actuales en el **SDK D1** Use el `límites de tarjeta` para mostrar los **Usuario final**.

**para recuperar la configuración actual de límites de gasto para una tarjeta.**

<figure><img src="/files/71f53d6f2d466e86e7617982bc707e99073104a3" alt=""><figcaption><p>actuales en el <strong>usando el</strong> desde el <strong>SDK D1</strong>.</p></figcaption></figure>

Recuperar límites actuales en el **SDK D1** Actualizar límites de gasto en el **Usuario final** para permitir que el `límites de tarjeta` actualice `límites máximos`.

## dentro del

Configuración **Emisor** Los límites de gasto se definen a nivel del producto de tarjeta. El

selecciona qué límites de gasto habilitar y establece 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

{% hint style="warning" %}
Los límites de gasto se heredan del producto de tarjeta en el momento de la creación o registro de la tarjeta. **Los límites de gasto se heredan del producto de tarjeta. Después de la creación o el registro de la tarjeta, no puede** o **agregar** eliminar
{% endhint %}

un límite de gasto. Solo puede actualizar límites existentes. **Usuario final** (vía **SDK D1**Como se explicó arriba, el **Emisor** (vía **API D1**) y el `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 dynamically by asking a question.

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

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

The question should be specific, self-contained, and written in natural language.
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.
