Sync MID(s)

This API is used to synchronize information of sub-agents under the main agent.

POST

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	List JSON object of merchants.
merchantId	String	Yes	ID of merchant. (null if create new)
merchantFullName	String	Yes	Full name of merchant.
merchantName	String	Yes	Short name of the merchant. No diacritics, no spaces, no special characters.
merchantAddress	String	Yes	Business registration address.
merchantIdentity	String	Yes	Tax code/Identity card/Business registration certificate.
checkSum	String	Yes	Encrypted MD5 string of combination: (password+merchantName+ merchantIdentity)
contactEmail	String	Optional	Contact email of the merchant.
contactPhone	String	Optional	Contact phone number of the merchant.
career	String	Optional	Registered business sector.

Response

200

{
    "status": "SUCCESS",
    "data": [
        {
            "mid": "merchant_ID",
            "merchantName": "merchant_short_name"
        }
    ]
}

400

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