Звітність та реєстри

Ми розуміємось на фінансовій звітності. Тому в нашому рішенні Ви знайдете різноманітні реєстри і звіти, що допоможуть як пройти найскладніший аудит, так і просто тримати свої фінанси під повним контролем.

🇺🇦 Інструкція для створення та отримання звіту (API)

Цей API дозволяє автоматично генерувати звіти по фінансових операціях у вашій системі — платежі, виводи, обміни, тощо. Його можна інтегрувати у внутрішні системи аналітики, бухгалтерського обліку або CRM, щоб отримувати актуальну інформацію про транзакції у зручному форматі (CSV/Excel) як на щоденій основі, так і раз на місяць.

✅ Підтримує фільтрацію за статусами, типами операцій, валютами та іншими параметрами.

📅 Максимальний дозволений діапазон часу: 3 місяці для кожного запиту.

1. Створення звіту

Використовуйте метод POST /api/v3/reports/create

{
  "params": {
    "type": "orders",
    "timezone": "UTC",
    "id": "",                      // ID транзакції (необов’язково)
    "merchantOrderId": "",        // Якщо використовується id, merchantOrderId має бути null
    "createdAtFrom": "2025-07-02T07:44:51+00:00", 
    "createdAtTo": "2025-07-02T07:44:51+00:00",
    "types": [ "payin", "exchange_payin", "payout", "exchange_payout", "exchange" ],
    "statuses": [ "new", "processing", "completed", "rejected", "canceled", "partially_completed", "refunded", "overpaid", "underpaid" ],
    "clientId": "",
    "taxpayerNumber": "",
    "transactionCurrency": "",
    "transactionPaymentMethod": ""
  }
}

✅ Відповідь (успішне створення):

{
  "data": {
    "id": "cd97028f-70d2-4c95-a235-098e942e6315",
    "status": "processing"
  },
  "error": null
}

2. Перевірка статусу звіту

Метод POST /api/v3/reports/get-status.

{
  "id": "cd97028f-70d2-4c95-a235-098e942e6315"
}

✅ Відповідь на перевірку статусу:

{
  "data": {
    "id": "cd97028f-70d2-4c95-a235-098e942e6315",
    "status": "processing",
    "type": "orders",
    "progress": 19
  },
  "error": null
}

3. Отримання посилання на звіт

Метод POST /api/v3/reports/get-link.

{
  "id": "cd97028f-70d2-4c95-a235-098e942e6315"
}

✅ Відповідь на отримання посилання:

{
  "data": {
    "status": "success",
    "type": "orders",
    "downloadLink": "https://reports...1448"
  },
  "error": null
}

У запиті для створення звіту можна передати або id, або merchantOrderId, але не обидва одночасно. Якщо використовується id, тоді merchantOrderId має бути null, і навпаки.