API Thông báo biến động số dư

API này được gọi từ hệ thống thanh toán để gửi thông báo biến động số dư tới thiết bị loa (speaker). Thiết bị sẽ đọc to nội dung số tiền tương ứng.

API Endpoint

POST

https://speaker-api.sepay.vn/devices/v1/speaker/transactions/notify

Tham số Request

hardwareIdstringrequired

Số serial của thiết bị

amountintegerrequired

Số tiền biến động (VND)

requestIdstringrequired

Mã giao dịch hoặc mã yêu cầu duy nhất

Lưu ý

requestId phải là duy nhất cho mỗi giao dịch để tránh gửi trùng (idempotency)
Thiết bị sẽ đọc to số tiền tương ứng
Thiết bị phải đã được liên kết và đang online

Code mẫu

curl --request POST \
  --url https://speaker-api.sepay.vn/devices/v1/speaker/transactions/notify \
  --header 'Authorization: Bearer REPLACE_BEARER_TOKEN' \
  --header 'content-type: application/json' \
  --data '{"hardwareId":"VNS52508000001","amount":150000,"requestId":"TXN202510130001"}'

API Response

Response 200 - Gửi thành công

{
  "code": 200,
  "message": "Đã gửi thông báo thành công",
  "data": {
    "hardwareId": "VNS52508000001",
    "requestId": "TXN202510130001",
    "status": "SENT"
  }
}

codeinteger

Mã phản hồi (200 khi thành công)

messagestring

Mô tả kết quả

dataobject