> ## Documentation Index
> Fetch the complete documentation index at: https://docs.eholdings.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Danh mục sự kiện

> Các sự kiện webhook và nội dung của từng sự kiện.

| Sự kiện | Khi nào |
| - | - |
| `payment.transaction.received` | Một khoản tiền vào tài khoản nhận tiền của cửa hàng. |
| `payment.transaction.flagged` | Hai báo cáo của cùng một giao dịch không khớp số tiền: hãy đối chiếu sao kê. |
| `payment.bank_account.activated` | Một tài khoản nhận tiền bắt đầu nhận được tiền. |
| `payment.bank_account.removed` | Một tài khoản nhận tiền đã đóng. |
| `test.ping` | Tin thử do bạn yêu cầu hoặc tạo lúc thêm webhook. Không cần đăng ký. |

## Giao dịch: `payment.transaction.received` và `payment.transaction.flagged`

```json theme={null}
{
  "type": "payment.transaction.received",
  "id": "1470508744885708765",
  "timestamp": "2026-10-12T17:21:07+07:00",
  "data": {
    "transaction_id": "1470508744001122334",
    "bank_account_id": "1470508743990011223",
    "va_number": "96495370AB",
    "amount": 250000,
    "content": "NGUYEN VAN A THANH TOAN DON 123",
    "transacted_at": "2026-10-12T17:20:58+07:00",
    "code": "FT26285XXXXXXX",
    "source": "webhook"
  }
}
```

| Trường | Ý nghĩa |
| - | - |
| `transaction_id` | Mã giao dịch trong hệ thống (chuỗi). Dùng để khử trùng. |
| `bank_account_id` | Mã tài khoản nhận tiền (chuỗi). |
| `va_number` | Số tài khoản nhận tiền mà người chuyển đã chuyển vào. |
| `amount` | Số tiền, số nguyên đồng. |
| `content` | Nội dung chuyển khoản do người chuyển nhập. **Dữ liệu cá nhân**: hãy bảo vệ như dữ liệu của bạn. |
| `transacted_at` | Thời điểm ngân hàng ghi giao dịch. |
| `code` | Mã giao dịch ngân hàng báo. |
| `source` | `webhook` (ngân hàng báo ngay), `reconcile` (phát hiện khi đối chiếu định kỳ) hoặc `manual` (bộ phận hỗ trợ gán thủ công). |

## Tài khoản nhận tiền: `payment.bank_account.activated` và `payment.bank_account.removed`

```json theme={null}
{
  "type": "payment.bank_account.activated",
  "id": "1470508744885709999",
  "timestamp": "2026-10-12T09:00:03+07:00",
  "data": {
    "bank_account_id": "1470508743990011223",
    "bank_bin": "970418",
    "account_type": "business-account",
    "va_number": "96495370AB",
    "label": "Quầy 1",
    "activated_at": "2026-10-12T09:00:01+07:00"
  }
}
```

Sự kiện `payment.bank_account.removed` có **cả** `activated_at` (lúc tài khoản bắt đầu nhận tiền) **và** `removed_at` (lúc đóng); sự kiện `activated` chỉ có `activated_at`. Tài khoản chưa từng hoạt động thì không phát sinh sự kiện nào. `account_type` là `personal-account` (cá nhân), `business-household-account` (hộ kinh doanh) hoặc `business-account` (doanh nghiệp).

## Tin thử: `test.ping`

```json theme={null}
{
  "type": "test.ping",
  "id": "1470508744885700001",
  "timestamp": "2026-10-12T17:21:07+07:00",
  "data": { "endpoint_id": "1470508744887779052", "message": "This is a test event." }
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.