Resumo
O enum transaction_reason_type é usado no corpo da requisição de Criar Transação como campo opcionalreason. 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
reasonno corpo com qualquer valor da tabela. Omitir para usarWITHOUT_REASON. - Criar em lote: Cada transação do array pode incluir
reason; mesmo comportamento. - Regras / Condições: Usar o campo
transaction.global.reasonem condições de regras para filtrar ou pontuar por motivo.
Ver também
- Referência API Criar Transação — Corpo da requisição e campo
reason - Schema Payment Details — Estruturas sugeridas para
originDetails.paymentDetailsedestinationDetails.paymentDetails