Детальний звіт по транзакціям за обрану дату

Опис

Процес отримання звіту виконується в дві дії:

Виконати запит для отримання токену для конкретного сервісу.
Виконати запит по токену і отримати звіт у синхронній відповіді.

API параметри

Параметри для отримання токену

Токен валідний 60 хв.

Під кожен сервіс IA, C2A, A2C треба октримати окремий токен.

HTTP METHOD: POST

API ENDPOINT: https://138.68.178.83/api/merchant/transactions/token

Параметр	Значення	Опис	Особливості
`api_key` ОБОВ'ЯЗКОВИЙ	String	API ключ
`request_id` ОБОВ'ЯЗКОВИЙ	String	Унікальний ідентифікатор запиту на боці мерчанта
`limit` ОБОВ'ЯЗКОВИЙ	Int	Кількість транзакцій в одному респонсі. За замовчуванням 100. Максимум 1000
`date` ОБОВ'ЯЗКОВИЙ	Date	Дата за яку сформувати звіт у форматі YYYY-MM-DD
`service` ОБОВ'ЯЗКОВИЙ	`IA`, `C2A`, `A2C`	Вказати один необхідний сервіс. Під кожен сервіс окремий токен
`signature` ОБОВ'ЯЗКОВИЙ	String	Контрольний підпис	md5( strrev(api_key). strrev(request_id). strrev(api_secret) )

Параметри для отримання даних по токену

HTTP METHOD: POST

API ENDPOINT: https://138.68.178.83/api/merchant/transactions/token_data

Параметр	Значення	Опис	Особливості
`api_key` ОБОВ'ЯЗКОВИЙ	String	API ключ
`request_id` ОБОВ'ЯЗКОВИЙ	String	Унікальний ідентифікатор запиту мерчанта
`page` ОБОВ'ЯЗКОВИЙ	String	Номер сторінки звіту
`token` ОБОВ'ЯЗКОВИЙ	String	Токен Токен валідний 60 хв.
`signature` ОБОВ'ЯЗКОВИЙ	String	Контрольний підпис	md5( strrev(api_key). strrev(request_id). strrev(api_secret) )

Приклад коду

Приклад коду на PHP для отримання токену

<?php
$api_secret = 'pass_2';
$data['api_key'] = 'key_2';
$data['request_id']= 7897834;
$data['limit']= '100';
$data['date']= '2024-10-17';
$data['service']= 'IA';
$data['signature']= md5(
                        strrev($data['api_key']).
                        strrev($data['request_id']).
                        strrev($api_secret)
                      );

$url = 'https://138.68.178.83/api/merchant/transactions/token';

$crq = curl_init();
curl_setopt($crq, CURLOPT_URL, $url);
curl_setopt($crq, CURLOPT_HEADER, 0);
curl_setopt($crq, CURLOPT_POST, 1);
curl_setopt($crq, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($crq, CURLOPT_SSL_VERIFYHOST, 0);
curl_setopt($crq, CURLOPT_SSL_VERIFYPEER, 0);
curl_setopt($crq, CURLOPT_POSTFIELDS, http_build_query($data));
$result = curl_exec($crq);
if (curl_errno($crq))
{
    return 'ERROR: ' . curl_error($crq);
}
else echo  $result;

curl_close($crq);

Приклад коду на PHP для отримання звіту

<?php
$api_secret = 'pass_2';
$data['api_key'] = 'key_2';
$data['request_id'] = 45657648;
$data['token'] = 'c1a9493d-477b-4fc4-b0cd-b66ee391100e';
$data['page'] = '1';
$data['signature'] = md5(
                        strrev($data['api_key']).
                        strrev($data['request_id']).
                        strrev($api_secret)
                      );

$url = 'https://138.68.178.83/api/merchant/transactions/token_data';

$crq = curl_init();
curl_setopt($crq, CURLOPT_URL, $url);
curl_setopt($crq, CURLOPT_HEADER, 0);
curl_setopt($crq, CURLOPT_POST, 1);
curl_setopt($crq, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($crq, CURLOPT_SSL_VERIFYHOST, 0);
curl_setopt($crq, CURLOPT_SSL_VERIFYPEER, 0);
curl_setopt($crq, CURLOPT_POSTFIELDS, http_build_query($data));
$result = curl_exec($crq);
if (curl_errno($crq)) {
    return 'ERROR: ' . curl_error($crq);
} else echo $result;

curl_close($crq);

Response

{
"request_id": ""
,
"status": "success",
" "
service "IA"
: ,
" "
pagination :
{
"page" "1"
: ,
"limit" "500"
: ,
"total_pages" "3"
: ,
"total_items" "1239"
: ,
"transactions":
[
{
"Order ID": "40697-61870-91704",
"Client order ID": ""
,
"MID": ""
,
"Status": "SUCCESS",
"Card": "414951******8499",
"Amount": "-5000,00",
"Commission": "0,00",
"Processing Date": "2024-02-04",
"Ret Sum": "-5000,00",
"Transaction Date": "2024-02-03 18:03:08",
"Description": ""
},
{
"Order ID": "40697-61870-91704",
"Client order ID": ""
,
"MID": ""
,
"Status": "SUCCESS",
"Card": "414951******8499",
"Amount": "-5000,00",
"Commission": "0,00",
"Processing Date": "2024-02-04",
"Ret Sum": "-5000,00",
"Transaction Date": "2024-02-03 18:03:08",
"Description": ""
},
{
"Order ID": "40697-61870-91704",
"Client order ID": ""
,
"MID": ""
,
"Status": "SUCCESS",
"Card": "414951******8499",
"Amount": "-5000,00",
"Commission": "0,00",
"Processing Date": "2024-02-04",
"Ret Sum": "-5000,00",
"Transaction Date": "2024-02-03 18:03:08",
"Description": ""
]
},
}

Помилки

Помилка	Опис
Incorrect signature	Помилка в підписі
Merchant not found	Невірно вказано API ключ
104: Token not found Токен	Токен більше не валідний або не існує
105: Page not exist	Вказаної сторінки не існує
106: In progress	Звіт ще не сформовано, спробуйте пізніше
107: Report failed	Звіт не в статусі Complete