> 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/balance.md).

# Số dư và giờ mở khóa

Số dư khả dụng, số dư đang chờ và khi nào tiền được mở khóa.

Loomgate giữ một số dư cho tài khoản của bạn theo từng tiền tệ. Số dư chỉ thay đổi qua các bút toán: tiền thu, phí, hoàn tiền, phí hoàn tiền và khoản điều chỉnh. Bút toán không bao giờ bị sửa hay xóa.

| Phần              | Nghĩa                                                           |
| ----------------- | --------------------------------------------------------------- |
| `available`       | Tiền đã qua giờ mở khóa                                         |
| `pending`         | Tiền của các mốc mở khóa chưa tới giờ                           |
| `pending_unlocks` | Phần đang chờ, chia theo tiền tệ và giờ mở khóa, sớm nhất trước |

Số dư có thể **âm**, ví dụ khi phí hoàn tiền hay một khoản điều chỉnh lớn hơn số dư khả dụng. Đọc số dư bằng [Balance API](/api-reference/balance.md) hoặc xem ở mục **Tổng quan** của dashboard.

## Lịch mở khóa

Tiền một payment thành công mang về cho bạn, tức tổng người mua trả (`amount_total`) trừ phí xử lý và phí ngân hàng, được mở khóa dần theo các **mốc** "sau N ngày, X %", ví dụ 80 % sau 14 ngày rồi 20 % sau 30 ngày. Loomgate thiết lập các mốc cho tài khoản của bạn; xem chúng ở trang **Phí** của dashboard, mục *Lịch mở khóa tiền*.

Khi payment thành công, các mốc đang áp cho tài khoản được chép vào payment, ở trường `unlock_schedule`, và không đổi nữa: thay đổi lịch về sau chỉ áp cho payment thành công sau đó. Giờ mở khóa của mỗi mốc:

1. Lấy thời điểm payment thành công.
2. Cộng số ngày của mốc (ngày lịch, mỗi ngày 24 giờ).
3. Làm tròn lên phút **:00 hoặc :30** kế tiếp.

Phần của mỗi mốc tính theo tỷ lệ lũy kế và làm tròn một lần; mốc cuối nhận phần còn lại, nên các mốc cộng lại đúng bằng số payment mang về. Ví dụ, payment 100,00 US$ do bạn chịu phí 2,90 % + 0,30 US$ mang về 96,80 US$: 77,44 US$ mở khóa sau 14 ngày và 19,36 US$ sau 30 ngày.

Mỗi phần tử của `unlock_schedule`:

| Trường         | Nghĩa                                                                                        |
| -------------- | -------------------------------------------------------------------------------------------- |
| `step`         | Số thứ tự của mốc, từ 1                                                                      |
| `days`         | Số ngày sau khi payment thành công (`null` với payment thành công trước khi có lịch mở khóa) |
| `percent_bps`  | Tỷ lệ của mốc, tính bằng basis point (8000 = 80 %)                                           |
| `available_at` | Giờ mở khóa của mốc (unix giây)                                                              |
| `amount`       | Phần của mốc                                                                                 |
| `deducted`     | Phần hoàn tiền (kèm phí hoàn tiền) đã trừ vào mốc                                            |
| `remaining`    | `amount` − `deducted`                                                                        |
| `rescheduled`  | `true` khi Loomgate đã đổi giờ mở khóa của mốc                                               |

`unlock_schedule` là mảng rỗng cho tới khi payment thành công. Từ giờ mở khóa của một mốc, tiền của mốc chuyển sang `available` (trễ vài giây sau giờ đó) và, nếu mốc còn tiền, Loomgate gửi webhook [`unlock_step.available`](/webhooks/webhook-events.md).

## Hoàn tiền trước giờ mở khóa

Một lần hoàn tiền, rồi phí hoàn tiền của nó, được trừ vào các mốc còn khóa của chính payment đó, mốc có giờ mở khóa gần nhất trước (`deducted` của mốc tăng lên). Phần không còn mốc khóa nào chứa thì trừ ngay vào `available`. Xem [Hoàn tiền](/concepts/refunds.md).

## Khoản điều chỉnh

Loomgate có thể ghi một khoản điều chỉnh (`adjustment`, id `adj_…`) vào số dư của bạn, ví dụ số âm khi người mua khiếu nại giao dịch với ngân hàng. Khoản điều chỉnh có hiệu lực ngay vào `available` và kèm webhook `adjustment.created`:

```json
{
  "id": "adj_7Tn2KqL9WmX4cV8bR1sD",
  "object": "adjustment",
  "currency": "usd",
  "amount": -1500,
  "reason": "Chargeback for order 1042",
  "payment_intent": "lg_pi_4Qx9ZcM2LwT8rKv1bN3a",
  "created": 1790000000
}
```

`payment_intent` là `null` khi khoản điều chỉnh không gắn với payment nào.

## Chi trả

API chỉ cho xem số dư. Việc chuyển số dư khả dụng cho bạn do Loomgate thực hiện bên ngoài API.


---

# 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/balance.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.