search

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

circle-check

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

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

hashtag
Code mẫu

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

PreviousĐồng bộ thông tinNextKiểm tra danh sách đại lý