<!-- Source: https://docs.infraio.xyz/vi/get-started/introduction -->
<!-- Last updated: 2026-10-04 -->

# Giới thiệu

## Hình dáng của một giao dịch thanh toán

Một merchant tích hợp InfraIO Pay sẽ làm việc với bốn thành phần chính:

### Checkout session

Bạn tạo session ở phía server với line items và tổng tiền. Response trả
về `session_key` (`cst_…`) và `checkout_url`. Session có giới hạn thời gian (mặc định
30 phút) và chỉ dùng một lần.

### Trang thanh toán dựng sẵn

Bạn load SDK trình duyệt của chúng tôi và mở session — popup, redirect,
hoặc iframe nhúng. Người mua chọn cặp chain × asset (USDT trên Polygon,
ETH trên Base, …), thấy địa chỉ nhận tiền riêng cho từng đơn + QR được sinh ra, và gửi tiền
từ ví của họ.

### Xác nhận thanh toán

InfraIO Pay theo dõi network tương ứng để phát hiện các giao dịch
chuyển vào khớp với địa chỉ nhận tiền riêng cho từng đơn của session. Khi đã đủ số block
confirmation cấu hình (ví dụ 12 trên Ethereum mainnet, 5 trên Polygon —
xem [Chains & tài sản](https://docs.infraio.xyz/vi/concepts/chains)), PaymentIntent bên dưới
chuyển sang `SETTLED` và Order cha chuyển sang `PAID`.

Trên TRON, Solana và TON không có địa chỉ nhận tiền riêng cho từng đơn. Ví của người mua trả thẳng vào ví Treasury của bạn (TronLink, mã QR Solana Pay, hoặc TON Connect) và InfraIO Pay nhận diện khoản thanh toán đó. Xem [Chains & tài sản](https://docs.infraio.xyz/vi/concepts/chains).

> Thanh toán đi thẳng vào các ví Treasury của bạn — InfraIO Pay không bao giờ giữ tiền của bạn.

### Webhook

Chúng tôi POST một event `payment.settled` đã ký vào URL webhook bạn
đã đăng ký. Server của bạn xác thực chữ ký, tra cứu đơn hàng, và thực hiện
fulfillment.

## Mô hình dữ liệu trong một sơ đồ

```
CheckoutSession  ←  1:1  →  Order  ←  1:N  →  PaymentIntent
   (có giới hạn thời gian)  (vĩnh viễn)        (mỗi lần thử trả)
```

Bạn tư duy theo **Order** để fulfillment, bạn tạo **Session** để thu
tiền, và hệ thống tự quản lý **PaymentIntent** ở hậu trường cho việc
retry và chọn network.

## Chúng tôi xử lý gì so với bạn xử lý gì

| InfraIO Pay xử lý | Bạn xử lý |
| --- | --- |
| UI trang thanh toán dựng sẵn (địa chỉ nhận tiền riêng cho từng đơn, QR, lựa chọn tài sản) | Tạo Catalog + Order trong DB của bạn |
| Giám sát chain + logic confirmation trên 8 EVM chain cùng TRON, Solana và TON (sắp ra mắt) | Webhook receiver + xác thực chữ ký |
| Checkout stablecoin đa tài sản (USDT, USDC theo từng network) | Ánh xạ `order_id` của chúng tôi ↔ order ID của bạn qua `external_ref` |
| Hạch toán refund (state machine, dashboard, API) | Ký + broadcast giao dịch refund on-chain |
| Khóa test-mode + webhook test cô lập | Nạp tiền cho ví testnet từ faucet |

> **Note:**
>
> Chúng tôi không lưu ký vốn của merchant. Các giao dịch chuyển từ
> người mua sang merchant diễn ra **trực tiếp** on-chain; chúng tôi
> là lớp indexer + đối soát thông báo cho bạn biết khi nào giao dịch
> đã hoàn tất.

## Chế độ thử nghiệm và chế độ live

Mọi tài khoản đều bắt đầu ở **chế độ thử nghiệm**. Khóa test có prefix
`pk_test_` / `sk_test_`. Khóa live (`pk_live_` / `sk_live_`) khả dụng
sau khi bạn hoàn tất xác minh tài khoản và thêm ví Treasury cho mỗi
network bạn muốn nhận tiền (bạn ký một thông điệp để chứng minh quyền
kiểm soát ví).

Cùng một base URL phục vụ cả hai môi trường — môi trường được xác
định bởi prefix của key, không phải URL. Chế độ thử nghiệm chạy trên **các
testnet thật** (Sepolia, Base Sepolia, BSC Testnet, v.v.) — không có
chain giả lập. Để kích hoạt một giao dịch thử, bạn cần token testnet
thật từ faucet.

## Liên hệ / hỗ trợ

Có câu hỏi hoặc cần trợ giúp? Gửi email tới [contact@lartech.xyz](mailto:contact@lartech.xyz).

## InfraIO Pay KHÔNG phải là gì

- **Không phải đơn vị lưu ký.** Vốn chuyển trực tiếp từ người mua
  sang ví Treasury của bạn on-chain. Chúng tôi không bao giờ giữ số dư của bạn.
- **Không yêu cầu dùng ví riêng.** Khách hàng trả từ ví của chính họ (trang checkout do hệ thống
  host có tùy chọn WalletConnect tích hợp sẵn). [InfraIO Wallet](https://docs.infraio.xyz/vi/wallet/overview)
  là một ví passkey không lưu ký riêng biệt và không bắt buộc phải dùng.
- **Không phải fiat ramp.** Người mua trả bằng tài sản crypto họ có;
  chúng tôi không chuyển đổi.
- **Không phải gateway Bitcoin.** Stablecoin trên 8 network EVM cùng TRON, Solana và TON (sắp ra mắt); không có Bitcoin hay Lightning. Xem [Chains & tài sản](https://docs.infraio.xyz/vi/concepts/chains) để biết ma trận đang hỗ trợ.

## Tiếp theo

- [Bắt đầu nhanh](https://docs.infraio.xyz/vi/get-started/quickstart) — copy-paste tích hợp
  đầu tiên trong khoảng 10 phút.
- [Khái niệm → Sessions](https://docs.infraio.xyz/vi/concepts/sessions) — mô hình dữ liệu chi
  tiết.
- [SDK → JavaScript](https://docs.infraio.xyz/vi/sdks/javascript) — SDK duy nhất đã phát hành
  cho đến nay.
- [Giá & phí](https://docs.infraio.xyz/vi/concepts/pricing) — các bậc theo khối lượng và mức giảm phí.
- [Merchant app](https://docs.infraio.xyz/vi/get-started/merchant-app) — quản lý việc kinh doanh từ điện thoại của bạn.