> 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

## Resumen

El servicio de Control de Transacciones le permite aplicar y actualizar controles de dominio para una tarjeta.

Use el **API D1** o **SDK D1** para:

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

### Qué ocurre durante la autorización

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

* Ver [Obtener todas las operaciones de autorización de tarjetas](/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 tarjetas](/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 hacia la **aplicación del emisor** (en la aplicación) y/o el **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 por comercio electrónico (tarjeta no presente)  | Booleano          | No       |
| **Pista magnética**               | Transacciones con pista 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 países seleccionados           | Lista de países   | No       |
| **Geografía por región**          | Permitir pagos solo en regiones seleccionadas         | Lista de regiones | No       |
| **Moneda**                        | Bloquear pagos en monedas seleccionadas               | Lista de monedas  | No       |
| **Comerciante para adultos**      | Bloquear categorías de comerciantes para adultos      | Booleano          | No       |
| **Comerciante de juegos de azar** | Bloquear categorías de comerciantes de juegos de azar | Booleano          | No       |
| **Comerciante de riesgo**         | Bloquear categorías de comerciantes de riesgo         | Booleano          | No       |

### Controles obligatorios vs opcionales

Los controles marcados **Opcional = No** deben definirse en el Producto de Tarjeta.

Los controles marcados **Opcional = Sí** son compatibles, pero opcionales. Si no los define en el Producto de Tarjeta, no podrá actualizarlos más tarde a nivel de tarjeta.

### Grupos de categorías de comerciantes

D1 proporciona una configuración predeterminada en [Grupo de categorías de comerciantes - configuración predeterminada](https://thales-dis-dbp.stoplight.io/docs/d1-caas/773811d46b2b1-merchant-type-default-configuration).

El emisor puede redefinir **Juegos de azar**, **Adultos**, y **Riesgo** grupos con el **Equipo de Entrega de Thales**.

## Experiencia del usuario

<figure><img src="/files/08e9e868571a8987b5da425f00e135d35040895e" 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 usando el **API Backend D1** o el **SDK D1**.

Solo puede gestionar los controles de dominio que estén habilitados en el Producto de Tarjeta.

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

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

#### Recuperar configuraciones actuales

<figure><img src="/files/fea06113ded9d3ec0443ae6505e0b27d309c2745" alt=""><figcaption><p>Recuperar la configuración actual de controles de dominio (backend del emisor).</p></figcaption></figure>

Use [Obtener configuración de tarjeta](https://thales-dis-dbp.stoplight.io/docs/d1-caas/906ogh06j4ydz-get-card-settings) para recuperar la configuración actual de controles de dominio.

#### Actualizar configuraciones

<figure><img src="/files/3cb8f6b41b932aa8252ff830cf7c80e8980663e2" alt=""><figcaption><p>Actualizar la configuración de controles de dominio (backend del emisor).</p></figcaption></figure>

Use [Actualizar configuración de controles de tarjeta](https://thales-dis-dbp.stoplight.io/docs/d1-caas/fo3m7yl48larm-update-card-controls) para actualizar la configuración de controles.

### Gestionar controles con el SDK 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 D1. Ver [Controles de tarjeta en la aplicación](/transaction-control/es/implement-transaction-control/implement-domain-controls/manage-in-app-card-controls.md).

#### Recuperar configuraciones actuales

<figure><img src="/files/25e78ed0afdcee5dafbab258699ecab37686ff97" alt=""><figcaption><p>Recuperar la configuración actual de controles de dominio (aplicación del emisor).</p></figcaption></figure>

#### Actualizar configuraciones

<figure><img src="/files/40c74db44e92ce0ee5b8111ce9e79a11906661fc" alt=""><figcaption><p>Actualizar la configuración de 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 se crea o registra una tarjeta en D1.

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

#### Geografía por región

Ver [Regiones compatibles](https://thales-dis-dbp.stoplight.io/docs/d1-caas/ddeec450dd753-geography-by-region-supported-regions) 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 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/es/implement-transaction-control/implement-domain-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.
