Примеры настройки подарочных карт

Эта статья описывает три типовых сценария работы с подарочными картами:

1. Карты с фиксированным номиналом
2. Карты с произвольной суммой
3. Миграция проданных карт из других систем.

Кейс 1: Карта с фиксированным номиналом и CVVКейс 1: Карта с фиксированным номиналом и CVV

Описание сценарияОписание сценария

Компания продает физические или электронные подарочные карты с параметрами:

• Номинал: 1000 ₽
• CVV: обязателен
• Срок действия карты: 3 года с момента продажи

Пул подарочных картПул подарочных карт

Импортируйте пул со следующими параметрами:

• Фиксированный номинал (Amount): 1000
• Требовать CVV (IsCvvRequired): true
• Срок действия 3 года:
  • ExpirationType: Year
  • Expiration: 3

Пример импорта пула:

PoolName;PoolSystemName;ProductExternalId;ExternalSystem;Amount;IsCvvRequired;ExpirationType;Expiration;
        Подарочная карта на 1000;Gift1000Cvv3y;Gift1000Cvv3y;Site;1000;true;Year;3;
        

Импорт картИмпорт карт

Пример файла импорта карт:

Number;PoolSystemName;Cvv;Amount;Status;
        1234;Gift1000Cvv3y;123;1000;Inactive;
        5678;Gift1000Cvv3y;456;1000;Inactive;
        

Кейс 2: Карта с произвольной суммой (сумма задается при продаже)Кейс 2: Карта с произвольной суммой (сумма задается при продаже)

Описание сценарий:Описание сценарий:

Компания продает подарочные карты с произвольной суммой, которую клиент выбирает при покупке (например, от 500 до 10 000 ₽).

• Номинал: задается при продаже
• CVV: не используется
• Срок действия: 3 года с момента продажи

Пул подарочных картПул подарочных карт

Создайте пул со следующими параметрами:

• Без фиксированного номинала (IsCustomAmount): true
• Требовать CVV (IsCvvRequired): false
• Срок действия 3 года:
  • ExpirationType: Year
  • Expiration: 3

Файл импорта пула:

PoolName;PoolSystemName;ProductExternalId;ExternalSystem;IsCvvRequired;ExpirationType;Expiration;IsCustomAmount;
        Подарочная карта без фиксированного номинала;GiftOpenAmount3y;GiftOpenAmount3y;Site;false;Year;3;true;
        

Импорт картИмпорт карт

Для карт с произвольной суммой не нужно указывать номинал карты (Amount).

Пример файла импорта карт:

Number;PoolSystemName;Status;
        1234;Gift1000Cvv3y;Inactive;
        5678;Gift1000Cvv3y;Inactive;
        

Кейс 3: Импорт проданных карт (миграция)Кейс 3: Импорт проданных карт (миграция)

Описание сценарияОписание сценария

Компания переносит подарочные карты из старой системы:

• Карты уже были проданы ранее;
• Известна дата продажи;
• Карты должны быть активными;
• Срок действия считается от даты покупки в прошлом.

Пул подарочных картПул подарочных карт

Создайте пул со следующими параметрами:

• Фиксированный номинал (Amount): 3000 ₽
• Срок действия 3 года:
• ExpirationType: Year
• Expiration: 3 года

Файл импорта пула:

PoolName;PoolSystemName;ProductExternalId;ExternalSystem;IsCvvRequired;ExpirationType;Expiration;Amount;
        Подарочная карта на 3000;Gift3000Migration3y;Gift3000Migration3y;Site;false;Year;3;3000;
        

Импорт картИмпорт карт

Передайте дополнительные поля:

• PurchasePointOfContact - идентификатор точки контакта, где карта была выдана.

  Как определить значение PurchasePointOfContact

  1. Перейдите в раздел Настройки → Клиенты и действия → Точки контакта.
  2. Найдите нужную точку контакта по его названию. Для импорта нужно значение из колонки «Внешний идентификатор»:
     

• PurchaseDateTimeUtc - дата и время покупки в UTC.

Карты должны быть в статусе **CanBeUsed**.

Пример файла импорта карт:

Number;PoolSystemName;Amount;Status;PurchasePointOfContact;PurchaseDateTimeUtc;
        1234;Gift3000Migration3y;3000;CanBeUsed;offline_store_12;2025-05-10;
        5678;Gift3000Migration3y;3000;CanBeUsed;offline_store_12;2025-05-10;