API gửi thông báo biến độ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