Merchant Transaction Counter API

API to get transaction counter statistics for the merchant by day.

API Endpoint

GET

https://bankhub-api-sandbox.sepay.vn/v1/merchant-config/counter

Note

This API requires a Bearer Token in the Authorization header
If start_date and end_date are not provided, the API defaults to today's statistics
start_date must be less than or equal to end_date
The transaction field per day counts incoming transactions only (outgoing transactions are not included)

Query Parameters

start_datestring

Start date (YYYY-MM-DD). Defaults to current date.

end_datestring

End date (YYYY-MM-DD). Defaults to current date.

Error Handling

400Bad Request

Invalid input — wrong date format, date does not exist in calendar, or start_date is greater than end_date

401Unauthorized

Access token is invalid or expired

500Internal Server Error

Internal server error

Date Validation

Common 400 errors when passing date parameters:

start_date or end_date has wrong format (must be YYYY-MM-DD)
Date does not exist in calendar (e.g., 2026-02-30)
start_date is greater than end_date

API Response

Response 200 - Success

{
  "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

Statistics data

Code Examples

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'

Next Steps

After retrieving the merchant transaction counter statistics:

Get Merchant Configuration API - View the current merchant configuration including whitelist keywords and logo
Update Merchant Configuration API - Update the merchant configuration

Tip

Use this counter to monitor daily transaction volume and detect anomalies in merchant payment activity.