> ## Documentation Index
> Fetch the complete documentation index at: https://docs.gu1.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Resumen de Métodos de Pago

> Gestiona métodos de pago como entidades de primer nivel en gu1 — tarjetas, cuentas, uso y reglas de fraude y compliance asociadas.

## 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.

<Info>
  Los métodos de pago se crean utilizando el endpoint universal `/entities` con `entityType: "payment_method"`.
</Info>

## ¿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:

```json theme={null}
{
  "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

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

### Cuenta Bancaria

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

### Billetera Digital

```json theme={null}
{
  "type": "digital_wallet",
  "provider": "paypal",
  "email": "user@example.com",
  "accountId": "paypal-12345"
}
```

### Billetera de Criptomonedas

```json theme={null}
{
  "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](/es/api-reference/payment-methods/create) - Crear una nueva entidad de método de pago
* [Obtener Método de Pago](/es/api-reference/payment-methods/get) - Recuperar detalles del método de pago
* [Actualizar Método de Pago](/es/api-reference/payment-methods/update) - Actualizar información del método de pago
* [Listar Métodos de Pago](/es/api-reference/payment-methods/list) - Listar todos los métodos de pago
* [Analizar Método de Pago](/en/api-reference/entities/analyze) - Ejecutar análisis de riesgo en método de pago

## Patrones Comunes

### Crear un Método de Pago para una Persona

```javascript theme={null}
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:

```javascript theme={null}
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](/en/api-reference/entities/entity-types) - Todos los tipos de entidades disponibles
* [Relaciones de Entidades](/es/api-reference/entities/materialize-relationships) - Gestión de relaciones
* [Monitoreo de Transacciones](/es/use-cases/transaction-monitoring/overview) - Casos de uso de detección de fraude