API FONDYВерсия 1.0

Параметры запроса

ПараметрТипОписаниеПример передаваемого мерчантом значения
order_idstring(1024)Уникальный идентификатор заказа. Назначается мерчантом.

обязательный
ID1234
merchant_idinteger(12)Уникальный идентификатор мерчанта. Выдается торговцу после регистрации.

обязательный
1
signaturestring(40)Подпись заказа. Служит для проверки целостности и подлинности запроса на стороне сервера платежного шлюза

обязательный
1773cf135bd89656131134b98637894dad42f808
versionstring(10)Версия протокола.

Значение по умолчанию: 1.0
1.0
amountinteger(12)Сумма реверса

обязательный
1020 — соответствует 10 долларов. 20 центов
currencystring(3)Валюта заказа. Допустимые значения:
UAH — украинская гривна
USD — доллар США
EUR — евро
GBP — фунт стерлингов

обязательный
USD
commentstring(1024)Комментарий мерчанта, описывающий причину реверса. Кодировка UTF-8“Клиент вернул товар”

Параметры ответа

ПараметрТипОписаниеПример ответа
order_idstring(1024)Уникальный идентификатор заказа. Назначается мерчантом.ID1234
merchant_idinteger(12)Уникальный идентификатор мерчанта. Выдается торговцу после регистрации.1
reverse_statusstring(50)Статус обработки возврата. Может содержать следующие значения:
created — возврат был создан, но еще не обработан
declined — возврат отклонен платежным шлюзом FONDY, внешней платежной системой или банком-эквайером
approved — возврат успешно совершен
approved
response_statusstring(50)Статус обработки запроса. Если возникла ошибка при валидации передаваемых, то возвращается failure, иначе success
signaturestring(40)Подпись заказа. Служит для проверки целостности и подлинности запроса на стороне сервера платежного шлюза
1773cf135bd89656131134b98637894dad42f808
response_codeinteger(4)Код отказа1008
response_descriptionstring(1024)Причина отказаParameter `amount` is mandatory

Параметры ответа в случае ошибки

См. Параметры ответа в случае ошибки

Формирование запроса

Запрос реверса на сервер FONDY всегда формируется способом host-to-host на URL https://pay.fondy.eu/api/reverse/order_id

Host-to-host АПИ поддерживает следующие текстовые форматы запросов:

В контексте запроса всегда возвращается ответ в том же формате, что и запрос. Т.е. если запрос был в формате JSON, то и ответ вернется в формате JSON.

Пример host-to-host JSON

Content Type: application/json

Запрос

{
   "request":{
      "order_id":"test7926651365",
      "currency":"USD",
      "amount":"1",
      "merchant_id":"1",
      "signature":"b1ed592ff76ddca287503b11c1aad70bb1c67f37"
   }
}

Нормальный ответ

{
   "response":{
      "order_id":"test309906285",
      "response_status":"success",
      "response_code":"",
      "reverse_status":"approved",
      "response_description":"",
      "merchant_id":"1"
   }
}

Ответ в случае ошибки

{
   "response":{
      "response_status":"failure",
      "error_message":"Order Not Found",
      "error_code":"1018"
   }
}

Пример host-to-host XML

Content Type: application/xml

Запрос

<?xml version="1.0" encoding="UTF-8"?>
<reqest>
   <order_id>test7926651365</order_id>
   <currency>USD</currency>
   <amount>1</amount>
   <merchant_id>1</merchant_id>
   <signature>b1ed592ff76ddca287503b11c1aad70bb1c67f37</signature>
</request>

Нормальный ответ

<?xml version="1.0" encoding="UTF-8"?>
<response>
   <order_id>test6622534987</order_id>
   <response_status>success</response_status>
   <response_code />
   <reverse_status>approved</reverse_status>
   <response_description />
   <merchant_id>1</merchant_id>
</response>

Ответ в случае ошибки

<?xml version="1.0" encoding="UTF-8"?>
<response>
   <response_status>failure</response_status>
   <error_message>Order Not Found</error_message>
   <error_code>1018</error_code>
</response>

Пример host-to-host HTML form

Content Type: application/x-www-form-urlencoded

Запрос

order_id=test6622534987&currency=USD&amount=1&merchant_id=1
&signature=6ccbfeb82894b5c51855e032da1e7a3bee65f3a3

Нормальный ответ

order_id=test7101250216&response_status=success&response_code=
&reverse_status=approved&response_description=&merchant_id=1

Ответ в случае ошибки

response_status=failure&error_message=Order+Not+Found&error_code=1018

Хочу принимать платежи со всего мира!