➕Đồng bộ tổng đại lý

API này dùng để đồng bộ thông tin các đại lý thuộc tổng đại lý.

Khách hàng và đối tác không thuộc diện tổng đại lý có thể bỏ qua bước này.

POST API Sync MID

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

Headers

Name	Value
Content-Type	application/json
Authorization	Bearer <token> Bạn nhận được khi gọi API Get Token của VietQR

Body

Name	Type	Required	Description
merchants	List object	Yes	Danh sách đại lý cần đồng bộ.
merchants[].merchantFullName	String	Yes	Tên đại lý.
merchants[].merchantName	String	Yes	Tên rút gọn đại lý. Không chứa dấu tiếng Việt, không khoảng trắng, không ký tự đặc biệt.
merchants[].merchantAddress	String	Yes	Địa chỉ đăng ký kinh doanh.
merchants[].merchantIdentity	String	Yes	MST/CCCD/ĐKKD
merchants[].checkSum	String	Yes	Chuỗi mã hóa MD5 của tổ hợp: (password+ merchantName+merchantIdentity)
merchants[].contactEmail	String	Optional	Địa chỉ email liên hệ của đại lý.
merchants[].contactPhone	String	Optional	Số điện thoại liên hệ của đại lý.

Response

200

{
    "status": "SUCCESS",
    "data": [
        {
            "mid": "ID_đại_lý",
            "merchantName": "tên_rút_gọn_đại_lý"
        }
    ]
}

400

{
    "status": "FAILED",
    "message": "mã_lỗi"
}

---

Code mẫu

cURL

curl --location 'https://api.vietqr.org/vqr/api/mid/synchronize/v1' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer eyJhbGciOiJIUzUxMiJ9.eyJhdXRob3JpdGllcyI6WyJST0xFX1VTRVIiXSwidXNlciI6IlkzVnpkRzl0WlhJdGJtZDFlV1Z1TFhWelpYSXlORGt5IiwiaWF0IjoxNzIxMzc1MzUzLCJleHAiOjE3MjEzNzU2NTN9.Wi5BTmJ63f7h_p7rimfaycfGIs4TNBkzVGlCUSkOxzWU-QaYZF3rCNndlgPjO89LpRmU3VliSYcf5iHHNrnC7A' \
--header 'Cookie: JSESSIONID=068E5AFD023BFA9AAFBA841C0BF00B62' \
--data-raw '{
    "merchants": [ // DANH SÁCH CỬA HÀNG CẦN ĐỒNG BỘ
        {
            "merchantFullName": "tên_đầy_đủ_của_đại_lý",
            "merchantName": "tên_viết_tắt",
            "merchantAddress": "địa_chỉ_của_đại_lý",
            "merchantIdentity": "Mã_số_thuế",
            "contactEmail": "Email_liên_hệ",
            "contactPhone": "SĐT_liên_hệ",
            "checkSum": "HASHMD5 128bit của: mật_khẩu_get_token + merchant_name + merchantIdentity"
        }
    ]
}'

---

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