Перевести бонусы на счет другого клиента
POST /bonus/transferBonus#
POST /bonus/transferBonusОписание#
Метод предназначен для перевода бонусов с одного бонусного счета на другой. В ответ метод возвращает на кассу JSON-структуру с подробностями транзакции и необходимыми данными для её подтверждения если требуется
Параметры#
| Тип | Имя | Описание | Схема |
|---|---|---|---|
| Query | apiKey обязательно | Апи ключ | string |
| Query | bonusAmount обязательно | Количество бонусов для перевода | number (double) |
| Query | bonusCode обязательно | Код типа бонуса | string |
| Query | needConfirmBySMS обязательно | Флаг указывающий на необходимость подтверждения операции | boolean |
| Query | receiverCode обязательно | Внутренний код получателя | string |
| Query | receiverPhone обязательно | Телефон получателя | string |
| Query | retailer обязательно | Код торговой сети | string |
| Query | senderCode обязательно | Внутренний код отправителя | string |
| Query | senderPhone обязательно | Телефон отправителя | string |
Ответы#
| HTTP код | Описание | Схема |
|---|---|---|
| 200 | successful operation | BonusTransferTransactionJSON |
| 800 | Ошибка определения покупателя | Без содержимого |
| 801 | Неизвестный код торговой сети | Без содержимого |
| 816 | Не указан номер телефона отправителя для подтверждения операции | Без содержимого |
| 820 | Сумма списания не должна быть больше доступного для списания баланса по бонусному счету, отмена выполнения транзакции | Без содержимого |
| 821 | Сумма списания не должна быть меньше 0, отмена выполнения транзакции | Без содержимого |
| 827 | Транзакция не подтверждена | Без содержимого |
| 828 | У отправителя не существует бонусного счёта | Без содержимого |
Возвращает#
application/json
POST /bonus/confirmBonusTransfer#
POST /bonus/confirmBonusTransferОписание#
Метод предназначен для подтверждения перевода бонусов с одного бонусного счета на другой
Параметры#
| Тип | Имя | Описание | Схема |
|---|---|---|---|
| Query | apiKey обязательно | Апи ключ | string |
| Query | pass обязательно | Одноразовый пароль для подтверждения транзакции перевода бонусов, высланный отправителю | string |
| Query | retailer обязательно | Код торговой сети | string |
| Query | transactionId обязательно | Код созданной транзакции, ожидающей подтверждения | string |
Ответы#
| HTTP код | Описание | Схема |
|---|---|---|
| 801 | Неизвестный код торговой сети | Без содержимого |
| 824 | Код подтверждения указан неверно | Без содержимого |
| 827 | Транзакция не подтверждена | Без содержимого |
| 828 | Транзакция не найдена по идентификатору | Без содержимого |
Возвращает#
application/json
Определения#
BonusTransferTransactionJSON#
| Имя | Описание | Схема |
|---|---|---|
| receiverCode обязательно | Код получателя бонусов | string |
| receiverName обязательно | Имя получателя бонусов | string |
| senderCode обязательно | Код отправителя бонусов | string |
| senderName обязательно | Имя отправителя бонусов | string |
| status обязательно | Статус транзакции - Pending/Completed | enum (Pending, Completed) |
| transactionId обязательно | Код бонусной транзакции | string |