Crear Transacción

• PAYMENT - Compra o pago a comerciante
• TRANSFER - Transferencia entre cuentas/usuarios
• WITHDRAWAL - Retiro de efectivo o débito de cuenta
• DEPOSIT - Depósito o crédito de cuenta
• REFUND - Reembolso de una transacción anterior
• CHARGEBACK - Disputa de contracargo
• REVERSAL - Reversión de transacción
• FEE - Cargo de comisión o tarifa
• ADJUSTMENT - Ajuste de saldo
• OTHER - Otro tipo de transacción

• CREATED - Transacción creada (por defecto)
• PROCESSING - Transacción en proceso
• SUSPENDED - Transacción temporalmente suspendida

• SENT - Transacción enviada/transmitida
• EXPIRED - Transacción expirada
• DECLINED - Transacción rechazada/declinada
• REFUNDED - Transacción reembolsada/reversada
• SUCCESSFUL - Transacción completada exitosamente

• CARD - Pago con tarjeta de crédito o débito
• ACH - Automated Clearing House (transferencia bancaria US)
• PIX - Sistema de pagos instantáneos de Brasil
• TED - Transferencia bancaria brasileña (Transferência Eletrônica Disponível)
• BOLETO - Boleto de pago brasileño
• WALLET - Billetera digital (PayPal, Venmo, etc.)
• SWIFT - Transferencia internacional SWIFT
• IBAN - Transferencia bancaria basada en IBAN
• CBU - Cuenta bancaria argentina (Clave Bancaria Uniforme)
• CVU - Cuenta virtual argentina (Clave Virtual Uniforme)
• DEBIN - Sistema de débito instantáneo argentino
• GENERIC_BANK_ACCOUNT - Transferencia de cuenta bancaria genérica
• MPESA - M-Pesa mobile money (Kenia)
• UPI - Unified Payments Interface (India)
• CHECK - Pago con cheque
• ECHECK - Cheque electrónico
• QR_CODE - Pago con código QR
• ONLINE_PAYMENT - Pago online genérico
• WITHDRAWAL_ORDER - Orden de retiro

• originCountry (campo directo) = País de la entidad
• originDetails.country = País del dispositivo/IP al momento de la transacción (puede diferir si está viajando)

• deviceId (string) - Identificador del dispositivo
• deviceFingerprint (string) - Hash de huella digital del dispositivo
• deviceType (enum) - mobile | desktop | tablet | pos | atm
• userAgent (string) - User agent del navegador
• ipAddress (string) - Dirección IP (formato validado)

• country (string) - Código ISO de 2 letras
• city (string) - Nombre de la ciudad
• region (string) - Estado/provincia
• latitude (number) - Latitud (-90 a 90)
• longitude (number) - Longitud (-180 a 180)
• timezone (string) - Identificador de zona horaria

• paymentDetails (object) - Información específica de pago para el origen. Puede enviar cualquier campo relacionado con el pago:
  • Detalles Bancarios/Cuenta:
    • accountNumber (string) - Número de cuenta
    • accountType (enum) - checking | savings | business | personal
    • bankCode (string) - Código del banco
    • bankName (string) - Nombre del banco
    • routingNumber (string) - Routing number (US)
    • swiftCode (string) - Código SWIFT/BIC
    • iban (string) - IBAN (International Bank Account Number)
  • Detalles PIX (Brasil):
    • pixKey (string) - Clave PIX
    • pixType (enum) - Tipo de clave PIX: email | phone | cpf | cnpj | random
  • Detalles de Tarjeta:
    • cardLast4 (string) - Últimos 4 dígitos de la tarjeta
    • cardBrand (string) - Marca de tarjeta (Visa, Mastercard, Amex, etc.)
    • cardholderName (string) - Nombre en la tarjeta
    • cardBin (string) - Primeros 6 dígitos de la tarjeta (BIN)
    • cardType (enum) - credit | debit | prepaid
    • cardCountry (string) - País emisor de la tarjeta (ISO 2 letras)
    • cardExpiry (string) - Fecha de vencimiento (MM/YY)
    • cardFingerprint (string) - Huella digital única de la tarjeta para seguimiento
  • Detalles Crypto:
    • walletAddress (string) - Dirección de wallet de criptomoneda
    • walletType (string) - Tipo de wallet (ej: “metamask”, “coinbase”)
    • blockchain (string) - Red blockchain (ej: “ethereum”, “bitcoin”)
    • tokenSymbol (string) - Símbolo del token (ej: “ETH”, “BTC”, “USDT”)
  • Wallet/Pago Digital:
    • walletId (string) - Identificador de wallet digital
    • walletProvider (string) - Proveedor de wallet (ej: “paypal”, “venmo”, “cashapp”)
    • walletEmail (string) - Email asociado con el wallet
  • Y cualquier otro campo relacionado con el pago que necesite

