SePay SoundBox API Overview
This documentation provides specifications for SePay SoundBox API, designed for partners who have signed cooperation agreements and want to integrate SePay speaker devices.
Introduction
Partner
SePay Service
Devices
- SePay SoundBox API allows partners to integrate balance notification speaker devices.
- The API supports functions: device pairing, sending amount notifications.
Base URL
URL
https://speaker-api.sepay.vn/devices/v1
Authentication
Headers
Header: Authorization: Bearer <ACCESS_TOKEN>
Note
- All SePay Partner APIs require authentication via
Bearer Token - Token is valid for 6000 seconds (100 minutes)
Device Pairing Flow
Speaker Pairing Flow
Rendering diagram...
Core Endpoints
POST
/token/createPOST
/speaker/pair/checkPOST
/speaker/pair/requestPOST
/speaker/pair/verifyPOST
/speaker/transactions/notifyPOST
/speaker/transactions/check_notifyCommon Response Structure
Success:
json
{
"code": 200,
"message": "Thành công",
"data": { }
}Error:
json
{
"code": 401,
"message": "Unauthorized"
}