Resumen de Métodos de Pago

Descripción General

Los métodos de pago en Gu1 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

Detección de Fraude - Detectar patrones sospechosos de uso de métodos de pago
Verificación de Tarjetas - Validar detalles de tarjetas y propiedad
Monitoreo de Cuentas - Rastrear actividad inusual de cuentas
Seguimiento de Transacciones - Vincular transacciones a fuentes de pago
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:

Crear Método de Pago - Crear una nueva entidad de método de pago
Obtener Método de Pago - Recuperar detalles del método de pago
Actualizar Método de Pago - Actualizar información del método de pago
Listar Métodos de Pago - Listar todos los métodos de pago
Analizar Método de Pago - Ejecutar análisis de riesgo en método de pago

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

Referencia de Tipos de Entidades - Todos los tipos de entidades disponibles
Relaciones de Entidades - Gestión de relaciones
Monitoreo de Transacciones - Casos de uso de detección de fraude

​Descripción General

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

​Características Clave

​Relaciones de Entidades

​Análisis de Riesgo

​Casos de Uso

​Estructura de Datos

​Tipos de Métodos de Pago

​Tarjeta de Crédito

​Cuenta Bancaria

​Billetera Digital

​Billetera de Criptomonedas

​Endpoints de API

​Patrones Comunes

​Crear un Método de Pago para una Persona

​Verificar Uso del Método de Pago

​Ver También

Descripción General

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

Características Clave

Relaciones de Entidades

Análisis de Riesgo

Casos de Uso

Estructura de Datos

Tipos de Métodos de Pago

Tarjeta de Crédito

Cuenta Bancaria

Billetera Digital

Billetera de Criptomonedas

Endpoints de API

Patrones Comunes

Crear un Método de Pago para una Persona

Verificar Uso del Método de Pago

Ver También