VIETQR API
Tiếng Việt
Tiếng Việt
  • 🇻🇳VIETQR XIN CHÀO!
    • Tổng quan
      • Giới thiệu chung
        • 1️Liên kết với VietQR
      • Mô tả luồng nghiệp API
      • Khai báo merchant connection
      • Các loại QR thanh toán
      • Cần biết về QRcode
    • 📖API VIETQR CALLBACK
      • 1️⃣API Get Token
      • 2️⃣API Transaction Sync
      • 3️⃣Gọi API Get Token
      • 4️⃣Gọi API Generate VietQR Code
      • 5️⃣Gọi API Test Callback
      • Đồng bộ thông tin (api để đối tác tạo cửa hàng)
        • ➕Đồng bộ tổng đại lý
        • ➕Kiểm tra danh sách đại lý
        • ➕Đồng bộ điểm bán
        • ➕Kiểm tra danh sách điểm bán
      • MASTER MERCHANT
      • Retry giao dịch
      • Golive dịch vụ
      • Nghiệm thu GoLive
    • Các Dịch vụ API Khác
      • VietQR Refund APIs
        • 1️Gọi API Check Transaction
        • 2️Gọi API Refund
        • 3️Chú ý đối với refund
      • 🛜API Host to Device (MQTTs)
        • Thiết lập và kết nối
        • MQTT Nhận Biến Động Số Dư
        • MQTT Tạo Mã Thanh Toán VietQR
        • MQTT Nhận Mã Thanh Toán VietQR
        • MQTT Giả Lập Thanh Toán
        • MQTT Tra Cứu Thông Tin Giao Dịch
        • MQTT Phản Hồi Tra Cứu Thông Tin
        • Tài liệu đồng bộ mã điểm bán MQTT
        • Các bước đồng bộ MQTT
      • Host To Client
        • 1️Gọi API Get Token
        • 2️API Ecommerce Sync
        • 3️WS: Sync Bank Account
        • 4️WS: Transaction Sync
        • 5️Đồng bộ tài khoản ngân hàng
        • 6️Gọi API Generate VietQR Code
        • ➕API Check Transaction
      • 📢Cloud Sound Box Push
      • PUSH QR VÀO VIETQR PAYBOX
    • WordPress Plugin
      • 1️Cài đặt Plugin VietQR
      • 2️Liên kết với VietQR
      • 3️Đồng bộ tài khoản ngân hàng
      • 4️Tạo mã QR và nhận biến động số dư
      • ➕[FAQs] Câu hỏi thường gặp
    • API CHO SẢN PHẨM IOT
      • Api Tbị Gọi quầy
      • API cho thiết bị PAYBox
      • API cho thiết bị SoundBox
    • ⁉️Bảng mã lỗi
    • 🏦Danh sách mã ngân hàng
    • 🤖Robot tài chính RPA
      • Quy trình mẫu cho Doanh nghiệp
      • Quy trình mẫu đối với Ngân hàng
    • 🎧Hỗ trợ và liên hệ
    • 1️Mở TK VietQR và liên kết
Powered by GitBook
On this page
  • 1 - API GỬI SỐ TIỀN XUỐNG THIẾT BỊ VOICEBOX
  • 1.1 TỔNG QUAN
  • 1.2 - LUỒNG KẾT NỐI
  • 2 - MÔ TẢ APIs
  • 2.1 GET TOKEN
  • 2.2 GỬI THÔNG TIN SỐ TIỀN XUỐNG THIẾT BỊ
  • HƯỚNG DẪN THỰC HÀNH DÙNG POSHMAN PUSH
  • Bước 1 : GET TOKEN
  • Bước 2 : PUSH ÂM THANH VÀ SỐ TIỀN THÀNH CÔNG XUỐNG THIẾT BỊ :
  1. VIETQR XIN CHÀO!
  2. Các Dịch vụ API Khác

Cloud Sound Box Push

API GỬI SỐ TIỀN XUỐNG THIẾT BỊ VOICEBOX ĐỂ PHÁT ÂM THANH

PreviousAPI Check TransactionNextPUSH QR VÀO VIETQR PAYBOX

Last updated 3 days ago

1 - API GỬI SỐ TIỀN XUỐNG THIẾT BỊ VOICEBOX

1.1 TỔNG QUAN

