> 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-domain-controls.md).

# Implementar controles de dominio

## Descripción general

El servicio Transaction Control le permite aplicar y actualizar los controles de dominio de una tarjeta.

Use la **API de D1** o **SDK de D1** para:

* Compruebe los controles de dominio de una tarjeta durante la autorización.
* Actualice los controles de dominio de una tarjeta en tiempo real.

### Qué sucede durante la autorización

Durante la autorización, D1 evalúa los controles de dominio configurados de la tarjeta. Si alguna comprobación falla, D1 rechaza la autorización con `DOMAIN_CONTROL_FAIL`.

* Consulte [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).
* Consulte [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).

Para mejorar la experiencia del usuario final, configure notificaciones en tiempo real para la **aplicación del emisor** (en la app) y/o la **backend del emisor**.

### Controles de dominio compatibles <a href="#domain-control-list" id="domain-control-list"></a>

D1 admite los siguientes controles de dominio para una tarjeta:

| Nombre del control        | Descripción                                         | Tipo de propiedad | Opcional |
| ------------------------- | --------------------------------------------------- | ----------------- | -------- |
| **Pago en línea**         | Pagos de comercio electrónico (tarjeta no presente) | Booleano          | No       |
| **Banda magnética**       | Transacciones con banda magnética                   | Booleano          | Sí       |
| **Retiro**                | Retiros de efectivo                                 | Booleano          | Sí       |
| **Sin contacto**          | Transacciones sin contacto                          | Booleano          | Sí       |
| **Pago en el extranjero** | Pagos transfronterizos                              | Booleano          | No       |
| **Geografía por país**    | Permitir pagos solo en los países seleccionados     | Lista de países   | No       |
| **Geografía por región**  | Permitir pagos solo en las regiones seleccionadas   | Lista de regiones | No       |
| **Moneda**                | Bloquear pagos en las monedas seleccionadas         | Lista de monedas  | No       |
| **Comercio para adultos** | Bloquear categorías de comercios para adultos       | Booleano          | No       |
| **Comercio de apuestas**  | Bloquear categorías de comercios de apuestas        | Booleano          | No       |
| **Comercio de riesgo**    | Bloquear categorías de comercios de riesgo          | Booleano          | No       |

### Controles obligatorios frente a opcionales

Controles marcados **Opcional = No** deben definirse en el producto de tarjeta.

Controles marcados **Opcional = Sí** son compatibles, pero opcionales. Si no los define en el producto de tarjeta, no podrá actualizarlos más adelante a nivel de tarjeta.

### Grupos de categorías de comercios

D1 proporciona una configuración predeterminada en [Grupo de categorías de comercios - configuración predeterminada](/transaction-control/es/implement-transaction-control/implement-domain-controls/default-merchant-types.md).

El emisor puede redefinir los **Apuestas**, **Adulto**, y **De riesgo** grupos con el **equipo de entrega de Thales**.

## Experiencia de usuario

<figure><img src="https://1635496695-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FHmPuatDdrQt7vDstf0NP%2Fuploads%2F9hPGvGjJUqNlsIZBNmfG%2FUX%20-%20Card%20limits.svg?alt=media&amp;token=be1687b8-302f-491f-b95d-8d388246a1d6" alt=""><figcaption><p>Ejemplo de experiencia del usuario final para los controles de dominio.</p></figcaption></figure>

## Flujo

Los controles de dominio se heredan del producto de tarjeta. Recupérelos y actualícelos mediante la **API de backend de D1** o la **SDK de D1**.

Solo puede gestionar los controles de dominio que estén habilitados en el producto de tarjeta.

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

Use la API de D1 para gestionar los controles de dominio de una tarjeta desde el backend del emisor.

#### Recuperar la configuración actual

<figure><img src="https://1635496695-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FHmPuatDdrQt7vDstf0NP%2Fuploads%2F0ZiDhrYpb33rQVHzrS4A%2FFlow%20-%20Retrieve%20current%20settings.svg?alt=media&amp;token=02ea71df-a74a-4045-9173-6026de335228" alt=""><figcaption><p>Recuperar la configuración actual de los controles de dominio (backend del emisor).</p></figcaption></figure>

Use [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 los controles de dominio.

#### Actualizar la configuración

<figure><img src="https://1635496695-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FHmPuatDdrQt7vDstf0NP%2Fuploads%2FqFu1eoxZOygYx2SO8pRW%2FFlow%20-%20Update%20settings.svg?alt=media&amp;token=faa7af3f-c06a-41aa-ad53-f5b4d14df207" alt=""><figcaption><p>Actualizar la configuración de los controles de dominio (backend del emisor).</p></figcaption></figure>

Use [Actualizar configuración de controles 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-controls) para actualizar la configuración de los controles.

### Gestionar controles con el SDK de D1 <a href="#using-d1-sdk" id="using-d1-sdk"></a>

Los usuarios finales pueden ver y actualizar los controles de la tarjeta desde la aplicación del emisor usando el SDK de D1. Consulte [Controles de tarjeta en la app](/transaction-control/es/implement-transaction-control/implement-domain-controls/manage-in-app-card-controls.md).

#### Recuperar la configuración actual

<figure><img src="https://1635496695-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FHmPuatDdrQt7vDstf0NP%2Fuploads%2FMQoMu6Pa3Wzqd7baqE7B%2FFlow%20-%20Retrieve%20current%20settings%20-2.svg?alt=media&amp;token=dbd6b2ef-1d47-416a-aaaf-c591400b624a" alt=""><figcaption><p>Recuperar la configuración actual de los controles de dominio (aplicación del emisor).</p></figcaption></figure>

#### Actualizar la configuración

<figure><img src="https://1635496695-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FHmPuatDdrQt7vDstf0NP%2Fuploads%2FiMqHapxXfTDuTuMMqwYx%2FFlow%20-%20Update%20spending%20limits.svg?alt=media&amp;token=9c688a29-3690-4318-a48c-5443d7624c8b" alt=""><figcaption><p>Actualizar la configuración de los controles de dominio (aplicación del emisor).</p></figcaption></figure>

## Configuración

Defina controles de dominio predeterminados en el producto de tarjeta.

Las tarjetas heredan estos controles de dominio cuando una tarjeta se crea o registra en D1.

Si no define un control opcional en el producto de tarjeta, no podrá actualizar ese control más adelante a nivel de tarjeta.

#### Geografía por región

Consulte [Regiones compatibles](#domain-control-list) para las regiones compatibles y sus países asociados.


---

# 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-domain-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.