API FONDYВерсия 1.0


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

ПараметрТипОписаниеПример передаваемого мерчантом значения
merchant_idinteger(12)Уникальный идентификатор мерчанта. Выдается торговцу после регистрации.
обязательный
1
date_fromstring(10)Дата возмещения на счет мерчанта в формате ДД.ММ.ГГГГ
обязательный
15.04.2014
date_tostring(10)Дата возмещения на счет мерчанта в формате ДД.ММ.ГГГГ
обязательный
16.04.2014
signaturestring(40)Подпись заказа.
Служит для проверки целостности и подлинности запроса на стороне сервера платежного шлюза
обязательный
1773cf135bd89656131134b98637894dad42f808
versionstring(10)Версия протокола
Значение по-умолчанию: 1.0
1.0

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

См. Параметры финального ответа


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

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


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

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

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

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


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

Content Type: application/json

Запрос

{
  "request": {
    "merchant_id": "1",
    "date_from": "16.04.2014",
    "date_to": "16.04.2014",
    "signature": "250ceec5ea86bc606cee4354c0d7126d0a2ab046"
  }
}

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

{
   "response":[
      {
         "rrn":"",
         "masked_card":"",
         "sender_cell_phone":"",
         "response_status":"",
         "currency":"USD",
         "fee":"100",
         "reversal_amount":"",
         "settlement_amount":"900",
         "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":"16.04.2014",
         "payment_system":"card",
         "approval_code":"530159",
         "merchant_id":"1",
         "settlement_currency":"",
         "payment_id":"2100",
         "card_bin":"",
         "response_code":"",
         "card_type":"",
         "amount":"1000",
         "sender_email":"",
         "signature":"3a587a6908e1b4119729e6b00f9f055a927728fd"
      },
      ...
      {
         "rrn":"",
         "masked_card":"",
         "sender_cell_phone":"",
         "response_status":"",
         "currency":"USD",
         "fee":"100",
         "reversal_amount":"",
         "settlement_amount":"900",
         "actual_amount":"1000",
         "order_status":"approved",
         "response_description":"",
         "order_time":"13.01.2014 15:10:47",
         "actual_currency":"USD",
         "order_id":"test7926651366",
         "tran_type":"",
         "eci":"",
         "settlement_date":"16.04.2014",
         "payment_system":"card",
         "approval_code":"530159",
         "merchant_id":"1",
         "settlement_currency":"",
         "payment_id":"2101",
         "card_bin":"",
         "response_code":"",
         "card_type":"",
         "amount":"1000",
         "sender_email":"",
         "signature":"3a587a6908e1b4119729e6b00f9f055a927728fd"
      }
   ]
}

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

{
  "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"?>
<request>
  <date_from>15.04.2014</date_from>
  <date_to>16.04.2014</date_to>
  <merchant_id>1</merchant_id>
  <signature>250ceec5ea86bc606cee4354c0d7126d0a2ab046</signature>
</request>

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

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <order>
    <actual_amount>1000</actual_amount>
    <actual_currency>USD</actual_currency>
    <amount>1000</amount>
    <approval_code>530159</approval_code>
    <card_bin />
    <card_type />
    <currency>USD</currency>
    <eci />
    <fee>100</fee>
    <masked_card />
    <merchant_id>1</merchant_id>
    <order_id>test7926651365</order_id>
    <order_status>approved</order_status>
    <order_time>13.01.2014 15:10:47</order_time>
    <payment_id>2100</payment_id>
    <payment_system>card</payment_system>
    <response_code />
    <response_description />
    <response_status />
    <reversal_amount />
    <rrn />
    <sender_cell_phone />
    <sender_email />
    <settlement_amount>900</settlement_amount>
    <settlement_currency />
    <settlement_date>16.04.2014</settlement_date>
    <signature>3a587a6908e1b4119729e6b00f9f055a927728fd</signature>
    <tran_type />
  </order>
...
  <order>
    <actual_amount>1000</actual_amount>
    <actual_currency>USD</actual_currency>
    <amount>1000</amount>
    <approval_code>530159</approval_code>
    <card_bin />
    <card_type />
    <currency>USD</currency>
    <eci />
    <fee>100</fee>
    <masked_card />
    <merchant_id>1</merchant_id>
    <order_id>test7926651366</order_id>
    <order_status>approved</order_status>
    <order_time>13.01.2014 15:10:47</order_time>
    <payment_id>2101</payment_id>
    <payment_system>card</payment_system>
    <response_code />
    <response_description />
    <response_status />
    <reversal_amount />
    <rrn />
    <sender_cell_phone />
    <sender_email />
    <settlement_amount>900</settlement_amount>
    <settlement_currency />
    <settlement_date>16.04.2014</settlement_date>
    <signature>3a587a6908e1b4119729e6b00f9f055a927728fd</signature>
    <tran_type />
  </order>
</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>