---
description: Вместо этого метода следует использовать updateCard
---

# Обновление карт \[deprecated]

**Описание:**\
Для обновления информации на картах используется метод **updatecards**.

**Как использовать:** \
С помощью метода вы можете изменять значение переменных. Список переменных (values), которые используются, можно редактировать во вкладке Переменные в личном кабинете. Данный метод рекомендуется использовать для простых обновлений информации на карте, а также при отправке транзакционных push-уведомлений (например, изменение баланса). Для отправки рекламных уведомлений, используйте метод sendpush. Этим методом лучше обновлять карты по одной.\
Используйте один из двух вариантов работы данного метода:

## **Вариант 1. Поиск карты для обновления по значениям переменных, которые вы задали ранее при создании карты**&#x20;

Если вы не храните cardCode или cardId, передаваемые из Passteam, можно искать карту по значению одной из переменных. Переменная должна быть уникальной. Если система найдет более одной карты, подходящей под условия запроса, в ответе будет отправлена ошибка

## &#x20;updatecards

<mark style="color:green;">`POST`</mark> `https://getpass.passteam.ru/oapi/v1/updatecards`

#### Request Body

| Name                     | Type    | Description                                                                                                  |
| ------------------------ | ------- | ------------------------------------------------------------------------------------------------------------ |
| cards\[0].templateId     | string  | Идентификатор шаблона                                                                                        |
| cards\[0].cardValues     | array   | Переменная и ее значение, по которому будет осуществлен поиск нужной карты для обновления.карт со значениями |
| cards\[0].values         | array   | Переменная и ее новое значение (указывайте только если не указали cardCode)                                  |
| cards\[0].expirationDate | string  | Срок действия карты в формате дд.мм.гггг чч:мм                                                               |
| cards\[0].voided         | integer | Деактивация карты 1 или 0                                                                                    |

{% tabs %}
{% tab title="200 " %}
```
{
    "result": {
        "messages": [],
        "updated": 1,
        "processed": 1
    },
    "message": "OK",
    "code": 200,
    "error": false
}
```
{% endtab %}
{% endtabs %}

## **Вариант 2. Поиск карты для обновления по системным параметрам cardId или cardCode**

Используйте этот вариант если при создании карты вы сохранили cardId или cardCode, переданные в ответе на запрос createcard.

## &#x20;updatecards

<mark style="color:green;">`POST`</mark> `https://getpass.passteam.ru/oapi/v1/updatecards`

#### Request Body

| Name                     | Type    | Description                                                      |
| ------------------------ | ------- | ---------------------------------------------------------------- |
| templateId               | string  | Идентификатор шаблона                                            |
| cards\[0].cardId         | string  | Идентификатор карты (указывайте только если не указали cardCode) |
| cards\[0].cardCode       | string  | Код карты (указывайте только если не указали cardId)             |
| cards\[0].values         | string  | Переменная и ее новое значение                                   |
| cards\[0].expirationDate | string  | Срок действия карты в формате дд.мм.гггг чч:мм                   |
| cards\[0].voided         | integer | Деактивация карты 1 или 0                                        |

{% tabs %}
{% tab title="200 " %}
```
{
    "result": {
        "messages": [],
        "updated": 1,
        "processed": 1
    },
    "message": "OK",
    "code": 200,
    "error": false
}
```
{% endtab %}
{% endtabs %}
