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
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;
}
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. |