> ## 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 Motivo da Transação

> Lista completa de valores transaction_reason_type para Criar Transação e regras — na API de monitoramento de transações gu1 para fraude e AML.

## Resumo

O enum **transaction\_reason\_type** é usado no corpo da requisição de [Criar Transação](/pt/use-cases/transaction-monitoring/api-reference) como campo opcional `reason`. Descreve o resultado ou causa de uma transação (ex.: recusa, falha, limite excedido). Se omitido, o sistema usa `WITHOUT_REASON`. O campo é opcional para não quebrar integrações existentes.

## Valores completos do enum

Todos os valores permitidos (alfabético):

| Valor                          | Descrição                                          |
| ------------------------------ | -------------------------------------------------- |
| `ACCOUNT_BLOCKED`              | Conta bloqueada                                    |
| `ACCOUNT_CLOSED`               | Conta encerrada                                    |
| `ACCOUNT_FROZEN`               | Conta congelada                                    |
| `AML_ALERT`                    | Alerta AML (lavagem de dinheiro)                   |
| `BENEFICIARY_BLOCKED`          | Beneficiário bloqueado                             |
| `BENEFICIARY_LIMIT_EXCEEDED`   | Limite do beneficiário excedido                    |
| `CARD_BLOCKED`                 | Cartão bloqueado                                   |
| `CARD_EXPIRED`                 | Cartão vencido                                     |
| `CARD_LOST_OR_STOLEN`          | Cartão perdido ou roubado                          |
| `CANCELLED_BY_MERCHANT`        | Cancelado pelo comerciante                         |
| `CANCELLED_BY_SYSTEM`          | Cancelado pelo sistema                             |
| `CANCELLED_BY_USER`            | Cancelado pelo usuário                             |
| `CHANNEL_NOT_ALLOWED`          | Canal não permitido                                |
| `COMPLIANCE_BLOCK`             | Bloqueio de conformidade                           |
| `CONNECTION_ERROR`             | Erro de conexão                                    |
| `CONTACT_ISSUER`               | Contatar emissor do cartão                         |
| `CONVERSION_NOT_ALLOWED`       | Conversão de moeda não permitida                   |
| `COUNTRY_RESTRICTION`          | Restrição de país                                  |
| `CURRENCY_NOT_SUPPORTED`       | Moeda não suportada                                |
| `DAILY_LIMIT_EXCEEDED`         | Limite diário excedido                             |
| `DOCUMENTATION_REQUIRED`       | Documentação necessária                            |
| `DO_NOT_HONOR`                 | Do not honor (recusa genérica)                     |
| `DUPLICATE_TRANSACTION`        | Transação duplicada                                |
| `EXCEEDS_WITHDRAWAL_FREQUENCY` | Excede frequência de saque                         |
| `EXPIRED`                      | Transação ou recurso expirado                      |
| `FRAUD_SUSPECTED`              | Fraude suspeita                                    |
| `INSUFFICIENT_FUNDS`           | Fundos insuficientes                               |
| `INSUFFICIENT_LIQUIDITY`       | Liquidez insuficiente                              |
| `INVALID_ACCOUNT`              | Conta inválida                                     |
| `INVALID_AMOUNT`               | Valor inválido                                     |
| `INVALID_BENEFICIARY`          | Beneficiário inválido                              |
| `INVALID_CARD`                 | Cartão inválido                                    |
| `INVALID_CREDENTIALS`          | Credenciais inválidas                              |
| `INVALID_PIN`                  | PIN inválido                                       |
| `KYC_PENDING`                  | KYC pendente                                       |
| `KYC_REJECTED`                 | KYC rejeitado                                      |
| `LIMIT_EXCEEDED`               | Limite excedido (genérico)                         |
| `LOST_CARD`                    | Cartão perdido                                     |
| `MAINTENANCE`                  | Manutenção do sistema                              |
| `MERCHANT_BLOCKED`             | Comerciante bloqueado                              |
| `MERCHANT_CATEGORY_BLOCKED`    | Categoria de comerciante bloqueada                 |
| `MONTHLY_LIMIT_EXCEEDED`       | Limite mensal excedido                             |
| `OTHER`                        | Outro motivo                                       |
| `PEP_MATCH`                    | Correspondência PEP (pessoa politicamente exposta) |
| `PICK_UP_CARD`                 | Reter cartão                                       |
| `PIN_TRIES_EXCEEDED`           | Tentativas de PIN excedidas                        |
| `RECURRING_NOT_ALLOWED`        | Recorrente não permitido                           |
| `REFUSED_BY_ACQUIRER`          | Recusado pelo adquirente                           |
| `REFUSED_BY_ISSUER`            | Recusado pelo emissor                              |
| `REQUIRED_FIELD_MISSING`       | Campo obrigatório faltando                         |
| `RESERVATION_FAILED`           | Reserva falhou                                     |
| `RESTRICTED_CARD`              | Cartão restrito                                    |
| `RISK_SCORE_THRESHOLD`         | Limite de score de risco excedido                  |
| `SANCTIONS_MATCH`              | Correspondência com listas de sanções              |
| `STOLEN_CARD`                  | Cartão roubado                                     |
| `SYSTEM_ERROR`                 | Erro de sistema                                    |
| `TIME_RESTRICTION`             | Restrição de horário                               |
| `TIMEOUT`                      | Timeout                                            |
| `TRANSACTION_LIMIT_EXCEEDED`   | Limite de transação excedido                       |
| `VALIDATION_FAILED`            | Validação falhou                                   |
| `WITHOUT_REASON`               | Sem motivo específico (padrão quando omitido)      |

## Uso

* **Criar Transação:** Enviar `reason` no corpo com qualquer valor da tabela. Omitir para usar `WITHOUT_REASON`.
* **Criar em lote:** Cada transação do array pode incluir `reason`; mesmo comportamento.
* **Regras / Condições:** Usar o campo `transaction.global.reason` em condições de regras para filtrar ou pontuar por motivo.

## Ver também

* [Referência API Criar Transação](/pt/use-cases/transaction-monitoring/api-reference) — Corpo da requisição e campo `reason`
* [Schema Payment Details](/pt/api-reference/transactions/payment-details-schema) — Estruturas sugeridas para `originDetails.paymentDetails` e `destinationDetails.paymentDetails`