> 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/central-issuance/es/implementar-la-emision-centralizada/validacion-de-direccion.md).

# Validación de dirección

El **Validación de dirección** el servicio verifica la dirección de entrega de cada tarjeta antes de la producción. Su objetivo es simple: reducir el número de tarjetas devueltas por una dirección no entregable.

* Dirección válida → la tarjeta se produce y se envía.
* Dirección inválida → el pedido de la tarjeta se rechaza, y se te notifica para que puedas corregir la dirección y volver a pedirla.

{% hint style="info" %}
La validación se realiza automáticamente durante el flujo del pedido. No se requiere ninguna llamada adicional a la API desde el backend del emisor.
{% endhint %}

### Cómo funciona

<figure><img src="https://3468344159-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWhgSoXgpjZJxLx4cDHB1%2Fuploads%2FWcLqppDKq9sNm3uaXCJ5%2Fimage.png?alt=media&amp;token=00e34cc9-7391-4de8-a217-fecb089f69f9" alt=""><figcaption></figcaption></figure>

1. El backend del emisor envía un pedido de tarjeta, incluida la dirección de entrega del usuario final.
2. D1 confirma el pedido (HTTP 202); la validación de la dirección se realiza después.
3. D1 valida las entradas (formato, longitud, caracteres permitidos).
4. D1 envía la dirección al servicio de validación
5. D1 evalúa la respuesta según los umbrales de la configuración del emisor.
6. Resultado:
   1. Válida → la tarjeta pasa a producción; se envía una notificación.
   2. Inválida → la tarjeta se rechaza; se envía una notificación con el motivo (y opcionalmente una dirección corregida sugerida).
7. El emisor vuelve a pedir la tarjeta con una dirección corregida si es necesario.

### Cómo elegir el modo de validación

Se selecciona un modo durante la incorporación. Se aplica a todos los pedidos de tarjetas.

<table><thead><tr><th width="120.199951171875">Modo</th><th>Qué sucede</th><th>Cuándo usarlo</th></tr></thead><tbody><tr><td><strong>deshabilitado</strong></td><td>Sin validación. Todas las tarjetas pasan a producción.</td><td>No quieres el servicio.</td></tr><tr><td><strong>estadísticas</strong></td><td>La validación se realiza, pero la tarjeta es <strong>siempre producida</strong>. </td><td>Para medir el impacto antes de activar la aplicación obligatoria.</td></tr><tr><td><strong>habilitado</strong></td><td>La validación se realiza. Las direcciones inválidas son <strong>rechazadas</strong>.</td><td>Uso estándar en producción.</td></tr><tr><td><strong>premium</strong></td><td>Igual que <em>habilitado</em>, además de una <strong>dirección corregida sugerida</strong> se devuelve cuando está disponible.</td><td>Quieres ayuda para corregir las direcciones rechazadas.</td></tr></tbody></table>

### Qué necesitas configurar

Solo unos pocos parámetros son importantes para ti:

<table><thead><tr><th>Parámetro</th><th>Descripción</th><th width="146">Recomendado</th></tr></thead><tbody><tr><td>addressValidation</td><td>Modo: deshabilitado / estadísticas / habilitado / premium</td><td>habilitado</td></tr><tr><td>addressValidationMatchScoreThreshold</td><td>Puntuación mínima de calidad (0–100). Por debajo de esto, la dirección se rechaza.</td><td>95</td></tr><tr><td>addressValidationOnReorder</td><td>Si es true, la dirección se vuelve a validar cuando vuelves a pedir una tarjeta previamente rechazada. Si es false, el nuevo pedido omite la validación.</td><td>false</td></tr><tr><td>addressValidationOutageFallback</td><td>Qué hacer si el servicio de validación no está disponible temporalmente: producir (aceptar la tarjeta) o rechazar (rechazar la tarjeta).</td><td>producir</td></tr></tbody></table>

{% hint style="info" %}
Todos los demás parámetros técnicos (proveedor, estrategia de reintento, umbrales del código postal, etc.) se gestionan internamente y no requieren ninguna acción de tu parte.
{% endhint %}

### Notificaciones que recibirás

#### Dirección válida – la tarjeta pasa a producción

```json
{
  "operation": "PRODUCE",
  "status": "PENDING",
  "details": {
    "status": "CARD_PROD_REQUESTED",
    "addressValidation": {
      "status": "válido",
      "matchScore": 95
    }
  }
}
```

#### Dirección inválida – tarjeta rechazada

```json
{
  "operation": "PRODUCE",
  "status": "FAILED",
  "errorCode": "INVALID_ADDRESS",
  "details": {
    "status": "DATA_EXCEPTION",
    "addressValidation": {
      "status": "inválido",
      "matchScore": 55
    }
  }
}
```

#### Dirección inválida – con una corrección sugerida (modo premium)

```json
{
  "operation": "PRODUCE",
  "status": "FAILED",
  "errorCode": "INVALID_ADDRESS",
  "details": {
    "status": "DATA_EXCEPTION",
    "addressValidation": {
      "status": "inválido",
      "matchScore": 55,
      "suggestedAddress": {
        "line1": "221B Baker Street",
        "line2": "Flat 2",
        "city": "London",
        "postalCode": "NW1 6XE",
        "countryCode": "GB"
      }
    }
  }
}
```

### ¿Qué sucede cuando se rechaza una tarjeta?

1. Recibes una notificación PRODUCE / FAILED con errorCode = INVALID\_ADDRESS.
2. En **premium** modo, se puede sugerir una dirección corregida.
3. Tú **corriges la dirección** y **vuelves a pedir** la tarjeta.

### Disponibilidad y fiabilidad del servicio

* El validador se llama en tiempo real para cada pedido de tarjeta.
* Si el proveedor no está disponible temporalmente, el servicio reintenta automáticamente.
* Después de todos los reintentos, el **plan de contingencia** (producir o rechazar) se aplica.
* La cobertura de países y la precisión dependen de los datos de referencia de Loqate — consulta [cobertura de países de Loqate](https://docs.loqate.com/data-coverage/introduction).


---

# 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/central-issuance/es/implementar-la-emision-centralizada/validacion-de-direccion.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.