Запрос CURRENCY_RATES используется для получения курсов валют в системе wayforpay.
Параметры запроса:
Запрос c необходимыми параметрами формируется на стороне торговца и передается методом POST по протоколу HTTP на URL https://api.wayforpay.com/api
В целях подтверждения валидности данных должна быть сгенерирована и передана в запросе HMAC_MD5 контрольная подпись с использованием SecretKey торговца.
Строка, подлежащая HMAC_MD5, генерируется путем конкатенации парамаетров merchantAccount, orderDate разделенных “;” (точка с запятой) в кодировке UTF-8
| Параметр | Описание | Обязательное |
|---|---|---|
| transactionType | CURRENCY_RATES | да |
| merchantAccount | Идентификатор продавца. | да |
| merchantSignature | Подпись запроса | да |
| apiVersion | Версия протокола. Значение по-умолчанию: 1 | да |
| orderDate | Дата за которую необходимо получить курсы | да |
| currency | Валют, курс которой хотите получить | нет |
Параметры ответа:
| Параметр | Описание | Пример |
|---|---|---|
| reasonCode | Код отказа | 1100 |
| reason | Причина отказа | Ok |
| ratesDate | Дата за которую выданы курсы валют |
|
| rates | Массив курсов валют | 1415379863 |
Пример запроса и ответа
Запрос
{
"apiVersion": "1",
"transactionType": "CURRENCY_RATES",
"merchantAccount": "test_merch_n1",
"orderDate": 1519885604,
"merchantSignature": "66917B2222227A452BD5826BC0B6B7E7"
}
Ответ
{
"REASONCODE": 1100,
"REASON": "OK",
"RATESDATE": 1519115604,
"RATES": {
"AUD": 19.41,
"BTC": 192278,
"CAD": 19.44,
"CHF": 27.08,
"CNY": 3.85,
"CZK": 1.11,
"EUR": 29.76,
"GBP": 33.78,
"HKD": 3.37,
"ILS": 7.39,
"JPY": 0.23,
"KZT": 0.08,
"PLN": 7.04, "SGD": 18.98,
"USD": 26.45
}
}