• isVpn (boolean) - VPN detectado
• isTor (boolean) - Red Tor detectada
• isProxy (boolean) - Proxy detectado
• governmentAccount (boolean) - Bandera de cuenta gubernamental

{
  "deviceType": "mobile",
  "ipAddress": "189.123.45.67",
  "country": "BR",
  "city": "São Paulo",
  "isVpn": false,
  "paymentDetails": {
    "accountNumber": "12345",
    "accountType": "personal",
    "bankName": "Banco do Brasil",
    "pixKey": "user@email.com",
    "pixType": "email"
  }
}

• mcc (string) - Merchant Category Code (4 dígitos, ISO 18245)
• mccDescription (string) - Descripción del MCC (ej: “Restaurants”)
• merchantId (string) - Identificador del comerciante
• merchantName (string) - Nombre del comerciante
• merchantType (string) - Tipo/categoría del comerciante

• deviceId (string) - Identificador del dispositivo
• deviceType (enum) - pos | online | mobile | atm
• ipAddress (string) - Dirección IP (formato validado)

• country (string) - Código ISO de 2 letras
• city (string) - Nombre de la ciudad
• region (string) - Estado/provincia

• paymentDetails (object) - Información específica de pago para el destino. Puede enviar cualquier campo relacionado con el pago:
  • Detalles Bancarios/Cuenta:
    • accountNumber (string) - Número de cuenta destino
    • accountType (enum) - checking | savings | business | merchant
    • bankCode (string) - Código del banco
    • bankName (string) - Nombre del banco
    • routingNumber (string) - Routing number (US)
    • swiftCode (string) - Código SWIFT/BIC
    • iban (string) - IBAN (International Bank Account Number)
  • Detalles PIX (Brasil):
    • pixKey (string) - Clave PIX
    • pixType (enum) - Tipo de clave PIX: email | phone | cpf | cnpj | random
  • Detalles de Tarjeta:
    • cardLast4 (string) - Últimos 4 dígitos de la tarjeta
    • cardBrand (string) - Marca de tarjeta (Visa, Mastercard, Amex, etc.)
    • cardholderName (string) - Nombre en la tarjeta
    • cardBin (string) - Primeros 6 dígitos de la tarjeta (BIN)
    • cardType (enum) - credit | debit | prepaid
    • cardCountry (string) - País emisor de la tarjeta (ISO 2 letras)
    • cardExpiry (string) - Fecha de vencimiento (MM/YY)
    • cardFingerprint (string) - Huella digital única de la tarjeta para seguimiento
  • Detalles Crypto:
    • walletAddress (string) - Dirección de wallet de criptomoneda
    • walletType (string) - Tipo de wallet (ej: “metamask”, “coinbase”)
    • blockchain (string) - Red blockchain (ej: “ethereum”, “bitcoin”)
    • tokenSymbol (string) - Símbolo del token (ej: “ETH”, “BTC”, “USDT”)
  • Wallet/Pago Digital:
    • walletId (string) - Identificador de wallet digital
    • walletProvider (string) - Proveedor de wallet (ej: “paypal”, “venmo”, “cashapp”)
    • walletEmail (string) - Email asociado con el wallet
  • Y cualquier otro campo relacionado con el pago que necesite

• cryptoExchange (boolean) - Es exchange de criptomonedas
• highRisk (boolean) - Bandera de comerciante de alto riesgo
• privateSector (boolean) - Bandera de sector privado

