Документация для разработчиков
Темная тема

Add

Описание и параметры

int
CSaleUserCards::Add(
	array arFields
);

Метод сохраняет информацию о новой пластиковой карте пользователя. Нестатический метод.

Параметры

ПараметрОписание
arFields Ассоциативный массив параметров пластиковой карты с ключами:
  • USER_ID - код пользователя;
  • SORT - индекс сортировки;
  • PAY_SYSTEM_ACTION_ID - код обработчика платежной системы;
  • CURRENCY - валюта, которую можно снимать с карты;
  • CARD_CODE - CVC2;
  • CARD_TYPE - тип карты;
  • CARD_NUM - номер карты;
  • CARD_EXP_MONTH - месяц окончания действия карты;
  • CARD_EXP_YEAR - год окончания действия карты;
  • DESCRIPTION - краткое описание;
  • SUM_MIN - минимальная сумма, которую можно снять с карты за раз;
  • SUM_MAX - максимальная сумма, которую можно снять с карты за раз;
  • SUM_CURRENCY - валюта минимальной и максимальной сумм;
  • LAST_STATUS - статус последнего использования карты;
  • LAST_STATUS_CODE - код статуса последнего использования карты;
  • LAST_STATUS_DESCRIPTION - описание статуса последнего использования карты;
  • LAST_STATUS_MESSAGE - сообщение платежной системы;
  • LAST_SUM - последняя снятая с карты сумма;
  • LAST_CURRENCY - валюта последней снятой с карты суммы;
  • ACTIVE - флаг активности;
  • LAST_DATE - дата последнего использования карты.

Замечание: перед добавлением записи номер карты должен быть зашифрован методом CSaleUserCards::CryptData.

Возвращаемые значения

Метод возвращает код добавленной записи или false в случае ошибки.

Пример использования

<?
// Сохраним новую карту текущего пользователя

if (CSaleUserCards::CheckPassword())
{
	$arFields = array(
		"USER_ID" => $USER->GetID(),
		"ACTIVE" => "Y",
		"SORT" => "100",
		"PAY_SYSTEM_ACTION_ID" => 11,
		"CURRENCY" => "USD",
		"CARD_TYPE" => 
			CSaleUserCards::IdentifyCardType("4111111111111"),
		"CARD_NUM" => 
			CSaleUserCards::CryptData("4111111111111", "E"),
		"CARD_EXP_MONTH" => 11,
		"CARD_EXP_YEAR" => 2007,
		"DESCRIPTION" => false,
		"CARD_CODE" => "123",
		"SUM_MIN" => False,
		"SUM_MAX" => False,
		"SUM_CURRENCY" => False
	);

	$UserCardID = CSaleUserCards::Add($arFields);
}
?>


© «Битрикс», 2001-2024, «1С-Битрикс», 2024