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

# Actualizar tarjetas

> Actualiza una tarjeta existente.

### Headers

<ParamField header="x-idempotency" type="string" required placeholder="Token único para garantizar la idempotencia de la petición">
  Token único para garantizar la idempotencia de la petición
</ParamField>

### Path

<ParamField path="card_id" type="string" required placeholder="0195255e-3258-707e-bfaf-3f6807d12d60">
  ID de la tarjeta emitida que actualizarás. [Crear tarjeta](/client/issuing/cards/create).
</ParamField>

### Body

<ParamField body="nickname" type="string">
  Apodo para la tarjeta.
</ParamField>

<ParamField body="status" type="string">
  Estado de la tarjeta.
</ParamField>

<ResponseExample>
  ```json 200 theme={null}
  {
    "id": "9e28925d-2495-48bb-8740-dc0f5454d738",
    "status": "created",
    "last_4": null,
    "nickname": null,
    "customer": {
      "id": "9e28925c-7543-496f-abff-ed973137ab7c",
      "first_name": "Carmela",
      "last_name": "Rice",
      "email": "",
      "phone": "+17408135335",
      "document_type": "CC",
      "document_number": "554637",
      "created_at": "2025-02-07T23:28:34.000000Z",
      "is_test": true
    },
    "address": {
      "line": "5630 Schulist Stravenue Suite 568",
      "line_2": "20276 Jordi Villages Apt. 981",
      "state": "Coleman Rice V",
      "city": "Dakotamouth",
      "country": "LS"
    },
    "wallet": {
      "id": "0194e2be-5ef6-7080-8bb6-ab629957edde",
      "balance": 0,
      "label": "$0"
    }
  }
  ```

  ```json 409 theme={null}
  {
    "message": "No se puede generar la operación, genera un token de idempotencia y envíelo en los headers como x-idempotency",
    "code": 10003,
    "code_name": "idempotency_error"
  }
  ```
</ResponseExample>