Danh mục 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`

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

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

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

Bắt đầu

Webhook

Danh mục sự kiện

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

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

Tin thử: `test.ping`

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

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

​Tin thử: test.ping

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

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

Tin thử: `test.ping`