Tổng quan SePay SoundBox API

Tài liệu này cung cấp thông tin đặc tả về SePay SoundBox API dành cho các đối tác muốn tích hợp thiết bị loa của SePay đã ký kết hợp tác.


Giới thiệu

Partner
SePay Service
Devices
  • SePay SoundBox API cho phép đối tác tích hợp thiết bị loa thông báo biến động số dư.
  • API hỗ trợ các chức năng: liên kết thiết bị, gửi thông báo số tiền.

Base URL

URL
https://speaker-api.sepay.vn/devices/v1

Xác thực

Headers
Header: Authorization: Bearer <ACCESS_TOKEN>
Lưu ý
  • Tất cả SePay Partner API đều yêu cầu xác thực bằng mã truy cập thông qua Bearer Token
  • Token có hiệu lực 6000 giây (100 phút)

Luồng liên kết thiết bị

Speaker Pairing Flow
Rendering diagram...

Endpoint chính

POST
/token/create
POST
/speaker/pair/check
POST
/speaker/pair/request
POST
/speaker/pair/verify
POST
/speaker/transactions/notify
POST
/speaker/transactions/check_notify

Cấu trúc phản hồi chung

Success:

json
{
  "code": 200,
  "message": "Thành công",
  "data": { }
}

Error:

json
{
  "code": 401,
  "message": "Unauthorized"
}