Skip to main content

​
Resumen

El enum transaction_reason_type se usa en el cuerpo de la solicitud de Crear Transacción 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):
ValorDescripción
ACCOUNT_BLOCKEDCuenta bloqueada
ACCOUNT_CLOSEDCuenta cerrada
ACCOUNT_FROZENCuenta congelada
AML_ALERTAlerta AML (lavado de dinero)
BENEFICIARY_BLOCKEDBeneficiario bloqueado
BENEFICIARY_LIMIT_EXCEEDEDLímite de beneficiario excedido
CARD_BLOCKEDTarjeta bloqueada
CARD_EXPIREDTarjeta vencida
CARD_LOST_OR_STOLENTarjeta perdida o robada
CANCELLED_BY_MERCHANTCancelado por comerciante
CANCELLED_BY_SYSTEMCancelado por sistema
CANCELLED_BY_USERCancelado por usuario
CHANNEL_NOT_ALLOWEDCanal no permitido
COMPLIANCE_BLOCKBloqueo por cumplimiento
CONNECTION_ERRORError de conexión
CONTACT_ISSUERContactar emisor de tarjeta
CONVERSION_NOT_ALLOWEDConversión de moneda no permitida
COUNTRY_RESTRICTIONRestricción de país
CURRENCY_NOT_SUPPORTEDMoneda no soportada
DAILY_LIMIT_EXCEEDEDLímite diario excedido
DOCUMENTATION_REQUIREDDocumentación requerida
DO_NOT_HONORDo not honor (rechazo genérico)
DUPLICATE_TRANSACTIONTransacción duplicada
EXCEEDS_WITHDRAWAL_FREQUENCYExcede frecuencia de retiro
EXPIREDTransacción o recurso expirado
FRAUD_SUSPECTEDFraude sospechado
INSUFFICIENT_FUNDSFondos insuficientes
INSUFFICIENT_LIQUIDITYLiquidez insuficiente
INVALID_ACCOUNTCuenta inválida
INVALID_AMOUNTMonto inválido
INVALID_BENEFICIARYBeneficiario inválido
INVALID_CARDTarjeta inválida
INVALID_CREDENTIALSCredenciales inválidas
INVALID_PINPIN inválido
KYC_PENDINGKYC pendiente
KYC_REJECTEDKYC rechazado
LIMIT_EXCEEDEDLímite excedido (genérico)
LOST_CARDTarjeta perdida
MAINTENANCEMantenimiento del sistema
MERCHANT_BLOCKEDComerciante bloqueado
MERCHANT_CATEGORY_BLOCKEDCategoría de comerciante bloqueada
MONTHLY_LIMIT_EXCEEDEDLímite mensual excedido
OTHEROtro motivo
PEP_MATCHCoincidencia PEP (persona políticamente expuesta)
PICK_UP_CARDRetener tarjeta
PIN_TRIES_EXCEEDEDIntentos de PIN excedidos
RECURRING_NOT_ALLOWEDRecurrente no permitido
REFUSED_BY_ACQUIRERRechazado por adquiriente
REFUSED_BY_ISSUERRechazado por emisor
REQUIRED_FIELD_MISSINGCampo requerido faltante
RESERVATION_FAILEDReserva fallida
RESTRICTED_CARDTarjeta restringida
RISK_SCORE_THRESHOLDUmbral de score de riesgo excedido
SANCTIONS_MATCHCoincidencia con listas de sanciones
STOLEN_CARDTarjeta robada
SYSTEM_ERRORError de sistema
TIME_RESTRICTIONRestricción horaria
TIMEOUTTimeout
TRANSACTION_LIMIT_EXCEEDEDLímite de transacción excedido
VALIDATION_FAILEDValidación fallida
WITHOUT_REASONSin 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