Tingee Box
TingeeBox is a smart transaction notification speaker that seamlessly connects bank money flows with physical points of sale, so staff no longer need to check their phones manually.
Before you start
- Base URL:
https://uat-open-api.tingee.vn(UAT) ·https://open-api.tingee.vn(PROD) - Authentication: Every request must include the
x-client-idandx-request-timestampheaders and thex-signaturesignature (HMAC SHA512). See How to get the API Key & generate the signature. - Result: The API always returns HTTP
200; check thecodefield (00= success). See Error codes.
PUBLIC SANDBOX — PAYMENT SPEAKER
Listen to Tingee Box notification sounds in 4 real-world scenarios: QR, bank transfer, daily summary and reminder.
📢 Instant notifications
Plays a notification sound as soon as money arrives, so staff can confirm payments in real time.
🖼️ QR Code display
The built-in screen can display dynamic VietQR codes so customers can pay quickly.
🔒 Hardware security
Each device has its own Security Code, ensuring uniqueness and a secure connection.
Detailed flow diagram
QR payment flow via TingeeBox
← Swipe to see more →
API list
| Function | Method | Endpoint |
|---|---|---|
| Read out security code | POST | /v1/device/read-security-code |
| Add device to shop | POST | /v1/device/add-device-to-shop |
| Show dynamic QR | POST | /v1/device/show-dynamic-qr-code |
| Show static QR | POST | /v1/device/show-static-qr-code |
| Create and show QR | POST | /v1/device/generate-and-show-dynamic-qr-code |
| Read amount | POST | /v1/device/read-amount-link-to-merchant |
| Print receipt | POST | /v1/device/print-receipt |
| Update link status | POST | /v1/device/update-shop-device-link-status |
| Devices by Merchant | POST | /v1/device/get-paging |
| Devices by shop | POST | /v1/device/get-devices-link-to-shop-or-va |