> For the complete documentation index, see [llms.txt](https://api.vietqr.vn/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://api.vietqr.vn/en/vn/api-vietqr-callback/synchronize-information/synchronize-master-agent.md).

# Synchronize master agent

{% hint style="danger" %}
Customers and partners who are not under the master agent category can skip this step.
{% endhint %}

<mark style="color:green;">**`POST`**</mark> API Sync MID

```
https://<vietqr-host>/<basepath>/api/mid/synchronize/v1
```

**Headers**

<table><thead><tr><th width="209.5703125">Name</th><th>Value</th></tr></thead><tbody><tr><td>Content-Type</td><td><code>application/json</code></td></tr><tr><td>Authorization</td><td><code>Bearer &#x3C;token></code></td></tr></tbody></table>

**Body**

<table data-full-width="false"><thead><tr><th width="211">Name</th><th width="106.296875">Type</th><th width="88.3671875">Required</th><th>Description</th></tr></thead><tbody><tr><td><code>merchants</code></td><td>List object</td><td>Yes</td><td>List of agents to be synchronized.</td></tr><tr><td><code>merchantId</code></td><td>String</td><td>Yes</td><td>Agent ID. (Set to null if it is a new synchronization)</td></tr><tr><td><code>merchantFullName</code></td><td>String</td><td>Yes</td><td>Agent name.</td></tr><tr><td><code>merchantName</code></td><td>String</td><td>Yes</td><td><p>Agent short name.</p><p>Must not contain Vietnamese accents, spaces, or special characters.</p></td></tr><tr><td><code>merchantAddress</code></td><td>String</td><td>Yes</td><td>Registered business address.</td></tr><tr><td><code>merchantIdentity</code></td><td>String</td><td>Yes</td><td>Tax Identification Number (MST) / Citizen Identification Number (CCCD) / Business Registration Number (ĐKKD)</td></tr><tr><td><code>checkSum</code></td><td>String</td><td>Yes</td><td><p>MD5 hash string of the combination:</p><p>(password + merchantName + merchantIdentity)</p><p>(<code>password</code>+ <code>merchantName</code>+<code>merchantIdentity</code>)</p></td></tr><tr><td><code>contactEmail</code></td><td>String</td><td>Optional</td><td>Agent’s contact email address.</td></tr><tr><td><code>contactPhone</code></td><td>String</td><td>Optional</td><td>Agent’s contact phone number.</td></tr><tr><td><code>career</code></td><td>String</td><td>Optional</td><td>Registered business industry.</td></tr></tbody></table>

**Response**

{% tabs %}
{% tab title="200" %}

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

{% endtab %}

{% tab title="400" %}

```json
{
    "status": "FAILED",
    "message": "mã_lỗi_và_mô_tả_lỗi"
}
```

{% endtab %}
{% endtabs %}

### Sample Code

{% tabs %}
{% tab title="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": [ // List of stores to be synchronized.
        {
            "merchantFullName": "Full name of the agent.",
            "merchantName": "Abbreviated name.",
            "merchantAddress": "Agent’s address.",
            "merchantIdentity": "Tax Identification Number.",
            "contactEmail": "Contact email",
            "contactPhone": "Contact phone number",
            "checkSum": "HASHMD5 128bit của: mật_khẩu_get_token + merchant_name + merchantIdentity"
        }
    ]
}'
```

{% endtab %}
{% endtabs %}

### Frequently Asked Questions (FAQs)