API kiểm tra OTP

Sau khi OTP gửi về thiết bị, thiết bị sẽ đọc lên gồm 4 số, người dùng sẽ nhập và xác thực liên kết.


API Endpoint

POST
https://speaker-api.sepay.vn/devices/v1/speaker/pair/verify

Tham số Request

hardwareIdstringrequired

Số serial của thiết bị

session_idstringrequired

ID phiên từ API /speaker/pair/request

otpstringrequired

Mã OTP 4 chữ số do thiết bị đọc lên

Lưu ý
  • Session ID có thời hạn khoảng 2 phút
  • OTP gồm 4 chữ số được thiết bị đọc lên
  • Sau khi xác thực thành công, thiết bị sẽ được liên kết và sẵn sàng nhận thông báo

Code mẫu

>
>
>
>
>
curl --request POST \
--url https://speaker-api.sepay.vn/devices/v1/speaker/pair/verify \
--header 'Authorization: Bearer REPLACE_BEARER_TOKEN' \
--header 'content-type: application/json' \
--data '{"hardwareId":"VNS52508000001","session_id":"8b9f6d2a-3c1b-4f7a-a7d4-123456789abc","otp":"1234"}'

API Response

Response 200 - Liên kết thành công
{
  "code": 200,
  "message": "Liên kết thành công",
  "data": {
    "hardwareId": "VNS52508000001",
    "model": "S5 Plus",
    "isPaired": true,
    "pairedTime": "2025-05-23 16:06:38"
  }
}
codeinteger

Mã phản hồi

messagestring

Mô tả kết quả

dataobject