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

# Actualizar Método de Pago

> Actualizar una entidad de método de pago — en el modelo de entidades gu1 para tarjetas, cuentas y billeteras, con ejemplos para update.

## Descripción General

Actualiza una entidad de método de pago existente. Este endpoint permite actualizaciones parciales - solo necesita proporcionar los campos que desea cambiar.

## Endpoint

```
PATCH http://api.gu1.ai/entities/{id}
```

## Autenticación

Requiere una clave API válida en el encabezado de Autorización:

```bash theme={null}
Authorization: Bearer YOUR_API_KEY
```

## Parámetros de Ruta

<ParamField path="id" type="string" required>
  UUID de la entidad de método de pago a actualizar
</ParamField>

## Cuerpo de la Solicitud

<ParamField body="entityData" type="object">
  Contenedor para datos de método de pago a actualizar
</ParamField>

<ParamField body="relationships" type="array">
  Array de relaciones para agregar o actualizar
</ParamField>

<ParamField body="metadata" type="object">
  Metadatos adicionales para actualizar
</ParamField>

## Ejemplos de Solicitudes

### Actualizar Fecha de Vencimiento de Tarjeta

<CodeGroup>
  ```bash cURL theme={null}
  curl -X PATCH "http://api.gu1.ai/entities/payment-method-uuid-123" \
    -H "Authorization: Bearer YOUR_API_KEY" \
    -H "Content-Type: application/json" \
    -d '{
      "entityData": {
        "paymentMethod": {
          "expiryMonth": "06",
          "expiryYear": "2026"
        }
      }
    }'
  ```

  ```javascript JavaScript theme={null}
  const response = await fetch(
    'http://api.gu1.ai/entities/payment-method-uuid-123',
    {
      method: 'PATCH',
      headers: {
        'Authorization': 'Bearer YOUR_API_KEY',
        'Content-Type': 'application/json'
      },
      body: JSON.stringify({
        entityData: {
          paymentMethod: {
            expiryMonth: '06',
            expiryYear: '2026'
          }
        }
      })
    }
  );

  const updated = await response.json();
  console.log('Fecha de vencimiento actualizada');
  ```

  ```python Python theme={null}
  import requests

  response = requests.patch(
      'http://api.gu1.ai/entities/payment-method-uuid-123',
      headers={
          'Authorization': 'Bearer YOUR_API_KEY',
          'Content-Type': 'application/json'
      },
      json={
          'entityData': {
              'paymentMethod': {
                  'expiryMonth': '06',
                  'expiryYear': '2026'
              }
          }
      }
  )

  updated = response.json()
  print('Fecha de vencimiento actualizada')
  ```
</CodeGroup>

### Agregar Metadatos

<CodeGroup>
  ```bash cURL theme={null}
  curl -X PATCH "http://api.gu1.ai/entities/payment-method-uuid-123" \
    -H "Authorization: Bearer YOUR_API_KEY" \
    -H "Content-Type: application/json" \
    -d '{
      "metadata": {
        "isDefault": true,
        "addedVia": "mobile_app",
        "verifiedAt": "2024-12-23T10:00:00Z"
      }
    }'
  ```

  ```javascript JavaScript theme={null}
  const response = await fetch(
    'http://api.gu1.ai/entities/payment-method-uuid-123',
    {
      method: 'PATCH',
      headers: {
        'Authorization': 'Bearer YOUR_API_KEY',
        'Content-Type': 'application/json'
      },
      body: JSON.stringify({
        metadata: {
          isDefault: true,
          addedVia: 'mobile_app',
          verifiedAt: new Date().toISOString()
        }
      })
    }
  );
  ```

  ```python Python theme={null}
  from datetime import datetime

  response = requests.patch(
      'http://api.gu1.ai/entities/payment-method-uuid-123',
      headers={'Authorization': 'Bearer YOUR_API_KEY'},
      json={
          'metadata': {
              'isDefault': True,
              'addedVia': 'mobile_app',
              'verifiedAt': datetime.utcnow().isoformat() + 'Z'
          }
      }
  )
  ```
</CodeGroup>

## Respuesta

<ResponseField name="success" type="boolean">
  Si la operación fue exitosa
</ResponseField>

<ResponseField name="id" type="string">
  UUID de la entidad de método de pago actualizada
</ResponseField>

<ResponseField name="entityData" type="object">
  Los datos completos del método de pago actualizado
</ResponseField>

<ResponseField name="updatedAt" type="string">
  Marca de tiempo ISO 8601 de esta actualización
</ResponseField>

## Ejemplo de Respuesta

```json theme={null}
{
  "success": true,
  "id": "payment-method-uuid-123",
  "entityType": "payment_method",
  "entityData": {
    "paymentMethod": {
      "type": "credit_card",
      "last4": "4242",
      "brand": "visa",
      "expiryMonth": "06",
      "expiryYear": "2026",
      "holderName": "John Doe"
    }
  },
  "metadata": {
    "isDefault": true,
    "addedVia": "mobile_app",
    "verifiedAt": "2024-12-23T10:00:00Z"
  },
  "updatedAt": "2024-12-23T10:15:00.000Z"
}
```

<Warning>
  * Este es un endpoint de actualización parcial - solo se actualizarán los campos proporcionados
  * Otros campos permanecerán sin cambios
  * Para eliminar un campo, establézcalo explícitamente en `null`
  * Las actualizaciones de campos sensibles (como números de tarjeta) pueden estar restringidas
</Warning>

## Ver También

* [Crear Método de Pago](/es/api-reference/payment-methods/create)
* [Obtener Método de Pago](/es/api-reference/payment-methods/get)
* [Listar Métodos de Pago](/es/api-reference/payment-methods/list)