Skip to main content

​
Descripción General

Los métodos de pago en Güeno se representan como entidades de tipo payment_method. Esto le permite rastrear tarjetas de crédito, cuentas bancarias, billeteras y otros instrumentos de pago asociados con personas o empresas.
Los métodos de pago se crean utilizando el endpoint universal /entities con entityType: "payment_method".

​
¿Qué es una Entidad de Método de Pago?

Una entidad de método de pago representa cualquier instrumento financiero utilizado para transacciones:
  • Tarjetas de Crédito - Visa, Mastercard, Amex, etc.
  • Tarjetas de Débito - Tarjetas de débito emitidas por bancos
  • Cuentas Bancarias - Cuentas corrientes, cuentas de ahorro
  • Billeteras Digitales - PayPal, Apple Pay, Google Pay, etc.
  • Billeteras de Criptomonedas - Direcciones de Bitcoin, Ethereum

​
Características Clave

​
Relaciones de Entidades

Los métodos de pago pueden vincularse a otras entidades:
  • Propiedad de - Enlace al propietario persona o empresa
  • Usado en - Enlace a transacciones donde se utilizó este método de pago
  • Asociado con - Enlace a dispositivos utilizados para transacciones

​
Análisis de Riesgo

Los métodos de pago pueden ser analizados para detección de fraude:
  • Monitoreo de velocidad de transacciones
  • Detección de anomalías geográficas
  • Correlación de huella digital de dispositivo
  • Patrones históricos de uso

​
Casos de Uso

  1. Detección de Fraude - Detectar patrones sospechosos de uso de métodos de pago
  2. Verificación de Tarjetas - Validar detalles de tarjetas y propiedad
  3. Monitoreo de Cuentas - Rastrear actividad inusual de cuentas
  4. Seguimiento de Transacciones - Vincular transacciones a fuentes de pago
  5. Detección de Múltiples Cuentas - Identificar métodos de pago compartidos entre usuarios

​
Estructura de Datos

Las entidades de métodos de pago contienen: 
{
  "entityType": "payment_method",
  "entityData": {
    "paymentMethod": {
      "type": "credit_card",           // Tipo de método de pago
      "last4": "4242",                  // Últimos 4 dígitos
      "brand": "visa",                  // Marca de la tarjeta
      "expiryMonth": "12",              // Mes de vencimiento
      "expiryYear": "2025",             // Año de vencimiento
      "holderName": "John Doe",         // Nombre del titular
      "issuerCountry": "BR",            // País emisor
      "bin": "424242",                  // Número de Identificación Bancaria
      "fingerprint": "abc123xyz",       // Huella digital única
      "funding": "credit",              // Tipo de financiamiento (credit/debit)
      "network": "visa"                 // Red de pago
    }
  },
  "relationships": [
    {
      "targetEntityId": "person-uuid-123",
      "relationshipType": "owns",
      "strength": 1.0
    }
  ]
}

​
Tipos de Métodos de Pago

​
Tarjeta de Crédito

{
  "type": "credit_card",
  "brand": "visa",
  "last4": "4242",
  "expiryMonth": "12",
  "expiryYear": "2025",
  "holderName": "John Doe",
  "issuerCountry": "BR",
  "bin": "424242",
  "funding": "credit"
}

​
Cuenta Bancaria

{
  "type": "bank_account",
  "accountNumber": "12345-6",
  "accountType": "checking",
  "bank": "Banco do Brasil",
  "currency": "BRL",
  "routingNumber": "001"
}

​
Billetera Digital

{
  "type": "digital_wallet",
  "provider": "paypal",
  "email": "user@example.com",
  "accountId": "paypal-12345"
}

​
Billetera de Criptomonedas

{
  "type": "crypto_wallet",
  "currency": "BTC",
  "address": "1A1zP1eP5QGefi2DMPTfTL5SLmv7DivfNa",
  "network": "bitcoin"
}

​
Endpoints de API

Las entidades de métodos de pago utilizan los endpoints estándar de entidades:

​
Patrones Comunes

​
Crear un Método de Pago para una Persona

const response = await fetch('http://api.gu1.ai/entities', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    entityType: 'payment_method',
    entityData: {
      paymentMethod: {
        type: 'credit_card',
        last4: '4242',
        brand: 'visa',
        expiryMonth: '12',
        expiryYear: '2025',
        holderName: 'John Doe'
      }
    },
    relationships: [
      {
        targetEntityId: 'person-uuid-123',
        relationshipType: 'owns',
        strength: 1.0
      }
    ]
  })
});

​
Verificar Uso del Método de Pago

Encontrar todas las transacciones usando un método de pago específico: 
const response = await fetch(
  `http://api.gu1.ai/entities?entityType=transaction&relationshipWith=${paymentMethodId}`,
  {
    headers: {
      'Authorization': 'Bearer YOUR_API_KEY'
    }
  }
);

​
Ver También