API Bộ đếm giao dịch Merchant

API lấy thống kê bộ đếm giao dịch của merchant theo ngày.

API Endpoint

GET
https://bankhub-api-sandbox.sepay.vn/v1/merchant-config/counter
Lưu ý
  • API này yêu cầu Bearer Token trong header Authorization
  • Nếu không truyền start_date và end_date, mặc định trả về thống kê của ngày hiện tại
  • start_date phải nhỏ hơn hoặc bằng end_date
  • Trường transaction trong mỗi ngày chỉ đếm giao dịch tiền vào (không bao gồm tiền ra)

Query Parameters

start_datestring

Ngày bắt đầu (YYYY-MM-DD). Mặc định là ngày hiện tại.

end_datestring

Ngày kết thúc (YYYY-MM-DD). Mặc định là ngày hiện tại.

Xử lý lỗi

400Bad Request

Dữ liệu đầu vào không hợp lệ — định dạng ngày sai, ngày không tồn tại trong lịch, hoặc start_date lớn hơn end_date

401Unauthorized

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

500Internal Server Error

Lỗi máy chủ nội bộ

Validation ngày

Các lỗi 400 phổ biến khi truyền tham số ngày:

  • start_date hoặc end_date sai định dạng (phải là YYYY-MM-DD)
  • Ngày không tồn tại trong lịch (ví dụ: 2026-02-30)
  • start_date lớn hơn end_date

API Response

Response 200 - Thành công
{
  "data": {
    "dates": [
      {
        "company_id": 123,
        "date": "2026-04-01",
        "transaction": 12,
        "transaction_in": 12,
        "transaction_out": 3
      }
    ],
    "total": {
      "transaction": 18,
      "transaction_in": 18,
      "transaction_out": 5
    }
  }
}
dataobject

Dữ liệu thống kê

Code mẫu

>
>
>
curl --request GET \
  --url 'https://bankhub-api-sandbox.sepay.vn/v1/merchant-config/counter?start_date=2026-04-01&end_date=2026-04-03' \
  --header 'Authorization: Bearer REPLACE_BEARER_TOKEN'

Bước tiếp theo

Sau khi lấy được thống kê bộ đếm giao dịch của merchant:

  1. API Lấy cấu hình Merchant - Xem cấu hình hiện tại của merchant bao gồm whitelist keywords và logo
  2. API Chỉnh sửa cấu hình Merchant - Cập nhật cấu hình merchant
Gợi ý

Dùng bộ đếm này để theo dõi lưu lượng giao dịch theo ngày và phát hiện bất thường trong hoạt động thanh toán của merchant.

Trước
—
Tiếp theo
—