Подарочные карты Cards API| Документация Paybox Россия

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

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

Тело запроса


{
  "card_id": 555
}

Описание полей

Ответ


{
  "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
}

Описание полей