Update Merchant Configuration API

API to update merchant configuration including transaction whitelist keywords and custom CSS for hosted links.

API Endpoint

POST

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

Request Body

transaction_whitelist_remark_keywordsarray<string>

Whitelist keywords for transaction content

Note

This API requires a Bearer Token in the Authorization header
Supports partial update: only send fields that need updating
Fields not sent will retain their old values

Error Handling

400Validation Error

Invalid input data (keywords not array, etc.)

401Unauthorized

Access token is invalid or expired

API Response

Response 200 - Update Successful

{
  "data": {
    "transaction_whitelist_remark_keywords": [
      "string"
    ],
    "logo_url": "https://example.com"
  }
}

dataobject

Merchant configuration

Code Examples

curl --request POST \
  --url https://bankhub-api-sandbox.sepay.vn/v1/merchant-config \
  --header 'Authorization: Bearer REPLACE_BEARER_TOKEN' \
  --header 'content-type: application/json' \
  --data '{"transaction_whitelist_remark_keywords":["string"]}'

Usage Examples

JSUpdate whitelist keywords

curl --location 'https://bankhub-api-sandbox.sepay.vn/v1/merchant-config' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
--data '{
  "transaction_whitelist_remark_keywords": ["thanh toan", "payment", "chuyen khoan"]
}'

JSUpdate multiple keywords

curl --location 'https://bankhub-api-sandbox.sepay.vn/v1/merchant-config' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
--data '{
  "transaction_whitelist_remark_keywords": ["thanh toan", "payment", "don hang"]
}'

Validation Rules

Transaction Whitelist Keywords:

Keywords are trimmed and duplicates are removed
Empty keywords are rejected