Skip to main content
PATCH
http://api.gu1.ai
/
entities
/
{id}
Actualizar Método de Pago
curl --request PATCH \
  --url http://api.gu1.ai/entities/{id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "entityData": {},
  "relationships": [
    {}
  ],
  "metadata": {}
}
'
{
  "success": true,
  "id": "<string>",
  "entityData": {},
  "updatedAt": "<string>"
}

​
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: 
Authorization: Bearer YOUR_API_KEY

​
Parámetros de Ruta

​
id
string
required
UUID de la entidad de método de pago a actualizar

​
Cuerpo de la Solicitud

​
entityData
object
Contenedor para datos de método de pago a actualizar
​
relationships
array
Array de relaciones para agregar o actualizar
​
metadata
object
Metadatos adicionales para actualizar

​
Ejemplos de Solicitudes

​
Actualizar Fecha de Vencimiento de Tarjeta

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"
      }
    }
  }'

​
Agregar Metadatos

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"
    }
  }'

​
Respuesta

​
success
boolean
Si la operación fue exitosa
​
id
string
UUID de la entidad de método de pago actualizada
​
entityData
object
Los datos completos del método de pago actualizado
​
updatedAt
string
Marca de tiempo ISO 8601 de esta actualización

​
Ejemplo de Respuesta

{
  "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"
}
  • 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

​
Ver También