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

# Lỗi

> Các trạng thái HTTP, lỗi SDK và trạng thái CLI mà người bán và agent gặp thường xuyên nhất, kèm cách khắc phục cho từng mục.

## Trạng thái HTTP từ InFlow

| Trạng thái | Mã | Ý nghĩa | Cách khắc phục |
| - | - | - | - |
| `401` | Không có body có cấu trúc | Credential bị thiếu, không hợp lệ hoặc đã hết hạn. | Kiểm tra API key và môi trường. |
| `403` | `SELLER_ACCOUNT_REQUIRED` | Credential hợp lệ, nhưng không thuộc về một tài khoản Seller. | Tạo một key trong một tài khoản Seller. |

## Lỗi SDK người bán

| Lỗi | Package | Nguyên nhân | Cách khắc phục |
| - | - | - | - |
| `InflowApiError` | `@inflowpayai/x402`, `@inflowpayai/mpp` | Một lời gọi API InFlow thất bại. | Với x402, đọc `error.code`. Với MPP, đọc `error.body`. Với `SELLER_ACCOUNT_REQUIRED`, đổi key. |
| `RouteConfigurationError` | Middleware `@x402/core` | Không có scheme đã đăng ký nào bao quát một cặp scheme và network mà một endpoint công bố. | Truyền `await inflowSchemeRegistrations(seller)` làm đối số thứ ba cho `paymentMiddlewareFromConfig`. |
| `MppUnsupportedCurrencyError` | `@inflowpayai/mpp-seller` | Loại tiền của khoản thu không có rail nào trong cấu hình PSP. | Thu phí bằng một loại tiền được hỗ trợ, ví dụ `USDC` hoặc `USD`. |
| `MppCredentialProblemError` | `@inflowpayai/mpp-seller` | Bước kiểm tra credential hoặc bước broadcast thất bại. Lỗi này mang một problem RFC 9457 từ PSP. | Đọc problem. Chọn giữa một challenge mới và một lỗi dứt điểm. Trạng thái `500` nghĩa là chưa biết kết quả. Không tạo một khoản thanh toán mới. |
| `MppCardUnavailableError` | `@inflowpayai/mpp-seller` | Cấu hình người bán không công bố khả năng USD Visa CARD. | Bật thẻ cho tài khoản Seller của bạn. |
| `MppStripeUnavailableError` | `@inflowpayai/mpp-seller` | Người bán không có khả năng Stripe nào an toàn để dùng. | Kết nối một tài khoản Stripe với tài khoản Seller của bạn. |
| `MppStripeAmountError` | `@inflowpayai/mpp-seller` | Số tiền nhỏ hơn USD 0.50, lớn hơn USD 999,999.99 hoặc không phải số cent nguyên. | Thu phí một số tiền trong khoảng này, theo số cent nguyên. |
| `InflowConfigurationError` | Các SDK Node.js của InFlow | `INFLOW_HTTP_PROXY` có giá trị, nhưng thiếu package tùy chọn `undici`. Lỗi xuất hiện ở request đầu tiên. | Cài đặt `undici`, hoặc xóa biến này. |
| `No payment offers are available for this request` | `@inflowpayai/mpp-seller` | `canOffer` từ chối mọi offer. | Kiểm tra các hook `canOffer` của bạn. `selectOffers` cũng phải trả về ít nhất một offer. |

### Bắt lỗi tài khoản khi khởi động

```ts theme={null}
import { InflowApiError } from '@inflowpayai/x402';

try {
  await startSeller();
} catch (error) {
  if (error instanceof InflowApiError && error.code === 'SELLER_ACCOUNT_REQUIRED') {
    throw new Error('Configure a Seller account API key for this integration.');
  }
  throw error;
}
```

Với MPP, response có cấu trúc nằm trong `error.body`. Phương thức thanh toán `inflow` của MPP tải cấu hình trong nền, nên lỗi có thể xảy ra ở request trả phí đầu tiên.

## Trạng thái CLI

| Trạng thái | Ý nghĩa | Cách khắc phục |
| - | - | - |
| `authenticated` là `false` | CLI không có phiên hợp lệ. | Chạy `inflow auth login`. |
| Response có trường `update` | Có phiên bản CLI mới hơn. | Chạy lại trình cài đặt. Phiên bản hiện tại vẫn hoạt động. |
| Một lỗi về vault cần con người thao tác | Vault đang khóa hoặc chưa khởi tạo. | Chủ sở hữu chạy `inflow vault unlock` trong một terminal. |
| Khoản thanh toán vẫn ở trạng thái chờ | Chủ sở hữu chưa phê duyệt khoản thanh toán. | Kiểm tra bằng `inflow mpp status` hoặc `inflow x402 status`. Phê duyệt hết hạn sau 900 giây. |
| Không có tùy chọn phù hợp | Các bộ lọc loại trừ mọi tùy chọn của người bán. | Xóa các bộ lọc. Chạy lại `inflow inspect`. |
| `TAP signing failed. The Service request was not sent.` | InFlow không ký request bằng TAP. Ví dụ, InFlow không ký các request đến URL `http://`, như `http://localhost`, và trả về `TAP_INVALID_REQUEST`. | Để kiểm thử một endpoint cục bộ, đặt `INFLOW_API_KEY` thành một key sandbox. Khi có API key, CLI không ký bằng TAP. Hoặc phục vụ endpoint qua HTTPS, ví dụ bằng một tunnel. |
| `NPM_CLI_DEPRECATED` | Terminal tìm thấy package npm đã ngừng hỗ trợ, không phải ứng dụng InFlow. | Chạy `npm uninstall -g @inflowpayai/inflow`. Sau đó, cài đặt CLI bằng trình cài đặt trực tuyến, Homebrew hoặc WinGet. |
| `'irm' is not recognized` | Bạn chạy trình cài đặt Windows bên ngoài PowerShell. | Mở PowerShell và chạy lệnh tại đó. |
| `bash: line 1: <!DOCTYPE html>` | Lượt tải về trả về một trang web, không phải script. Một trang đăng nhập của mạng hoặc một proxy có thể gây ra lỗi này. | Kiểm tra mạng của bạn. Hoặc tải package từ bản phát hành trên GitHub. |
| Agent của bạn không có công cụ InFlow | MCP server chưa được thiết lập, đang tắt hoặc không thể khởi động. | Đọc log MCP của ứng dụng. Đảm bảo rằng ứng dụng tìm thấy `inflow`. Sau đó, khởi động lại ứng dụng. Xem [Kết nối AI agent](https://ifdocdemo.lumivescence.com/vi/agents/connect-an-ai-agent.md#xác-nhận-kết-nối). |

## Nhận trợ giúp

Với các lỗi khác, đặt câu hỏi trên [Discord](https://discord.gg/Z9nmMAgaR4). Gửi kèm lệnh hoặc code, và nội dung lỗi đầy đủ.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.