> For the complete documentation index, see [llms.txt](https://docs.loomgate.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.loomgate.io/concepts/amounts-and-fees.md).

# Số tiền, tiền tệ và phí

Đơn vị tiền, tiền tệ, giới hạn số tiền, phí xử lý, phí ngân hàng và ai chịu phí.

## Đơn vị và tiền tệ

* Mọi số tiền là **số nguyên theo đơn vị nhỏ nhất** của tiền tệ (cent): `10000` = 100,00 USD, `125` = 1,25 EUR. Không dùng số thập phân.
* Tiền tệ hỗ trợ: `usd` và `eur` (viết thường). Tiền tệ khác trả `unsupported_currency`.
* Số tiền người mua trả (`amount_total`) phải từ **100** (1,00) tới **99 999 999** (999 999,99). Nhỏ hơn trả `amount_too_small`, lớn hơn trả `amount_too_large`.

## Phí của một payment

Mỗi payment có hai khoản phí, tính trên `amount` theo biểu phí của bạn:

| Trường           | Nghĩa                        |
| ---------------- | ---------------------------- |
| `processing_fee` | Phí xử lý thanh toán         |
| `bank_fee`       | Phí ngân hàng, mỗi giao dịch |

Mỗi khoản phí là **phần trăm** (có thể có mức tối thiểu, tối đa) hoặc **cố định**, riêng cho từng tiền tệ. Biểu phí do Loomgate (hoặc đại lý của bạn) thiết lập; xem trong mục **Phí** của dashboard. Phí được tính lúc tạo payment và gắn cố định vào payment đó: biểu phí đổi sau đó không ảnh hưởng payment đã tạo.

## Ai chịu phí

Bạn chọn trong mục **Cài đặt** của dashboard (`fee_bearer`). Hai khoản phí luôn do cùng một bên chịu.

{% tabs %}
{% tab title="Người mua chịu (buyer)" %}
Phí được cộng vào số tiền người mua trả:

| Trường                               | Ví dụ                            |
| ------------------------------------ | -------------------------------- |
| `amount`                             | 10000                            |
| `processing_fee`                     | 290                              |
| `bank_fee`                           | 30                               |
| `fee_buyer` = processing + bank      | 320                              |
| `amount_total` = amount + fee\_buyer | **10320** (người mua trả 103,20) |
| Bạn nhận                             | 10000                            |

Hãy hiển thị dòng phí cho người mua trước khi họ trả. Tên dòng phí (`label`, mặc định "Processing fee") đặt ở mục **Cài đặt**. Dùng [Fee quotes](/api-reference/fee-quotes.md) để biết số phí trước khi tạo payment (ví dụ ở trang giỏ hàng).

{% hint style="info" %}
Cộng phí cho người mua (phụ phí thẻ) có thể bị hạn chế ở một số thị trường. Bạn tự chịu trách nhiệm tuân thủ quy định nơi bạn bán hàng. Dòng phí này không được hoàn khi bạn hoàn tiền (xem [Hoàn tiền](/concepts/refunds.md)).
{% endhint %}
{% endtab %}

{% tab title="Bạn chịu (merchant)" %}
Người mua trả đúng `amount`, phí trừ vào phần bạn nhận:

| Trường                        | Ví dụ                            |
| ----------------------------- | -------------------------------- |
| `amount`                      | 10000                            |
| `fee_buyer`                   | 0                                |
| `amount_total`                | **10000** (người mua trả 100,00) |
| `processing_fee` + `bank_fee` | 290 + 30                         |
| Bạn nhận                      | 9680                             |

Nếu tổng phí bằng hoặc lớn hơn `amount`, API trả `amount_too_small`.
{% endtab %}
{% endtabs %}

Các con số trên chỉ là ví dụ; phí thực tế theo biểu phí của bạn.

## Phí khác

* **Phí hoàn tiền** (`refund_fee`): tính cho bạn mỗi lần hoàn tiền, trừ vào số dư. Xem [Hoàn tiền](/concepts/refunds.md).
* **Khoản điều chỉnh** (ví dụ khi người mua khiếu nại giao dịch với ngân hàng): Loomgate ghi một `adjustment` âm hoặc dương vào số dư của bạn và gửi webhook `adjustment.created`. Xem [Số dư và giờ mở khóa](/concepts/balance.md).


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://docs.loomgate.io/concepts/amounts-and-fees.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.