API Đếm giao dịch theo công ty

API lấy số liệu thống kê giao dịch của công ty theo ngày. Hỗ trợ lọc theo khoảng thời gian để xem xu hướng giao dịch.

API Endpoint

GET

https://bankhub-api-sandbox.sepay.vn/v1/company/counter/{company_id}

Path Parameters

company_idstringrequired

ID của công ty

datestring

Lọc theo ngày cụ thể (YYYY-MM-DD)

Query Parameters

company_idstringrequired

ID của công ty

datestring

Lọc theo ngày cụ thể (YYYY-MM-DD)

Lưu ý

API này yêu cầu Bearer Token trong header Authorization
Công ty phải thuộc về merchant đang xác thực
Kết quả trả về thống kê theo ngày và tổng hợp
Các trường counter bao gồm: transaction (tổng), transaction_in (vào), transaction_out (ra)

Xử lý lỗi

404Not Found

Công ty không tồn tại hoặc không thuộc merchant này

401Unauthorized

Access token không hợp lệ hoặc đã hết hạn

API Response

Response 200 - Thành công

{
  "data": {
    "dates": [
      {
        "date": "2024-01-01",
        "transaction": 0,
        "transaction_in": 0,
        "transaction_out": 0
      }
    ],
    "total": {
      "transaction": 0,
      "transaction_in": 0,
      "transaction_out": 0
    }
  }
}

dataobject

Dữ liệu thống kê

Code mẫu

curl --request GET \
  --url 'https://bankhub-api-sandbox.sepay.vn/v1/company/counter/d3dafd01-e06b-11f0-b29e-52c7e9b4f41b?date=SOME_STRING_VALUE' \
  --header 'Authorization: Bearer REPLACE_BEARER_TOKEN'

Lưu ý quan trọng

Transaction In/Out: transaction_in là giao dịch tiền vào tài khoản, transaction_out là giao dịch tiền ra
Filtering: Sử dụng query parameter date để lọc theo ngày cụ thể, nếu không truyền sẽ lấy tất cả
Total: Trường total luôn chứa tổng hợp của tất cả các ngày trong dates
Empty Dates: Nếu chưa có giao dịch, mảng dates sẽ rỗng và total sẽ có giá trị 0