Интеграция OSMI Cards

Как настроить интеграцию OSMI Cards

Порядок настройки, ограничения и возможности указаны по ссылке (Интеграция с OSMI Cards).

Первый шаг в настройке интеграции — создание точки интеграции.

Тип пресета — «Другое. Для создания и настройки интеграции с внешней системой.»

Второй шаг — создание шаблона действия.

1. UpdateCard
Обновление электронной карты

Третий шаг - создание балльного счета

Если бальный счет создан, то этот шаг можно пропустить.

Четвертый шаг - создание дополнительных полей

1. WalletCardLink
Ссылка на установку электронной карты

2. WalletCardSubscription
Подписан на рассылки

3. WalletCardQrCodeLink
Ссылка на qr-код установки карты

Пятый шаг - создание типа дисконтных карт

Шестой шаг — создание вебхуков

Создать вебхук необходимо после того, как менеджер OSMI Cards передаст вам шаблон.
1. Создание карты OSMI
POST

https://[URL полученный от OSMI или клиента]/v2t/passes/${Recipient.Card.[тип карты].Number}/[название шаблона дизайна дисконтной карты полученный от OSMI или клиента]?withValues=true&transactionId=${WebhookRequest.TransactionalId}

Content-Type

application/json

Authorization

Bearer xxxxx где xxxxx это токен, который получен от менеджера OSMI

Тело запроса

{
"values": [
    {
    "label": "[название поля "клиент" полученное от OSMI или клиента]",
    "value": "@{if IsEmpty(Recipient.OnlyStandardFirstName)}@{ else }${Recipient.FirstAndLastName}@{end if}"
    },
    {
    "label": "["название поля "баллы" полученное от OSMI или клиента]",
    "value": "${Recipient.GetBonusPointsAccount("[название бального счета в Mindbox]").Available}"
    }
],
   "barcode": {
        "show": true,
        "showSignature": true,
        "message": "${Recipient.Card.AnyType.Number}",
        "signature": "${Recipient.Card.AnyType.Number}"
    }
}

2. Обновление баланса карты OSMI
PUT

https://[URL полученный от OSMI или клиента]/v2t/passes/${Recipient.Card.[тип карты].Number}?transactionId=${WebhookRequest.TransactionalId}&push=true

Content-Type

application/json

Authorization

Bearer xxxxx где xxxxx это токен, который получен от менеджера OSMI

Тело запроса

{
"values": [
    {
    "label": "[название поля "клиент" полученное от OSMI или клиента]",
    "value": "@{if IsEmpty(Recipient.OnlyStandardFirstName)}@{ else }${Recipient.FirstAndLastName}@{end if}"
    },
    {
    "label": "[название поля "баллы" полученное от OSMI или клиента]",
    "value": "${Recipient.GetBonusPointsAccount("[название бального счета в Mindbox]").Available}"
    }
],
   "barcode": {
        "show": true,
        "showSignature": true,
        "message": "${Recipient.Card.AnyType.Number}",
        "signature": "${Recipient.Card.AnyType.Number}"
    }
}

В теле запроса могут быть дополнительные параметры полей, в зависимости от потребностей клиента. 

Седьмой шаг— создание сценариев

1. OSMI - Изменение баланса

• Событие — «Изменение баланса» в выбранном счете:
  

• Группа шагов — вызвать вебхук и выдать действие:
  

2. OSMI - Создание карты

• Событие — зависит от выборки, которая должна получить карты. Это может быть любое попадание в базу или регистрация через определенную операцию, например:
  

• Проверяем, что нет карт OSMI:
  

• Выдаем карту и вызываем вебхук:
  

• Ограничиваем срабатывание одним разом на клиента:
  

Восьмой шаг — создание операций

Операции необходимо создавать с теми настройками и именами, которые указаны в инструкции:
1. Wallet.BindCard

2. Wallet.CheckCustomerByMobilePhone

3. Wallet.EditCustomer

4. Wallet.RegisterCustomer

5. Wallet.SubscribeCard

6. Wallet.UnsubscribeCard

7. Wallet.UpdateCard

8. Wallet.SetCardLink

После этого, можно считать, что все необходимые механики созданы.