> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xanhcard.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Biến trong mẫu thẻ và thông báo

> Danh sách biến được hỗ trợ trong mẫu thẻ và thông báo XanhCard, cú pháp và ví dụ để hiển thị dữ liệu động trên thẻ Apple Wallet và Google Wallet.

## Biến là gì?

Biến cho phép bạn chèn dữ liệu động vào mẫu thẻ và thông báo. Khi thẻ được tạo hoặc thông báo được gửi, biến sẽ được thay thế bằng giá trị thực tế của thẻ đó.

## Các biến được hỗ trợ

| Biến                    | Mô tả                                                                              | Dùng ở đâu |
| ----------------------- | ---------------------------------------------------------------------------------- | ---------- |
| `{{$data.<tenTruong>}}` | Giá trị của trường dữ liệu trên thẻ                                                | Mẫu thẻ    |
| `{{$pass.id}}`          | UUID của thẻ                                                                       | Thông báo  |
| `{{$pass.extId}}`       | ID bên ngoài của thẻ — hiển thị dưới dạng chuỗi rỗng nếu thẻ không có ID bên ngoài | Thông báo  |

## Ví dụ

### Hiển thị tên khách hàng trên thẻ

Trong mẫu thẻ, dùng `{{$data.firstName}}` để hiển thị giá trị của trường `firstName`:

`Xin chào {{$data.firstName}}!`

Khi thẻ được tạo, biến được thay thế bằng giá trị thực tế:

`Xin chào Minh Anh!`

### Cá nhân hóa thông báo

Trong thông báo, dùng `{{$pass.extId}}` để chèn ID bên ngoài của thẻ:

`Truy cập https://xanhcard.com/membership-tier/{{$pass.extId}} để biết thêm!`

Sẽ được hiển thị như:

`Truy cập https://xanhcard.com/membership-tier/1234567890 để biết thêm!`

Biến sẽ được thay thế bằng giá trị của biến đó khi thông báo được gửi.

## Xem thêm

* [Mô hình dữ liệu](/project/data-model) — định nghĩa các trường dữ liệu
* [Thông báo](/distribution/notifications) — gửi thông báo đến thẻ ví