{
  "mcc": "5812",
  "mccDescription": "Restaurants",
  "merchantName": "Restaurant ABC",
  "country": "US",
  "highRisk": false,
  "paymentDetails": {
    "accountNumber": "98765",
    "accountType": "merchant",
    "bankName": "Bradesco"
  }
}

​

tags (object) - Sistema de Categorización Clave-Valor

• Filtrado personalizado en dashboards y reportes
• Activar lógica de negocio específica
• Seguimiento del estado de revisión
• Categorización por nivel de riesgo o fuente
• Estados de flujo de trabajo personalizados

• risk_level (string) - “low”, “medium”, “high”, “critical”
• source (string) - “api”, “web”, “mobile”, “batch”, “import”
• channel (string) - “online”, “branch”, “atm”, “call_center”, “partner”
• reviewed (boolean) - false (pendiente de revisión), true (revisado)
• category (string) - “payroll”, “supplier”, “refund”, “investment”, “loan”, “bill_payment”
• priority (string) - “low”, “normal”, “high”, “urgent”
• team (string) - “compliance”, “fraud”, “support”, “operations”
• campaign (string) - Identificador de campaña de marketing o negocio
• approved_by (string) - Usuario o sistema que aprobó
• requires_approval (boolean) - Requiere aprobación manual
• customer_segment (string) - “vip”, “regular”, “new”, “dormant”
• product_type (string) - “savings”, “investment”, “loan”, “transfer”
• region (string) - “north”, “south”, “latam”, “emea”, “apac”
• business_unit (string) - “retail”, “corporate”, “wealth”, “sme”

{
  "tags": {
    "risk_level": "high",
    "reviewed": false,
    "requires_approval": true,
    "assigned_to": "fraud_team"
  }
}

{
  "tags": {
    "category": "payroll",
    "batch_id": "PAY_2025_01",
    "department": "engineering",
    "cost_center": "R&D"
  }
}

{
  "tags": {
    "source": "mobile_app",
    "channel": "online",
    "campaign": "winter_2025",
    "referral_code": "FRIEND123",
    "first_transaction": true,
    "customer_segment": "new"
  }
}

{
  "tags": {
    "channel": "branch",
    "business_unit": "retail",
    "product_type": "loan",
    "region": "latam",
    "requires_approval": true,
    "approved_by": "manager_john"
  }
}

​

Otros Campos de Metadata:

• purpose (string) - Propósito de la transacción (ej: “salary”, “invoice_payment”)
• frequency (string) - Frecuencia de la transacción (ej: “monthly”, “one-time”)
• contract_number (string) - Número de contrato (para pagos empresariales)
• enhanced_due_diligence (boolean) - Bandera de EDD
• block_reason (string) - Razón de bloqueo
• compliance_alert (boolean) - Bandera de alerta de cumplimiento

{
  "tags": {
    "risk_level": "medium",
    "source": "api",
    "reviewed": false,
    "category": "invoice_payment"
  },
  "purpose": "supplier_payment",
  "frequency": "monthly",
  "contract_number": "CNT-2025-001",
  "enhanced_due_diligence": false
}

• id (string) - UUID interno de gu1
• externalId (string) - Su ID externo
• type (enum) - Tipo de transacción
• status (enum) - Estado de la transacción
• amount (string) - Monto original (string numérico)
• currency (string) - Código de moneda original (ISO 4217)
• amountInUsd (string | null) - Monto convertido en USD
• exchangeRate (string | null) - Tasa de cambio utilizada (precisión: 10 decimales)
• rateSource (string | null) - Fuente de la tasa de cambio
• riskScore (string | null) - Puntuación de riesgo 0-100 (precisión: 2 decimales) si se ejecutaron reglas
• riskFactors (array) - Array de factores de riesgo identificados
• flagged (boolean) - Si la transacción fue marcada para revisión

• success (boolean) - Si las reglas se ejecutaron exitosamente
• rulesTriggered (number) - Número de reglas que se activaron
• alerts (array) - Alertas generadas por las reglas
• riskScore (number) - Puntuación de riesgo final calculada
• decision (string) - Decisión final (APPROVE, REJECT, HOLD, REVIEW_REQUIRED)