➕Đồ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>

Body

Name	Type	Required	Description
merchants	List object	Yes	Danh sách đại lý cần đồng bộ.
merchantId	String	Yes	ID của đại lý. (Để null nếu là đồng bộ mới)
merchantFullName	String	Yes	Tên đại lý.
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.
merchantAddress	String	Yes	Địa chỉ đăng ký kinh doanh.
merchantIdentity	String	Yes	MST/CCCD/ĐKKD
checkSum	String	Yes	Chuỗi mã hóa MD5 của tổ hợp: (password+ merchantName+merchantIdentity)
contactEmail	String	Optional	Địa chỉ email liên hệ của đại lý.
contactPhone	String	Optional	Số điện thoại liên hệ của đại lý.
career	String	Optional	Ngành nghề đăng ký kinh doanh.

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_và_mô_tả_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