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

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

Last updated