# API Host to Device (MQTTs)

### Mô tả

<figure><img src="https://content.gitbook.com/content/nFD4zf0rcZoWICdWxHJr/blobs/TWpStTMbuE5JEFSxsxzp/Process%20Map.png" alt=""><figcaption></figcaption></figure>

<figure><img src="https://content.gitbook.com/content/nFD4zf0rcZoWICdWxHJr/blobs/i22eXb7a6dTPAsSpYNuH/image.png" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
Đối tác cần hoàn tất quá trình đăng ký tài khoản với đầy đủ thông tin nhằm định danh và bảo mật tài khoản. Thông tin tích hợp mặc định sẽ là môi trường Test (Sandbox).
{% endhint %}

**Các bước cơ bản để tích hợp với VietQR:**

1. Liên kết với VietQR.
2. Thiết lập và kết nối với VIetQR MQTTs.
3. Đối tác triển khai trước MQTT nhận Biến Động Số Dư.
4. Đối tác triển khai MQTT yêu cầu tạo mã thanh toán VietQR.
5. Đối tác triển khai MQTT nhận phản hồi thanh toán VietQR.
6. Đối tác triển khai MQTT giả lập thanh toán thành công (Áp dụng bước này đối với môi trường Test).
7. Nghiệm thu và yêu cầu GoLive trên môi trường sản xuất.

***

### Thông số kết nối

| Param          | Type   | Description                                                                         |
| -------------- | ------ | ----------------------------------------------------------------------------------- |
| Broker         | String | Địa chỉ của broker để **publishers** và **subscribers** kết nối                     |
| Username       | String | Tên đăng nhập để xác thực với broker (nếu có).                                      |
| Password       | String | Mật khẩu đăng nhập để xác thực với broker (nếu có).                                 |
| Topic request  | String | Topic để **publishers** gửi yêu cầu.                                                |
| Topic response | String | Topic để **publishers** gửi phản hồi lại cho **subscribers** sau khi xử lý yêu cầu. |

{% hint style="success" %}
**Thông số kết nối sẽ được VietQr cung cấp cho đối tác.**
{% endhint %}

{% hint style="info" %}
**Publishers** : Là các thực thể (thiết bị, ứng dụng) gửi dữ liệu hoặc thông điệp lên một topic cụ thể trên broker. Publishers không cần biết đến các subscribers (người nhận) mà chỉ cần gửi thông điệp lên topic.
{% endhint %}

{% hint style="info" %}
**Subscribers** : Là các thực thể đăng ký nhận thông điệp từ một hoặc nhiều topics trên broker. Khi có một thông điệp mới được gửi lên topic mà họ đã đăng ký, broker sẽ chuyển tiếp thông điệp đó đến subscribers.
{% endhint %}

***