Формат взаємодії: GET та POST запити на відповідні URL в домені fc-pay.gerc.ua. Всі POST запити відправляються, та відповіді надаються у форматі JSON в кодуванні UTF-8. Всі приклади наведеній в цій документації є ілюстративними для демонстрації структури запитів і відповідей та не можуть бути використані для роботи з API “як є”.
POST запити в систему мають загальний формат:
|
Вкладеність |
Назва параметра |
Тип даних |
Розмірність даних |
Опис параметра |
|---|---|---|---|---|
|
1 |
data |
об'єкт JSON |
– |
Містить основні дані запиту. Структура залежить від контексту використання. |
|
1 |
signature |
строка |
40 символів |
Цифровий підпис, який використовується для перевірки цілісності та автентичності даних у полі data. |
{
"data":{"partner_id":4,"paydata":[{"point_id":42,"amount":17000,"description":"Тестовий"}],"order_id":"909910","api_ver":"1"},
"signature":"07d38398e0e6d594dae41c00237c4de5dd9890e1"
}
Примітка!
Усі запити повинні містити електронний підпис! Також підпис містять всі нотифікації та відповіді про успішну сплату!
Алгоритм отримання підпису:
sha1(sha1(data) + sha1(partner_id+ partner_key))
Будь ласка, зверніть увагу, що використовується формат SHA у шістнадцятковому (hexadecimal) форматі.
де,
| Параметр | Опис | Приклад |
| data | "Корисні" дані. JSON без пробілів та переносів | {"partner_id":4,"backref_url":"https://fc-pay.gerc.ua/","notify_url":"https://fc.gerc.ua/", "user_ip":"8.8.8.8","paydata":[{"point_id": 22,"amount": 800,"description": "testdescr2"},{"point_id": 42,"amount": 200,"description":"testdescr1"}],"api_ver":1} |
| partner_id | ID партнера (надається менеджерами ГЕРЦ) | |
| partner_key | Ключ партнера (надається менеджерами ГЕРЦ) | - |
Отриманий рядок потрібно вставити в JSON запит у поле signature.
json
{
"data":{...},
"signature":"d32ead604549c44a5edbe78a32466aca15a29372"
}