Tài liệu mô tả quy trình và cách thức sử dụng API của VietQR để gửi thông tin số tiền thanh toán xuống thiết bị Voicebox.

Tài liệu bao gồm:

  • Các thức lấy token xác thực (GET TOKEN)

  • Gọi API chính để truyền dữ liệu (thông tin số tiền thanh toán).

1.2 - LUỒNG KẾT NỐI

2 - MÔ TẢ APIs

2.1 GET TOKEN

Mục đích: API này dùng để tạo Bearer Token cần thiết cho việc xác thực các yêu cầu API tiếp theo (API gửi số tiền thanh toán 2.2).

Method: POST:

Request Header:

Name

Value

Content-Type

application/json

Authorization

Basic Authentication:

Base64[username:password]

Lưu ý: username, password sẽ do VietQR cung cấp

Response Body:

Name

Type

Desc

access_token

String

Là Bearer Token được VietQR cung cấp sau khi hoàn thành bước 4. Dùng để truy cập tạo mã thanh toán VietQR.

token_type

String

Là token dạng “Bearer”

expires_in

int

Thời gian hết hạn của token. Mặc định là 300 giây

cURL:

curl --location --request POST 'https://api.vietqr.org/vqr/api/token_generate' \

--header 'Authorization: Basic Y3VzdG9tZXItdmlldHFydGVzdC11c2VyMjQ2ODpZM1Z6ZEc5dFpYSXRkbWxsZEhGeWRHVnpkQzExYzJWeU1qUTJPQT09'

Response:

{

"access_token": "eyJhbGciOiJIUzUxMiJ9.eyJhdXRob3JpdGllcyI6WyJST0xFX1VTRVIiXSwidXNlciI6IlkzVnpkRzl0WlhJdGRtbGxkSEZ5ZEdWemRDMTFjMlZ5TWpRMk9BPT0iLCJpYXQiOjE3MjEzNzI2MzQsImV4cCI6MTcyMTM3MjkzNH0.D19qvrpYHUgcGjDCXuXXAv3j6lZr6tfmIB0VzdCzAXMJAElGok04sNLysS6PRLdRb0hSgEX5_9KpLjB-xErn-A",

"token_type": "Bearer",

"expires_in": 300

}

2.2 GỬI THÔNG TIN SỐ TIỀN XUỐNG THIẾT BỊ

Mục đích: API này dùng để truyền thông tin số tiền cần thanh toán xuống thiết bị Voicebox để thiết bị đọc thông báo bằng giọng nói.

Method: POST

Request Header:

Request Body:

Name

Type

Desc

amount

long

Số tiền

language

String

Ngôn ngữ (Mặc định: VN)

currency

String

Đơn vị tiền tệ (Mặc định: VND)

serialNumber

String

Mã serial Number của máy

referenceNumber

String

Mã giao dịch duy nhất

checkSum

String

mã hóa checkSum MD5(username + amount + referenceNumber + serialNumber)

Response Body:

Name

Type

Desc

status

String

“SUCCESS”: Thành công

“FAILED”: Thất bại

message

String

Mã lỗi

Thông tin cURL:

curl --location 'https://api.vietqr.org/vqr/api/vnpt-epay/callback' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer eyJhbGciOiJIUzUxMiJ9' \
--header 'Cookie: JSESSIONID=349BED123B39E6FF3D30630E85E46C85' \
--data '{
    "amount": 8000,
    "language": "VN",
    "currency": "VND",
    "referenceNumber": "FT25132940673006",
    "serialNumber": "BT37878837",
    "checkSum": "cee74d89030f6190afea4da84fb41fe5"
}'

Response:

{

"status": "SUCCESS",

"message": ""

}

---------------------------------------------------

HƯỚNG DẪN THỰC HÀNH DÙNG POSHMAN PUSH

Bước 1 : GET TOKEN

Bước 2 : PUSH ÂM THANH VÀ SỐ TIỀN THÀNH CÔNG XUỐNG THIẾT BỊ :

URL:

vnpt-epay/callback

(Link tài liệu )

🇻🇳
📢
https://api.vietqr.org/vqr/api/token_generate
https://api.vietqr.org/vqr/api/
tại đây
Luồng gửi thông báo đọc âm thanh BĐSD
Lấy Token