Возврат платежа

URL

Тип запроса

POST

Заголовки

Название
Значение
Accept:
application/json;
Accept-Encoding:
UTF-8;
Content-Type:
application/json; charset=UTF-8;

Тело запроса

1
{
2
"storeId" : “asfdasdfasdf",
3
"orderId" : "ORDER-3196fa3007bc4b6dab8",
4
"amount": 300.00,
5
"recipientId":"qwerty1234",
6
"signature" : "vBh0dOhvJuUz1tKOrNVZy/Q34zo="
7
}
Copied!

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

Поле
Формат
Описание
Обязательное
storeId
Идентификатор магазина
Да
orderId
64 символа
Уникальный номер платежа
Да
amount
Окончательная сумма покупки
Да
recipientId
Идентификатор получателя, по умолчанию берется основной получатель. Установка основного получателя происходит в профиле магазина.
Нет
signature
Уникальная подпись транзакции
Да

Расчет сигнатуры для запроса

SIGNATURE - подпись запроса, обязательный параметр считается по формуле : encodeBase64 ( SHA1 ( password + storeId + orderId + withoutFloatingPoint(amount) + password )), где:
  • encodeBase64 () - Функция зашифровывает строку в формате BASE64;
  • SHA1 () - Стандартная хеш-функция SHA-1, должна возвращать бинарные данные;
  • withoutFloatingPoint () - Функция возвращает число без плавающей точки ;
  • "+" - Конкатенация текстовой строки.
Параметр
Значение
password
Пароль вашего магазина
storeId
Идентификатор магазина
orderId
Уникальный номер платежа
amount
Окончательная сумма покупки, без плавающей точки (запятой). Пример: "Amount": 301.00, то в сигнатуру необходимо передать 30100
password
Пароль вашего магазина

Успешный ответ

1
{
2
state: "SUCCESS",
3
storeId: "X1114B6L",
4
orderId: "ORDER-3196fa3007bc4b6dab8",
5
signature: "2CnBRCAqV/BfNghrHUvHjEcGJZk="
6
}
Copied!

Ответ с ошибкой

1
{
2
state: "FAIL"
3
storeId: "X1114B6L"
4
orderId: "ORDER-3196fa3007bc4b6dab8",
5
message: "Платеж не найден",
6
signature: "2CnBRCAqV/BfNghrHUvHjEcGJZk="
7
}
Copied!

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

Состояние
Описание
state
SUCCESS - Операция проведена успешно, FAIL - Возникла ошибка
storeId
Идентификатор магазина
orderId
Уникальный номер платежа
message
Сообщение об ошибке
signature
Подпись запроса

Расчет сигнатуры для ответа

SIGNATURE = encodeBase64 ( SHA1 ( password + state + storeId + orderId + paymentState + message + password ))
  • encodeBase64 () - Функция зашифровывает строку в формате BASE64;
  • SHA1 () - Стандартная хеш-функция SHA-1, должна возвращать бинарные данные;
  • + - Конкатенация текстовой строки.
Параметр
Значение
password
Пароль вашего магазина
state
Результат отработки запроса
storeId
Идентификатор магазина
orderId
Уникальный номер платежа
message
В случае ошибки, содержит сообщение ошибки
password
Пароль вашего магазина