@gpmpay/sdk/docs/vi/README.md

Official Node.js SDK for GPM Pay — VietQR codes, transaction webhooks, and payment reconciliation.

# Tài liệu @gpmpay/sdk (Tiếng Việt)

[English](../en/README.md) · [README package](../../README.md)

1. **[Bắt đầu](./01-getting-started.md)** — tạo token, cài đặt, khoản thanh toán đầu tiên, thử end-to-end không cần tiền thật
2. **[Thanh toán & đối soát](./02-payments.md)** — mô hình thanh toán, chọn mã đối soát, các bẫy khớp lệnh, tiền tệ, VietQR
3. **[Webhook từ A đến Z](./03-webhooks.md)** — đăng ký, xác thực chữ ký, Express/Next/framework khác, retry, debug
4. **[Xử lý lỗi & testing](./04-errors-and-testing.md)** — cây lỗi, chính sách retry, sandbox, unit test
5. **[Tham chiếu API](./05-api-reference.md)** — mọi option, method, kiểu dữ liệu

## Đọc gì trước

| Bạn muốn | Đọc |
|---|---|
| Nhận thanh toán nhanh nhất | 1 → 3 |
| Hiểu vì sao khoản tiền không khớp | 2 (mục "Chọn mã như thế nào") |
| Webhook luôn báo sai chữ ký | 3 (mục "Sự cố thường gặp") |
| Viết test cho tích hợp | 4 |
| Tra chữ ký của một method | 5 |
| Để AI agent tự tích hợp | [`AGENTS.md`](../../AGENTS.md) |

## Ví dụ chạy được

Xem [`examples/`](../../examples/):

- `self-reconcile/` — Express: checkout dựng QR, route webhook tự đối soát. **Bắt đầu ở đây.**
- `next-app-router/` — Next.js App Router, server action + route handler