# Dịch vụ lấy hạng thành viên trung thành

### Giới thiệu dịch vụ  <a href="#gioi-thieu-dich-vu" id="gioi-thieu-dich-vu"></a>

Là giải pháp giúp các bên đối tác lấy hạng của thành viên trung thành (vàng, bạc đồng) của VinID.

Khách hàng mua hàng, sử dụng dịch vụ của đối tác VinID khi đối tác không có hệ thống loyalty, khi thực hiện thanh toán bằng VinID, hệ thống sẽ lấy hạng thành viên của khách hàng. Theo đó, khách hàng sẽ được giảm giá dựa theo thứ hạng thành viên của mình trong VinID.

### Luồng người dùng sử dụng dịch vụ <a href="#luong-nguoi-dung-su-dung-dich-vu" id="luong-nguoi-dung-su-dung-dich-vu"></a>

![](/files/-Mg3yXnNtlvBVZBCqXCP)

### Sơ đồ xử lý kĩ thuật <a href="#so-do-xu-ly-ki-thuat" id="so-do-xu-ly-ki-thuat"></a>

>

![](/files/-Mg3yqNzmY_jaSYKtttu)

### APIs <a href="#apis" id="apis"></a>

{% hint style="info" %}
Lưu ý:

Merchant muốn lấy thông tin hạng thành viên VinID cần được cấp quyền cụ thể `allow_loyalty_membership_check`. Khi onboard một merchant hoặc một merchant đăng kí sử dụng dịch vụ này cần được set thêm quyền này trong database.
{% endhint %}

## Lấy thông tin hạng thành viên&#x20;

<mark style="color:blue;">`GET`</mark> `{API_HOST}/merchant-integration/v1/loyalty/membership?id_type=string&identity=string&business_code=string&program_code=string`

#### Path Parameters

| Name           | Type   | Description                                                                                                                                |
| -------------- | ------ | ------------------------------------------------------------------------------------------------------------------------------------------ |
| id\_type       | string | <p>USER\_ID: Vinid User<br>MOBILE: User's phonenumber<br>CARD: Loyalty Card Number<br>MEMBER\_ID: Member code, Customer Loyalty Number</p> |
| identity       | string | user\_id, phone number, card number, member code according to id\_type                                                                     |
| business\_code | string | the owner of the loyalty program, eg: VGC                                                                                                  |
| program\_code  | string | the loyalty program, eg: VGC                                                                                                               |

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

```
{
  "data": {
    "member": {
      "member_code": "string",
      "full_name": "string"
    },
    "tier_info": {
      "tier_code": "string",
      "tier_name": "string",
      "description": "string"
    } 
  },
  "meta": {
    "code": int,
    "message": "string"
  }
}

```

{% endtab %}
{% endtabs %}

### Những mã lỗi có thể xảy ra <a href="#nhung-ma-loi-co-the-xay-ra" id="nhung-ma-loi-co-the-xay-ra"></a>

* 401005: identity\_type not supported
* 400002: invalid phone\_number format
* 401006: invalid customer id
* 401007: invalid loyalty business
* 401008: invalid loyalty program
* 500503: generic OLS error


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://developers.vinid.net/tai-lieu-tich-hop/tich-hop-voi-vinid-loyalty/dich-vu-lay-hang-thanh-vien-trung-thanh.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.