| Параметр | Тип | Опис | Приклад переданого мерчантом значення |
|---|---|---|---|
order_id |
string(1024) | Ідентифікатор замовлення, що призначається мерчантом.
обов’язковий
|
ID1234 |
merchant_id |
integer(12) | Унікальний ідентифікатор мерчанта. Видається торговцю після реєстрації.
обов’язковий
|
1 |
order_desc |
string(1024) | Опис замовлення. Передається мерчантом завжди в кодуванні UTF-8
обов’язковий
|
Придбати квиток на поїзд № 1234 Київ – Львів |
signature |
string(40) | Підпис замовлення. Служить для перевірки цілісності та автентичності запиту від мерчанта на стороні сервера платіжного шлюзу. Алгоритм формування підпису див. Формування підпису запиту і відповіді
обов’язковий
|
1773cf135bd89656131134b98637894dad42f808
|
amount |
integer(12) | Сума замовлення в копійках/центах без роздільників
обов’язковий
|
1020 (USD) — означає 10 доларів 20 центів |
currency |
string(3) | Валюта замовлення. Допустимі значення: UAH — українська гривня \ USD — доллар США EUR — євро GBP — фунт стерлінгів CZK — чеські крони
|
USD |
rectoken |
string(40) | Токен картки, за яким можна списувати кошти з картки без подальшої участі клієнта |
544d3f86237886b6404d8b000f6a7d71c45410b7
|
version |
string(10) | Версія протоколу.
Значення за замовчуванням: 1.0
|
1.0 |
server_callback_url |
string(2048) | URL сторінки мерчанта, на яку буде надіслано відповідь про результат оплати через сервер-сервер з’єднання |
http://site.com/callbackurl
|
client_ip |
string(15) | Реальний IP платника |
8.8.8.8
|
default_payment_system |
string(25) | Платіжна система, яка першою відобразиться платнику на платіжній сторінці. Допустимі значення: див. Підтримувані платіжні системи |
card |
lifetime |
integer(6) | Час життя замовлення в секундах. Після закінчення цього часу, замовленню буде присвоєно статус ‘expired’ якщо клієнт його не оплатив
Значення за замовчуванням: 36000
|
600 |
merchant_data |
string(2048) | Будь-який довільний набір даних, який мерчант хоче отримати назад у відповіді на response_url та/або server_callback_url, а також у звітах |
|
preauth |
string(1) | Параметр застосовується тільки при оплаті карткою Visa/MasterCard N — сума списується з картки клієнта відразу і відшкодовується на рахунок мерчанта відповідно до регламенту зарахування. Y — сума блокується на картці клієнта і не списується доти, доки мерчант не надішле запит capture для підтвердження списання Значення за замовчуванням: N
|
N |
sender_email |
string(254) | Email платника | |
cvv2 |
string(4) | CVV2/CVC картки | 123 |
product_id |
string(1024) | Ідентифікатор оплачуваного товару/послуги |
Запит платежу за токеном на сервер Hutko завжди формується способом host-to-host на URL https://pay.hutko.org/api/recurring
Content Type: application/json
Запит
{
"request":{
"order_id":"test8037875286",
"order_desc":"Test payment",
"currency":"UAH",
"amount":"100",
"rectoken":"544d3f86237886b6404d8b000f6a7d71c45410b7",
"signature":"07bc309047a56275f8d89ae222e2af0ceb94fe79",
"merchant_id":"1700002"
}
}
Нормальна відповідь
{
"response": {
"rrn": "",
"masked_card": "",
"sender_cell_phone": "",
"response_status": "",
"currency": "UAH",
"fee": "",
"reversal_amount": "",
"settlement_amount": "",
"actual_amount": "1000",
"order_status": "approved",
"response_description": "",
"order_time": "13.01.2014 15:10:47",
"actual_currency": "USD",
"order_id": "test7926651365",
"tran_type": "",
"eci": "",
"settlement_date": "",
"payment_system": "Visa/MC",
"approval_code": "530159",
"merchant_id": "1700002",
"settlement_currency": "",
"payment_id": "2100",
"card_bin": "",
"response_code": "",
"card_type": "",
"amount": "1000",
"sender_email": "",
"signature": "3a587a6908e1b4119729e6b00f9f055a927728fd",
"product_id": ""
}
}
Відповідь у разі помилки
{
"response":{
"response_status":"failure",
"error_message":"Parameter `amount` is mandatory",
"error_code":"1008"
}
}