➕Check Merchant List

Used to retrieve the list of synchronized agencies under the master merchant.

POST API Get MID

https://<vietqr-host>/<basepath>/api/mid/list-mid

Headers

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

Body

Name	Type	Required	Description
page	Integer	Optional	Page value you want to display.
size	Integer	Optional	Maximum number of items displayed per page.

Response

200

{
    "metadata": {
        "page": 1,
        "size": 20,
        "totalPage": 1,
        "totalElement": 1
    },
    "data": [
        {
            "merchantIdentify": "Tax_Code/ID_Card/Business_Registration_Number",
            "mid": "merchant_ID",
            "merchantName": "Shortened_merchant_Name",
            "merchantFullName": "merchant_Full_Name",
            "merchantAddress": "merchant_Address",
            "contactEmail": "Contact_Email",
            "contactPhone": "Contact_Phone"
        }
    ]
}

400

{
    "status": "FAILED",
    "message": "error_code_and_description"
}

---

Sample

cURL

curl --location 'https://api.vietqr.org/vqr/api/mid/list-mid?page=page_cần_chọn&size=số_record_cần_hiển_thị_trong_1_lần&mid=id_của_đại_lý' \
--header 'Authorization: Bearer eyJhbGciOiJIUzUxMiJ9.eyJhdXRob3JpdGllcyI6WyJST0xFX1VTRVIiXSwidXNlciI6IlkzVnpkRzl0WlhJdGJtZDFlV1Z1TFhWelpYSXlORGt5IiwiaWF0IjoxNzIxMzc1MTUyLCJleHAiOjE3MjEzNzU0NTJ9.M-Yfnvm_mZGVteqoZ4aLdN2m_7_c8BwUHnzHm0WPOMW5ayTk49HWLtpl562AdgS_BUBUAS0648BktOaGzy6h8Q' \
--header 'Cookie: JSESSIONID=483ACB24C22E803DCFB52C2D89CCB4B0'