# Get Merchant Configuration API

- Anchor: `bankhub-en-api-api-merchant-thong-tin-cau-hinh`
- URL: https://developer.sepay.vn/en/bankhub/api/api-merchant/thong-tin-cau-hinh.md
- Description: API to retrieve the merchant’s current configuration, including transaction whitelist keywords, custom CSS, and logo URL.

**GET** `https://bankhub-api-sandbox.sepay.vn/v1/merchant-config`
```http
Authorization: Bearer YOUR_ACCESS_TOKEN
Content-Type: application/json
```



**Headers**

<!-- Params table -->

> **Note** (info)
>
>
> * This API requires a Bearer Token in the Authorization header
> * Returns the merchant’s current configuration
> * If the merchant has no configuration yet, fields will have default values (empty arrays or null)
> * Custom CSS is applied to all hosted links of the merchant
>






**RESPONSE 200**


```json
{
  "data": {
    "transaction_whitelist_remark_keywords": ["thanh toan", "payment", "chuyen khoan"],
    "global_hosted_link_custom_css": "body { background: #f0f0f0; }",
    "logo_url": "https://s3.example.com/bankhub/logos/123-1705392000.png"
  }
}
```








---

> **Transaction Whitelist Keywords** (info)
>
> **How it works:**
>
> * The keyword list is used to filter transactions before sending webhooks
> * Only transactions whose content (`transaction_content`) contains at least one keyword will be sent via webhook
> * Matching is case-insensitive
> * If the array is empty (`[]`), all transactions will be sent via webhook
>
> **Example:**
>
> * Keywords: `["thanh toan", "payment"]`
> * Transaction content: "Chuyen khoan thanh toan don hang ABC" → **Webhook is sent**
> * Transaction content: "Gui tien cho ban" → **Webhook is not sent**
>

> **Global Hosted Link Custom CSS** (info)
>
> **Custom CSS for WebView:**
>
> * CSS is injected into all hosted links of the merchant
> * Allows customizing colors, fonts, and layout of the WebView UI
> * Must be valid CSS and must not include scripts or malicious code
> * Example: change background color, button color, logo position, etc.
>
> **Notes:**
>
> * CSS must not break hosted link functionality
> * Test carefully before deploying to production
>

> **Logo URL** (info)
>
> **Logo on S3:**
>
> * The logo is uploaded via API **[/merchant-config/logo](/vi/bankhub/api-merchant/upload-logo-merchant)**
> * URL format: `https://s3.example.com/bankhub/logos/{merchant_id}-{timestamp}.png`
>

> **Important Notes** (warn)
>
>
> * Configuration changes take effect immediately for all active hosted links
> * Custom CSS must comply with the security policy (no scripts, no external resources)
> * Whitelist keywords should be updated carefully to avoid missing important webhooks
>

---
