➕Đồng bộ điểm bán

Dùng để đồng bộ thông tin các cửa hàng/điểm bán.

POST API Sync TID

https://<vietqr-host>/<basepath>/api/tid/synchronize/v1

Headers

Name	Value
Content-Type	application/json
Authorization	Bearer <token>

Body

Đối tác truyền merchantId thì không cần truyền merchantName.

Name	Type	Required	Description
terminals	List object	Yes	Danh sách các điểm bán.
merchantId	String	Yes	ID của đại lý.
merchantName	String	Yes	Tên rút gọn đại lý.
terminalCode	String	Yes	Mã cửa hàng/điểm bán.
terminalName	String	Yes	Tên cửa hàng/điểm bán.
terminalAddress	String	Yes	Địa chỉ cửa hàng/điểm bán.
bankCode	String	Yes	Mã ngân hàng.
bankAccount	String	Yes	Số tài khoản ngân hàng.
checkSum	String	Yes	Chuỗi mã hóa MD5 của tổ hợp: (password + bankCode + bankAccount)

Response

200

{
    "status": "SUCCESS",
    "data": [
        {
            "tid": "ID_điểm_bán",
            "terminalName": "tên_điểm_bán",
            "terminalCode": "mã_điểm_bán",
            "bankAccount": "số_tài_khoản_áp_dụng_cho_điểm_bán",
            "bankCode": "mã_ngân_hàng"
        }
    ]
}

400

{
    "status": "FAILED",
    "message": "mã_lỗi_và_mô_tả_lỗi"
}

---

Code mẫu

cURL

curl --location 'https://api.vietqr.org/vqr/api/tid/synchronize/v1' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer eyJhbGciOiJIUzUxMiJ9.eyJhdXRob3JpdGllcyI6WyJST0xFX1VTRVIiXSwidXNlciI6IlkzVnpkRzl0WlhJdGJtZDFlV1Z1TFhWelpYSXlORGt5IiwiaWF0IjoxNzIwMDg4MDE3LCJleHAiOjE3MjAwODgwNzZ9.3_jljTg8llYVANJW4MVqW6YsJZbFl10r2AC66NNXCuSDWMyNYd2MlbnStNuyjHIqYDO5E5jD0izl4puPckYSyw' \
--header 'Cookie: JSESSIONID=EB9099326C4526CAA29AD331FFE6B789' \
--data '{
    "terminals": [ //DANH SÁCH CỬA HÀNG CỦA ĐẠI LÝ C ̀N ĐỒNG BỘ
        {
            "mid": "id_của_đại_lý", 
            "merchantName": "tên_viết_tắt_của_đại_lý", 
            "terminalName": "tên_cửa_hàng",
            "terminalCode": "mã_code_của_cửa_hàng",
            "terminalAddress": "địa_chỉ_của_cửa_hàng",
            "bankAccount": "số_tài_khoản_ngân_hàng",
            "bankCode": "mã_code_của_ngân_hàng",
            "checkSum": "HASHMD5 128 bit của: password_khi_get_token + bank_code + bankAccount" 
            
        }
    ]
}'

---

Các câu hỏi thường gặp