Подарочные карты

Введение

Продукт Подарочные карты предоставляется банком-партнером на базе карточного продукта 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
}
Описание полей