Подарочные карты
Введение

Продукт Подарочные карты предоставляется банком-партнером на базе карточного продукта Prepaid.

Для начала работы с данным продуктом необходимо через персонального менеджера сделать запрос на подключение к этому продукту и заключить соглашение о сотрудничестве с банком-партнером.

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

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

Процесс выпуска карты
Список продуктов

Метод позволяет получить список продуктов, доступных для выпуска.
Метод возвращает только доступные для мерчанта продукты подарочных карт
Тело запроса
{
}
Ответ
{
  "datetime": "2022-05-01 12:01:15",
  "status": 0,
  "product_list": [
    {
      "code": 1,
      "name": "Карты Альфа-Банка",
      "name_en": "AlfaBank card"
      "currency": "USD",
      "balance": 50,
      "image": "url"
    },
    {
      "code": 2,
      "name": "Карты Сбербанка",
      "name_en": "Sberbank card"
      "currency": "USD",
      "balance": 100,
      "image": "url"
    }
  ]
}
Описание поле
Выпуск карты

Метод позволяет выпустить подарочную карту на стороне банка-партнера.

В случае успешной операции выпуска карты, на указанный номер телефона будет отправлена SMS с кодом подтверждения.
Тело запроса
{
  "cardholder_name": "IVANOV IVAN IVANOVICH",
  "phone": 79651234567,
  "product_code": 1
}
Описание полей
card_id используется только в массовом выпуске карт, когда мерчант заранее получить card_id
Ответ
{
  "datetime": "2022-05-01 12:01:15",
  "status": 0,
  "card_id": 555
}
Описание полей
Подтверждение карты

После запроса на выпуск карты, требуется подтвердить номер телефона клиента с помощью OTP кода, отправленного ему в SMS.

В случае успешного проведения операции, банк активирует карту на своей стороне и высылает пользователю SMS с недостающей частью номера карты, CVV, EXP DATE, номинал/валюта.
Тело запроса
{
  "otp": "1234",
  "card_id": 555
}
Описание полей
Ответ
{
  "datetime": "2022-05-01 12:01:15",
  "status": 0,
  "card_status": 1,
  "card_currency": "USD",
  "card_balance": 100, 
  "card_mask": "1234********5678"
}
Описание полей
Повторная отправка OTP

Если при подтверждении выпуска карты была получена ошибка "Некорректный OTP" или клиент не получил SMS, есть возможность запросить OTP повторно.
Тело запроса
{
  "card_id": 555
}
Описание полей
Ответ
{
  "datetime": "2022-05-01 12:01:15",
  "status": 0
}
Описание полей
Повторная отправка данных карты

Метод позволяет повторно выслать клиенту SMS с реквизитами карты.
Ответ
{
  "datetime": "2022-05-01 12:01:15",
  "status": 0
}
Описание полей
Ответ
{
  "datetime": "2022-05-01 12:01:15",
  "status": 0
}
Описание полей
Информация по карте

Метод позволяет получить информацию по карте, включая ее статус
Ответ
{
  "card_id": 555
}
Описание полей
Ответ
{
  "datetime": "2022-05-01 12:01:15",
  "status": 0,
  "card_status": 1,
  "card_currency": "USD",
  "card_balance": 100
}
Описание полей