> ## Documentation Index
> Fetch the complete documentation index at: https://docs.gu1.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Enum Razón de Transacción

> Lista completa de valores transaction_reason_type para Crear Transacción y reglas — en la API de monitoreo transaccional gu1 para fraude y AML.

## Resumen

El enum **transaction\_reason\_type** se usa en el cuerpo de la solicitud de [Crear Transacción](/es/use-cases/transaction-monitoring/api-reference) como campo opcional `reason`. Describe el resultado o causa de una transacción (ej. rechazo, fallo, límite excedido). Si se omite, el sistema usa `WITHOUT_REASON`. El campo es opcional para no romper integraciones existentes.

## Valores completos del enum

Todos los valores permitidos (alfabético):

| Valor                          | Descripción                                       |
| ------------------------------ | ------------------------------------------------- |
| `ACCOUNT_BLOCKED`              | Cuenta bloqueada                                  |
| `ACCOUNT_CLOSED`               | Cuenta cerrada                                    |
| `ACCOUNT_FROZEN`               | Cuenta congelada                                  |
| `AML_ALERT`                    | Alerta AML (lavado de dinero)                     |
| `BENEFICIARY_BLOCKED`          | Beneficiario bloqueado                            |
| `BENEFICIARY_LIMIT_EXCEEDED`   | Límite de beneficiario excedido                   |
| `CARD_BLOCKED`                 | Tarjeta bloqueada                                 |
| `CARD_EXPIRED`                 | Tarjeta vencida                                   |
| `CARD_LOST_OR_STOLEN`          | Tarjeta perdida o robada                          |
| `CANCELLED_BY_MERCHANT`        | Cancelado por comerciante                         |
| `CANCELLED_BY_SYSTEM`          | Cancelado por sistema                             |
| `CANCELLED_BY_USER`            | Cancelado por usuario                             |
| `CHANNEL_NOT_ALLOWED`          | Canal no permitido                                |
| `COMPLIANCE_BLOCK`             | Bloqueo por cumplimiento                          |
| `CONNECTION_ERROR`             | Error de conexión                                 |
| `CONTACT_ISSUER`               | Contactar emisor de tarjeta                       |
| `CONVERSION_NOT_ALLOWED`       | Conversión de moneda no permitida                 |
| `COUNTRY_RESTRICTION`          | Restricción de país                               |
| `CURRENCY_NOT_SUPPORTED`       | Moneda no soportada                               |
| `DAILY_LIMIT_EXCEEDED`         | Límite diario excedido                            |
| `DOCUMENTATION_REQUIRED`       | Documentación requerida                           |
| `DO_NOT_HONOR`                 | Do not honor (rechazo genérico)                   |
| `DUPLICATE_TRANSACTION`        | Transacción duplicada                             |
| `EXCEEDS_WITHDRAWAL_FREQUENCY` | Excede frecuencia de retiro                       |
| `EXPIRED`                      | Transacción o recurso expirado                    |
| `FRAUD_SUSPECTED`              | Fraude sospechado                                 |
| `INSUFFICIENT_FUNDS`           | Fondos insuficientes                              |
| `INSUFFICIENT_LIQUIDITY`       | Liquidez insuficiente                             |
| `INVALID_ACCOUNT`              | Cuenta inválida                                   |
| `INVALID_AMOUNT`               | Monto inválido                                    |
| `INVALID_BENEFICIARY`          | Beneficiario inválido                             |
| `INVALID_CARD`                 | Tarjeta inválida                                  |
| `INVALID_CREDENTIALS`          | Credenciales inválidas                            |
| `INVALID_PIN`                  | PIN inválido                                      |
| `KYC_PENDING`                  | KYC pendiente                                     |
| `KYC_REJECTED`                 | KYC rechazado                                     |
| `LIMIT_EXCEEDED`               | Límite excedido (genérico)                        |
| `LOST_CARD`                    | Tarjeta perdida                                   |
| `MAINTENANCE`                  | Mantenimiento del sistema                         |
| `MERCHANT_BLOCKED`             | Comerciante bloqueado                             |
| `MERCHANT_CATEGORY_BLOCKED`    | Categoría de comerciante bloqueada                |
| `MONTHLY_LIMIT_EXCEEDED`       | Límite mensual excedido                           |
| `OTHER`                        | Otro motivo                                       |
| `PEP_MATCH`                    | Coincidencia PEP (persona políticamente expuesta) |
| `PICK_UP_CARD`                 | Retener tarjeta                                   |
| `PIN_TRIES_EXCEEDED`           | Intentos de PIN excedidos                         |
| `RECURRING_NOT_ALLOWED`        | Recurrente no permitido                           |
| `REFUSED_BY_ACQUIRER`          | Rechazado por adquiriente                         |
| `REFUSED_BY_ISSUER`            | Rechazado por emisor                              |
| `REQUIRED_FIELD_MISSING`       | Campo requerido faltante                          |
| `RESERVATION_FAILED`           | Reserva fallida                                   |
| `RESTRICTED_CARD`              | Tarjeta restringida                               |
| `RISK_SCORE_THRESHOLD`         | Umbral de score de riesgo excedido                |
| `SANCTIONS_MATCH`              | Coincidencia con listas de sanciones              |
| `STOLEN_CARD`                  | Tarjeta robada                                    |
| `SYSTEM_ERROR`                 | Error de sistema                                  |
| `TIME_RESTRICTION`             | Restricción horaria                               |
| `TIMEOUT`                      | Timeout                                           |
| `TRANSACTION_LIMIT_EXCEEDED`   | Límite de transacción excedido                    |
| `VALIDATION_FAILED`            | Validación fallida                                |
| `WITHOUT_REASON`               | Sin motivo específico (por defecto si se omite)   |

## Uso

* **Crear Transacción:** Enviar `reason` en el cuerpo con cualquier valor de la tabla. Omitir para usar `WITHOUT_REASON`.
* **Crear en lote:** Cada transacción del array puede incluir `reason`; mismo comportamiento.
* **Reglas / Condiciones:** Usar el campo `transaction.global.reason` en condiciones de reglas para filtrar o puntuar por motivo.

## Ver también

* [Referencia API Crear Transacción](/es/use-cases/transaction-monitoring/api-reference) — Cuerpo de la solicitud y campo `reason`
* [Schema Payment Details](/es/api-reference/transactions/payment-details-schema) — Estructuras sugeridas para `originDetails.paymentDetails` y `destinationDetails.paymentDetails`