# Сохранение данных карт

Отправка запросов осуществляется с заголовком «Content‑Type: application/x‑www‑form‑urlencoded».

Порядок следования параметров в запросах не важен. 

Регистр символов в url‑адресах и параметрах запросов — важен.

Ответ на запрос передается в формате JSON, кодировка UTF‑8.

{% hint style="warning" %}
Ответы API сервиса могут содержать незадокументированные поля. При обработке ответов такие поля должны игнорироваться клиентским кодом.
{% endhint %}

### StartSaveCardSession <a href="#id-7gapnw9v6vhz" id="id-7gapnw9v6vhz"></a>

Запрос инициализации сессии сохранения карты. Выполняется перед перенаправлением пользователя на страницу платежного шлюза Payler.

**Формат запроса:** [https://{host}.payler.com/{api}/StartSaveCardSession](about:blank)

**Доступность:** gapi, cgapi

**Метод отправки запроса:** <mark style="color:green;background-color:green;">**`POST`**</mark>

**Параметры запроса:**

<table data-header-hidden><thead><tr><th></th><th width="150"></th><th width="150"></th><th></th></tr></thead><tbody><tr><td><strong>Название</strong></td><td><strong>Тип</strong></td><td><strong>R/O</strong></td><td><strong>Описание</strong></td></tr><tr><td>key</td><td>A..100</td><td>R</td><td>Идентификатор мерчанта. Выдается с параметрами доступа</td></tr><tr><td>customer_id</td><td>A..100</td><td>R</td><td>Идентификатор плательщика. Возвращается в ответ на запрос <a href="#_customerregister">CustomerRegister</a></td></tr><tr><td>template</td><td>A..100</td><td>O</td><td>Используемый шаблон страницы оплаты, заданный мерчантом. При отсутствии используется шаблон «по умолчанию»</td></tr><tr><td>lang</td><td>A2</td><td>O</td><td><p>Предпочитаемый язык платёжной формы.</p><p>en — английский; ru — русский. По умолчанию — ru</p></td></tr><tr><td>currency</td><td>A3</td><td>O</td><td>Валюта платежа (см. <a href="/pages/zdMUbi6uAPWbyX3Hgd4y#podderzhivaemye-valyuty">Поддерживаемые валюты</a>). По умолчанию — RUB</td></tr><tr><td>pay_page_param_*</td><td>A..100</td><td>O</td><td>Параметры для отображения на странице оплаты.<br>Можно передать любые параметры, начинающиеся с pay_page_param_, а потом отобразить их на странице оплаты. Для этого необходимо использовать шаблон страницы (см. параметр template)</td></tr><tr><td>return_url_success</td><td>A..1000</td><td>O</td><td>URL, на который будет перенаправлен пользователь в случае успешного сохранения карты</td></tr><tr><td>lifetime</td><td>N</td><td>O</td><td>Время жизни сессии в минутах, от 1 минуты и более</td></tr></tbody></table>

**Параметры ответа:**

<table data-header-hidden><thead><tr><th></th><th width="150"></th><th width="150"></th><th></th></tr></thead><tbody><tr><td><strong>Название</strong></td><td><strong>Тип</strong></td><td><strong>R/O</strong></td><td><strong>Описание</strong></td></tr><tr><td>session_id</td><td>A..100</td><td>R</td><td>Идентификатор сессии</td></tr><tr><td>order_id</td><td>A..100</td><td>R</td><td>Идентификатор заказа в системе мерчанта. Генерируется автоматически</td></tr></tbody></table>

Пример ответа на успешный запрос:

```json
{
        "session_id": "dOadCwvzuHxJVKNX4peVZpzTRulVG4OJwomj",
        "order_id": "kqonTcrezjZHhNxs619HYoVE737N7JNXYadb"
}
```

### Save <a href="#save" id="save"></a>

Перенаправление пользователя с сайта мерчанта на страницу формы оплаты на стороне шлюза. Выполняется после команды [StartSaveCardSession](#_7gapnw9v6vhz). После заполнения пользователем полей формы, шлюз автоматически выполняет запрос к эмитенту.

Результатом является сохранение данных карты пользователя

**Формат запроса:** [https://{host}.payler.com/{api}/Save](about:blank)

**Доступно для:** gapi, cgapi

**Метод отправки запроса:** <mark style="color:purple;background-color:purple;">**`GET`**</mark>

**Параметры запроса:**

<table data-header-hidden><thead><tr><th width="150"></th><th width="150"></th><th width="150"></th><th></th></tr></thead><tbody><tr><td><strong>Название</strong></td><td><strong>Тип</strong></td><td><strong>R/O</strong></td><td><strong>Описание</strong></td></tr><tr><td>session_id</td><td>A..100</td><td>R</td><td>Идентификатор платёжной сессии. Содержится в ответе на запрос <a href="#_7gapnw9v6vhz">StartSaveCardSession</a></td></tr></tbody></table>

После обработки запроса Save на стороне платежного шлюза пользователь будет перенаправлен на страницу с отображением результата сохранения карты, а через 3 секунды будет возвращен на сайт мерчанта.

**Адрес возврата пользователя (URL страницы)** — указывается мерчантом заранее в виде URL. Пример адреса возврата:[ ](http://myshop.ru/complete?order_id=%7border_id)[http://mysite.ru/complete?session\_id={session\_id](http://myshop.ru/complete?order_id=%7border_id)}

Для получения результатов операции следует использовать данные, полученные в рамках запроса статуса операции (см. метод [GetStatusSaveCard](#getstatussavecard)).

Нужно учесть, что возврат на указанный URL может быть сделан несколько раз, например, когда пользователь запутался, нажимал кнопку «Back» в браузере. Если пользователь ошибочно попытается повторно сохранить карту в рамках одной сессии, то ему будет показано сообщение о том, что карта уже сохранена и сделано перенаправление на сайт мерчанта.

### PaySaveCard <a href="#d1dbbfw5cib1" id="d1dbbfw5cib1"></a>

Сохранение данных карты путем списания или блокировки (в зависимости от настроек мерчанта) контрольной суммы на счете карты с последующей автоматической разблокировкой или возвратом списанной суммы.

Результатом является сохранение данных карты пользователя.

**URL запроса:** <https://{host}.payler.com/mapi/v1/PaySaveCard>

**Доступно для:** mapi

**Метод отправки запроса:** <mark style="color:green;background-color:green;">**`POST`**</mark>

{% hint style="info" %}
Использование данного метода предполагает обязательное соответствие системы мерчанта требованиям [PCI DSS](/ru-api/obshie-svedeniya/vvedenie.md#pci-dss).
{% endhint %}

**Параметры запроса:**

<table data-header-hidden><thead><tr><th width="178"></th><th width="150"></th><th width="150"></th><th></th></tr></thead><tbody><tr><td><strong>Название</strong></td><td><strong>Тип</strong></td><td><strong>R/O</strong></td><td><strong>Описание</strong></td></tr><tr><td>key</td><td>A..100</td><td>R</td><td>Идентификатор мерчанта. Выдается с параметрами доступа</td></tr><tr><td>order_id</td><td>A..100</td><td>R</td><td>Идентификатор оплачиваемого заказа в системе мерчанта. Для каждого платежа нужен свой уникальный идентификатор. Только печатные ASCII‑символы</td></tr><tr><td>currency</td><td>A3</td><td>О</td><td>Валюта платежа (см. <a href="/pages/zdMUbi6uAPWbyX3Hgd4y#podderzhivaemye-valyuty">Поддерживаемые валюты</a>). По умолчанию — RUB</td></tr><tr><td>card_number</td><td>A..19</td><td>R</td><td>Номер карты. Десятичные цифры без разделителей [0–9]</td></tr><tr><td>card_holder</td><td>A..100</td><td>O</td><td>Имя владельца карты. Латинские символы, десятичные цифры или символ пробела [a-zA-Z0‑9]</td></tr><tr><td>expired_year</td><td>N2</td><td>R</td><td>Год окончания срока действия карты</td></tr><tr><td>expired_month</td><td>N2</td><td>R</td><td>Месяц окончания срока действия карты</td></tr><tr><td>secure_code</td><td>A</td><td>R</td><td>Код подлинности карты (CVC2/CVV2).<br>Десятичные цифры [0–9]</td></tr><tr><td>lang</td><td>A2</td><td>О</td><td><p>Предпочитаемый язык ответов сервера.</p><p>en — английский; ru — русский. По умолчанию — ru</p></td></tr><tr><td>email</td><td>A..100</td><td>R</td><td>Адрес электронной почты пользователя</td></tr><tr><td>userdata</td><td>A..1000</td><td>О</td><td>Пользовательские данные.  Можно передать в этой строке любую информацию, которую нужно сохранить вместе с платежом, а потом получить её с помощью метода <a href="/pages/BRQsfP0nwRNWD56Tfuwe#_getadvancedstatus">GetAdvancedStatus</a></td></tr><tr><td>customer_id</td><td>A..100</td><td>О</td><td>Идентификатор пользователя. Показывает для какого пользователя будет сохранена карта</td></tr><tr><td>antifraud_*</td><td>A..100</td><td>О</td><td>Дополнительные параметры для системы антифрод. Можно передать любые параметры, начинающиеся с antifraud_</td></tr><tr><td>user_entered_*</td><td>A..100</td><td>О</td><td>Можно указать дополнительные поля для оплаты, начинающиеся с user_entered_. Затем все эти поля возвращаются в <a href="/pages/BRQsfP0nwRNWD56Tfuwe#_getadvancedstatus">GetAdvancedStatus</a> в поле user_entered_params</td></tr><tr><td>payer_ip</td><td>A</td><td>R</td><td>IP-адрес браузера покупателя</td></tr><tr><td>browserAccept</td><td>A</td><td>R</td><td>Заголовок Accept из браузера покупателя</td></tr><tr><td>browserLanguage</td><td>A</td><td>R</td><td>Язык браузера устройства покупателя.<br>en — английский; ru — русский</td></tr><tr><td>browserUserAgent</td><td>A</td><td>R</td><td>Содержание заголовка User-Agent в браузере покупателя</td></tr><tr><td>browserJavaEnabled</td><td>B</td><td>R</td><td>Признак возможности выполнения Java в браузере устройства покупателя</td></tr><tr><td>browserJavascriptEnabled</td><td>B</td><td>O</td><td>Признак возможности выполнения JavaScript в браузере устройства покупателя.<br>По умолчанию — true</td></tr><tr><td>browserScreenHeight</td><td>A</td><td>R</td><td>Общая высота экрана устройства покупателя в пикселях</td></tr><tr><td>browserScreenWidth</td><td>A</td><td>R</td><td>Общая ширина экрана устройства покупателя в пикселях</td></tr><tr><td>browserColorDepth</td><td>A</td><td>R</td><td>Глубина цветопередачи в битах</td></tr><tr><td>browserTZ</td><td>A</td><td>R</td><td>Часовой пояс — разница (в минутах) во времени между временем по UTC и местным временем браузера на устройстве покупателя</td></tr><tr><td>threeDsNotificationUrl</td><td>A</td><td>R</td><td>URL получения результата 3DS challenge</td></tr></tbody></table>

**Параметры ответа:**

Формат ответа совпадает форматом ответа [PayMerchant](/ru-api/metody-api/platezhi.md#paymerchant)

### GetStatusSaveCard

Запрос статуса сохранённой карты.

**Формат запроса:** [https://{host}.payler.com/{api}/GetStatusSaveCard](about:blank)

**Доступно для:** gapi, mapi, cgapi, cmapi

**Метод отправки запроса:** <mark style="color:green;background-color:green;">**`POST`**</mark>

**Параметры запроса:**

<table data-header-hidden><thead><tr><th width="150"></th><th width="150"></th><th width="150"></th><th></th></tr></thead><tbody><tr><td><strong>Название</strong></td><td><strong>Тип</strong></td><td><strong>R/O</strong></td><td><strong>Описание</strong></td></tr><tr><td>key</td><td>A..100</td><td>R</td><td>Идентификатор мерчанта. Выдается с параметрами доступа</td></tr><tr><td>session_id</td><td>A..100</td><td>O</td><td>Идентификатор сессии, по которой требуется получить информацию. Если не указан, должен быть указан параметр card_id</td></tr><tr><td>card_id</td><td>A..100</td><td>O</td><td>Идентификатор карты, по которой требуется получить информацию. Если не указан, должен быть указан параметр session_id</td></tr></tbody></table>

**Параметры ответа:**

<table data-header-hidden><thead><tr><th></th><th width="150"></th><th width="150"></th><th></th></tr></thead><tbody><tr><td>Н<strong>азвание</strong></td><td><strong>Тип</strong></td><td><strong>R/O</strong></td><td><strong>Описание</strong></td></tr><tr><td>card_id</td><td>A..100</td><td>R</td><td>Идентификатор карты</td></tr><tr><td>card_status</td><td>A</td><td>R</td><td><p>Статус карты.</p><p><strong>Saved</strong> — карта сохранена и готова к использованию.</p><p><strong>Invalid</strong> — карта недействительна (например, истёк срок её действия)</p></td></tr><tr><td>card_number</td><td>A..19</td><td>R</td><td>Маскированный номер карты. Оставлены первые 6 и последние 4 цифры, остальные заменены на ‘x’</td></tr><tr><td>card_holder</td><td>A..100</td><td>R</td><td>Имя владельца карты</td></tr><tr><td>expired_year</td><td>N2</td><td>R</td><td>Год истечения срока действия карты</td></tr><tr><td>expired_month</td><td>N2</td><td>R</td><td>Месяц истечения срока действия карты</td></tr><tr><td>recurrent_template_id</td><td>A..100</td><td>O</td><td>Идентификатор шаблона рекуррентных платежей</td></tr><tr><td>customer_id</td><td>A..100</td><td>R</td><td>Идентификатор пользователя</td></tr></tbody></table>

Пример ответа на успешный запрос:

```json
{
         "card_status": "Saved",
         "card_id": "ZRzroTofO42UkBv5vsMmckgU3Dowz7J4UhMZ",
         "card_number": "400000xxxxxx0093",
         "card_holder": "NONAME",
         "expired_year": 25,
         "expired_month": 12,
         "customer_id": "BCaFGEp8gQhT1XXFs1HEf5LRFstC4efydqxv"
}
```

### GetCardList <a href="#getcardlist" id="getcardlist"></a>

Запрос на получение списка сохраненных карт.

**Формат запроса:** [https://{host}.payler.com/{api}/GetCardList](about:blank)

**Доступно для:** gapi, mapi, cgapi, cmapi

**Метод отправки запроса:** <mark style="color:green;background-color:green;">**`POST`**</mark>

**Параметры запроса:**

<table data-header-hidden><thead><tr><th width="165"></th><th width="150"></th><th width="150"></th><th></th></tr></thead><tbody><tr><td><strong>Название</strong></td><td><strong>Тип</strong></td><td><strong>R/O</strong></td><td><strong>Описание</strong></td></tr><tr><td>key</td><td>A..100</td><td>R</td><td>Идентификатор мерчанта. Выдается с параметрами доступа</td></tr><tr><td>customer_id</td><td>A..100</td><td>R</td><td>Идентификатор пользователя. Будут возвращены карты, принадлежащие этому пользователю</td></tr></tbody></table>

**Параметры ответа:**

<table data-header-hidden><thead><tr><th width="243.67877726936223"></th><th width="150"></th><th width="150"></th><th></th></tr></thead><tbody><tr><td><strong>Название</strong></td><td><strong>Тип</strong></td><td><strong>R/O</strong></td><td><strong>Описание</strong></td></tr><tr><td>cards</td><td>Ar</td><td>R</td><td>Список карт</td></tr><tr><td>cards/card_id</td><td>A..100</td><td>R</td><td>Идентификатор карты</td></tr><tr><td>cards/customer_id</td><td>A..100</td><td>R</td><td>Идентификатор пользователя</td></tr><tr><td>cards/card_status</td><td>A</td><td>R</td><td><p>Статус карты.</p><p><strong>Saved</strong> — карта сохранена и готова к использованию.</p><p><strong>Invalid</strong> — карта недействительна (например, истёк срок её действия)</p></td></tr><tr><td>cards/card_number</td><td>A..19</td><td>R</td><td>Маскированный номер карты. Оставлены первые 6 и последние 4 цифры, остальные заменены на ‘x’</td></tr><tr><td>cards/card_holder</td><td>A..100</td><td>R</td><td>Имя владельца карты</td></tr><tr><td>cards/expired_year</td><td>N2</td><td>R</td><td>Год истечения срока действия карты</td></tr><tr><td>cards/expired_month</td><td>N2</td><td>R</td><td>Месяц истечения срока действия карты</td></tr><tr><td>cards/recurrent_template_id</td><td>A..100</td><td>O</td><td>Идентификатор шаблона рекуррентных платежей. Присутствует если по карте создан шаблон рекуррентных платежей<br></td></tr></tbody></table>

Пример ответа на успешный запрос:

```json
{
         "cards": [
         {
            "card_status": "Saved",
            "card_id": "Zk8ou8tcfiitc31DwJPOIIOwC8oFZOlIDknL",
  "customer_id": "jsdlf8sDD9LhO19sVYotkJ2gHSPs5E4Qph14"
            "card_number": "452427xxxxxx1232",
            "card_holder": "IVAN PETROV",
            "expired_year": 17,
            "expired_month": 7
      },
         {
            "card_status": "Saved",
            "card_id": "OvzLAlY3twt5GYnm2ddGiixha1tNSHJcXk2k",
            "customer_id": "sdkKhnf23ds987K8bsdj79ldn23fsldmMJ",
            "card_number: "415432xxxxxx8564",
         "card_holder": "PETR IVANOV",
        "expired_year": 16,
        "expired_month": 9
         }
         ]
}
```

### RemoveCard <a href="#id-6vffpfcbtdzg" id="id-6vffpfcbtdzg"></a>

Запрос удаления сохранённой карты.

**URL запроса:** [https://{host}.payler.com/{api}/RemoveCard](about:blank)

**Доступно для:** gapi, mapi, cgapi, cmapi

**Метод отправки запроса:** <mark style="color:green;background-color:green;">**`POST`**</mark>

**Параметры запроса:**

<table data-header-hidden><thead><tr><th width="167.7142857142857"></th><th width="150"></th><th width="150"></th><th></th></tr></thead><tbody><tr><td><strong>Название</strong></td><td><strong>Тип</strong></td><td><strong>R/O</strong></td><td><strong>Описание</strong></td></tr><tr><td>key</td><td>A..100</td><td>R</td><td>Идентификатор мерчанта. Выдается с параметрами доступа</td></tr><tr><td>card_id</td><td>A..100</td><td>R</td><td>Идентификатор карты по которой требуется получить информацию</td></tr></tbody></table>

**Параметры ответа:**

<table data-header-hidden><thead><tr><th width="169"></th><th width="150"></th><th width="150"></th><th></th></tr></thead><tbody><tr><td><strong>Название</strong></td><td><strong>Тип</strong></td><td><strong>R/O</strong></td><td><strong>Описание</strong></td></tr><tr><td>changed</td><td>B</td><td>R</td><td><p>Показывает, привёл ли запрос к изменениям в системе.</p><p>1 — карта была удалена в результате этого запроса.</p><p>0 — карта была удалена ранее</p></td></tr></tbody></table>

Пример ответа на успешный запрос:

```json
{
         "changed": true
}
```

### CustomerRegister <a href="#customerregister" id="customerregister"></a>

Запрос регистрации нового пользователя.

**Формат запроса:** [https://{host}.payler.com/{api}/CustomerRegister](about:blank)

**Доступно для:** gapi, mapi, cgapi, cmapi

**Метод отправки запроса:** <mark style="color:green;background-color:green;">**`POST`**</mark>

**Параметры запроса:**

<table data-header-hidden><thead><tr><th></th><th width="150"></th><th width="150"></th><th></th></tr></thead><tbody><tr><td><strong>Название</strong></td><td><strong>Тип</strong></td><td><strong>R/O</strong></td><td><strong>Описание</strong></td></tr><tr><td>key</td><td>A..100</td><td>R</td><td>Идентификатор мерчанта. Выдается с параметрами доступа</td></tr><tr><td>customer_name</td><td>A..100</td><td>O</td><td>Имя пользователя</td></tr><tr><td>customer_phone</td><td>A..100</td><td>O</td><td>Номер телефона пользователя</td></tr><tr><td>customer_email</td><td>A..100</td><td>O</td><td>Адрес электронной почты пользователя</td></tr><tr><td>customer_fullName</td><td>A..100</td><td>O</td><td>Ф. И. О. пользователя</td></tr><tr><td>customer_address</td><td>A..100</td><td>O</td><td>Адрес пользователя</td></tr><tr><td>customer_documentType</td><td>A..60</td><td>O</td><td>Тип документа пользователя</td></tr><tr><td>customer_documentSeria</td><td>A..60</td><td>O</td><td>Серия документа пользователя</td></tr><tr><td>customer_documentNumber</td><td>A..60</td><td>O</td><td>Номер документа пользователя</td></tr></tbody></table>

**Параметры ответа:**

<table data-header-hidden><thead><tr><th></th><th width="150"></th><th width="150"></th><th></th></tr></thead><tbody><tr><td>Н<strong>азвание</strong></td><td><strong>Тип</strong></td><td><strong>R/O</strong></td><td><strong>Описание</strong></td></tr><tr><td>customer_id</td><td>A..100</td><td>R</td><td>Идентификатор пользователя</td></tr></tbody></table>

Пример ответа на успешный запрос:

```json
{
         "customer_id": "Wkl7nBsMhwQICc2I9wXncMeSwnIaucQ5BHyo"
}
```

### CustomerUpdate <a href="#id-1xziuz5exjq0" id="id-1xziuz5exjq0"></a>

Запрос обновления данных о пользователе.

**Формат запроса:** [https://{host}.payler.com/{api}/CustomerUpdate](about:blank)

**Доступно для:** gapi, mapi, cgapi, cmapi

**Метод отправки запроса:** <mark style="color:green;background-color:green;">**`POST`**</mark>

**Параметры запроса:**

<table data-header-hidden><thead><tr><th width="245.39938200077245"></th><th width="150"></th><th width="150"></th><th></th></tr></thead><tbody><tr><td><strong>Название</strong></td><td><strong>Тип</strong></td><td><strong>R/O</strong></td><td><strong>Описание</strong></td></tr><tr><td>key</td><td>A..100</td><td>R</td><td>Идентификатор мерчанта.<br>Выдается с параметрами доступа</td></tr><tr><td>customer_id</td><td>A..100</td><td>R</td><td>Идентификатор пользователя</td></tr><tr><td>customer_name</td><td>A..100</td><td>O</td><td>Имя пользователя</td></tr><tr><td>customer_phone</td><td>A..100</td><td>O</td><td>Номер телефона пользователя</td></tr><tr><td>customer_email</td><td>A..100</td><td>O</td><td>Адрес электронной почты пользователя</td></tr><tr><td>customer_fullName</td><td>A..100</td><td>O</td><td>Ф. И. О. пользователя</td></tr><tr><td>customer_address</td><td>A..100</td><td>O</td><td>Адрес пользователя</td></tr><tr><td>customer_documentType</td><td>A..60</td><td>O</td><td>Тип документа пользователя</td></tr><tr><td>customer_documentSeria</td><td>A..60</td><td>O</td><td>Серия документа пользователя</td></tr><tr><td>customer_documentNumber</td><td>A..60</td><td>O</td><td>Номер документа пользователя</td></tr></tbody></table>

**Параметры ответа:**

<table data-header-hidden><thead><tr><th width="157.7142857142857"></th><th width="150"></th><th width="150"></th><th></th></tr></thead><tbody><tr><td><strong>Название</strong></td><td><strong>Тип</strong></td><td><strong>R/O</strong></td><td><strong>Описание</strong></td></tr><tr><td>customer_id</td><td>A..100</td><td>R</td><td>Идентификатор пользователя</td></tr></tbody></table>

Пример ответа на успешный запрос:

```json
{
         "changed": true
}
```

### CustomerDelete <a href="#afao3wq4jbdf" id="afao3wq4jbdf"></a>

Запрос удаления пользователя.

**Формат запроса:** [https://{host}.payler.com/{api}/CustomerDelete](about:blank)

**Доступно для:** gapi, mapi, cgapi, cmapi

**Метод отправки запроса:** <mark style="color:green;background-color:green;">**`POST`**</mark>

**Параметры запроса:**

<table data-header-hidden><thead><tr><th width="174.7142857142857"></th><th width="150"></th><th width="150"></th><th></th></tr></thead><tbody><tr><td><strong>Название</strong></td><td><strong>Тип</strong></td><td><strong>R/O</strong></td><td><strong>Описание</strong></td></tr><tr><td>key</td><td>A..100</td><td>R</td><td>Идентификатор мерчанта. Выдается с параметрами доступа</td></tr><tr><td>customer_id</td><td>A..100</td><td>R</td><td>Идентификатор пользователя</td></tr></tbody></table>

**Параметры ответа:**

<table data-header-hidden><thead><tr><th width="181.33093988715564"></th><th width="160.11275230444684"></th><th width="150"></th><th></th></tr></thead><tbody><tr><td><strong>Название</strong></td><td><strong>Тип</strong></td><td><strong>R/O</strong></td><td><strong>Описание</strong></td></tr><tr><td>changed</td><td>B</td><td>R</td><td><p>Показывает, привёл ли запрос к изменениям в системе.</p><p>1 — плательщик был удалён в результате этого запроса,</p><p>0 — плательщик был удалён ранее</p></td></tr></tbody></table>

Пример ответа на успешный запрос:

```json
{
         "changed": true
}
```

### CustomerGetStatus <a href="#toc98799470" id="toc98799470"></a>

Проверка регистрации пользователя в системе.

**Формат запроса:** [https://{host}.payler.com/{api}/CustomerGetStatus](about:blank)

**Доступно для:** gapi, mapi, cgapi, cmapi

**Метод отправки запроса:** <mark style="color:green;background-color:green;">**`POST`**</mark>

**Параметры запроса:**

<table data-header-hidden><thead><tr><th width="176.98078462770218"></th><th width="150"></th><th width="150"></th><th></th></tr></thead><tbody><tr><td><strong>Название</strong></td><td><strong>Тип</strong></td><td><strong>R/O</strong></td><td><strong>Описание</strong></td></tr><tr><td>key</td><td>A..100</td><td>R</td><td>Идентификатор мерчанта. Выдается с параметрами доступа</td></tr><tr><td>customer_id</td><td>A..100</td><td>R</td><td>Идентификатор пользователя</td></tr></tbody></table>

**Параметры ответа:**

<table data-header-hidden><thead><tr><th width="150"></th><th width="150"></th><th width="150"></th><th></th></tr></thead><tbody><tr><td><strong>Название</strong></td><td><strong>Тип</strong></td><td><strong>R/O</strong></td><td><strong>Описание</strong></td></tr><tr><td>status</td><td>A..10</td><td>R</td><td><p>Показывает, активен ли пользователь.</p><p>Active — пользователь зарегистрирован в системе. Если пользователь не зарегистрирован, то в ответ на запрос вернется ошибка</p></td></tr></tbody></table>

Пример ответа на успешный запрос:

```json
{
         "status": "Active"
}
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.payler.com/ru-api/metody-api/sokhranenie-dannykh-kart.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.