sale.paysystem.update
Изменить платежную систему
Описание
Метод изменяет платежную систему.
Параметры
ID
sale_paysystem.ID
обязательный
Идентификатор платежной системы
FIELDS
object
необязательный
Объект, содержащий новые значения полей (подробное описание приведено ниже)
Параметр FIELDS
NAME
string
необязательный
Название платежной системы
DESCRIPTION
string
необязательный
Описание платежной системы
PERSON_TYPE_ID
sale_person_type.id
необязательный
Идентификатор типа плательщика
BX_REST_HANDLER
sale_paysystem_handler.CODE
необязательный
Код REST-обработчика, указанный при добавлении обработчика методом sale.paysystem.handler.add
ACTIVE
string
необязательный
Индикатор активности платежной системы. Возможные значения:
- Y — да
- N — нет
LOGOTYPE
string
необязательный
Логотип платежной системы (картинка в формате Base64)
NEW_WINDOW
string
необязательный
Флаг, отвечающий за настройку «Открывать в новом окне». Возможные значения:
- Y — да
- N — нет
XML_ID
string
необязательный
Внешний идентификатор платежной системы
Примеры запроса
curl -X POST \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{"ID":12,"FIELDS":{"NAME":"Новое название платёжной системы","DESCRIPTION":"Новое описание платёжной системы","PERSON_TYPE_ID":1,"BX_REST_HANDLER":"resthandlercode","ACTIVE":"Y","NEW_WINDOW":"N","LOGOTYPE":"/* base64 image */"}}' \
https://**put_your_bitrix24_address**/rest/**put_your_user_id_here**/**put_your_webhook_here**/sale.paysystem.update
curl -X POST \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{"ID":12,"FIELDS":{"NAME":"Новое название платёжной системы","DESCRIPTION":"Новое описание платёжной системы","PERSON_TYPE_ID":1,"BX_REST_HANDLER":"resthandlercode","ACTIVE":"Y","NEW_WINDOW":"N","LOGOTYPE":"/* base64 image */"},"auth":"**put_access_token_here**"}' \
https://**put_your_bitrix24_address**/rest/sale.paysystem.update
// This snippet is an ES module: top-level await requires type="module" or a bundler.
// $b24 is an already-initialized SDK instance (see the SDK "Get started" guide).
import { Text } from '@bitrix24/b24jssdk'
import type { B24Frame } from '@bitrix24/b24jssdk'
declare const $b24: B24Frame
try {
const response = await $b24.actions.v2.call.make<boolean>({
method: 'sale.paysystem.update',
params: {
ID: 12,
FIELDS: {
NAME: 'New payment system name',
DESCRIPTION: 'New payment system description',
PERSON_TYPE_ID: 1,
BX_REST_HANDLER: 'resthandlercode',
ACTIVE: 'Y',
NEW_WINDOW: 'N',
LOGOTYPE: '/* base64 image */',
},
},
requestId: Text.getUuidRfc4122()
})
// The payload is available only on a successful response
if (!response.isSuccess) {
console.error(response.getErrorMessages().join('; '))
} else {
const result = response.getData()!.result
console.info('Payment system updated:', result)
}
} catch (error) {
// Thrown on transport or SDK failures (AjaxError, SdkError, etc.)
console.error(error)
}
<!-- Load the SDK (UMD build); it is exposed as the global B24Js -->
<script src="https://unpkg.com/@bitrix24/b24jssdk@1/dist/umd/index.min.js"></script>
<script>
async function updatePaySystem() {
try {
// Initialize the SDK inside a Bitrix24 frame
const $b24 = await B24Js.initializeB24Frame()
const response = await $b24.actions.v2.call.make({
method: 'sale.paysystem.update',
params: {
ID: 12,
FIELDS: {
NAME: 'New payment system name',
DESCRIPTION: 'New payment system description',
PERSON_TYPE_ID: 1,
BX_REST_HANDLER: 'resthandlercode',
ACTIVE: 'Y',
NEW_WINDOW: 'N',
LOGOTYPE: '/* base64 image */',
},
},
requestId: B24Js.Text.getUuidRfc4122()
})
// The payload is available only on a successful response
if (!response.isSuccess) {
console.error(response.getErrorMessages().join('; '))
return
}
const result = response.getData().result
console.info('Payment system updated:', result)
} catch (error) {
// Thrown on transport or SDK failures (AjaxError, SdkError, etc.)
console.error(error)
}
}
document.addEventListener('DOMContentLoaded', updatePaySystem)
</script>
from b24pysdk.errors import BitrixAPIError, BitrixSDKException
fields = {
"NAME": "New payment system name",
"DESCRIPTION": "New payment system description",
"PERSON_TYPE_ID": 1,
"BX_REST_HANDLER": "resthandlercode",
"ACTIVE": "Y",
"NEW_WINDOW": "N",
"LOGOTYPE": "/* base64 image */",
}
try:
bitrix_response = client.sale.paysystem.update(
bitrix_id=12,
fields=fields,
).response
result = bitrix_response.result
print(result)
except BitrixAPIError as error:
print(
"Ошибка Bitrix API",
f"error: {error.error}",
f"error_description: {error.error_description}",
sep="\n",
)
except BitrixSDKException as error:
print(f"Ошибка Bitrix SDK: {error.message}")
except Exception as error:
print(f"Непредвиденная ошибка: {error}")
try {
$response = $b24Service
->core
->call(
'sale.paysystem.update',
[
'ID' => 12,
'FIELDS' => [
'NAME' => 'Новое название платёжной системы',
'DESCRIPTION' => 'Новое описание платёжной системы',
'PERSON_TYPE_ID' => 1,
'BX_REST_HANDLER' => 'resthandlercode',
'ACTIVE' => 'Y',
'NEW_WINDOW' => 'N',
'LOGOTYPE' => '/* base64 image */',
],
]
);
$result = $response
->getResponseData()
->getResult();
echo 'Success: ' . print_r($result, true);
} catch (Throwable $e) {
error_log($e->getMessage());
echo 'Error updating payment system: ' . $e->getMessage();
}
BX24.callMethod('sale.paysystem.update',
{
"ID": 12,
"FIELDS": {
"NAME": "Новое название платёжной системы",
"DESCRIPTION": "Новое описание платёжной системы",
"PERSON_TYPE_ID": 1,
"BX_REST_HANDLER": 'resthandlercode',
"ACTIVE": 'Y',
'NEW_WINDOW': 'N',
'LOGOTYPE': '/* base64 image */',
}
},
function(result)
{
if(result.error())
{
console.error(result.error());
}
else
{
console.info(result.data());
}
}
);
require_once('crest.php');
$result = CRest::call(
'sale.paysystem.update',
[
'ID' => 12,
'FIELDS' => [
'NAME' => 'Новое название платёжной системы',
'DESCRIPTION' => 'Новое описание платёжной системы',
'PERSON_TYPE_ID' => 1,
'BX_REST_HANDLER' => 'resthandlercode',
'ACTIVE' => 'Y',
'NEW_WINDOW' => 'N',
'LOGOTYPE' => '/* base64 image */',
]
]
);
echo '<PRE>';
print_r($result);
echo '</PRE>';
// client и ctx уже созданы — см. раздел «SDK для Go»
res, err := client.Core().Call(ctx, "sale.paysystem.update", b24.Params{
"ID": 12,
"FIELDS": b24.Params{
"NAME": "Новое название платёжной системы",
"DESCRIPTION": "Новое описание платёжной системы",
"PERSON_TYPE_ID": 1,
"BX_REST_HANDLER": "resthandlercode",
"ACTIVE": "Y",
"NEW_WINDOW": "N",
"LOGOTYPE": "/* base64 image */",
},
})
if err != nil {
return fmt.Errorf("sale.paysystem.update: %w", err)
}
var ok bool
if err := json.Unmarshal(res.Result, &ok); err != nil {
return fmt.Errorf("разбор ответа: %w", err)
}
fmt.Println("выполнено:", ok)
Ответ
HTTP-статус: 200
{
"result": true,
"time": {
"start": 1712135335.026931,
"finish": 1712135335.407762,
"duration": 0.3808310031890869,
"processing": 0.0336611270904541,
"date_start": "2024-04-03T11:08:55+02:00",
"date_finish": "2024-04-03T11:08:55+02:00",
"operating_reset_at": 1705765533,
"operating": 3.3076241016387939
}
}
Возвращаемые данные
result
boolean
Результат обновления платежной системы
time
time
Информация о времени выполнения запроса
Обработка ошибок
HTTP-статус: 400
{
"error": "ERROR_HANDLER_NOT_FOUND",
"error_description": "Handler not found"
}
| Код | Описание | Значение |
|---|---|---|
ACCESS_DENIED |
Доступ запрещен. Приложение пытается изменить платежную систему, добавленную другим приложением, либо недостаточно прав для изменения платежной системы | 403 |
ERROR_HANDLER_NOT_FOUND |
Обработчик, указанный в параметре BX_REST_HANDLER, не найден |
400 |
ERROR_PERSON_TYPE_NOT_FOUND |
Тип плательщика, указанный в параметре PERSON_TYPE_ID, не найден |
400 |
ERROR_PAY_SYSTEM_NOT_FOUND |
Платежная система с указанным ID не найдена |
400 |
ERROR_CHECK_FAILURE |
Не указан параметр ID |
400 |

