Tạo tài khoản Seller

Lấy tài khoản Seller và API key cho dịch vụ của bạn. Dịch vụ của bạn nhận và quản lý các khoản thanh toán từ agent bằng tài khoản này. Bắt đầu trong sandbox.

Chọn đúng loại tài khoản

Loại tài khoản	Dùng cho	Lời gọi của người bán
Tài khoản Seller	Một dịch vụ nhận thanh toán bằng `@inflowpayai/mpp-seller` hoặc `@inflowpayai/x402-seller`	Hoạt động
Tài khoản Developer	Một agent chỉ mua, dùng API key	Thất bại với `403 SELLER_ACCOUNT_REQUIRED`

Key của tài khoản Developer xác thực được, nhưng các API cấu hình của người bán cần một tài khoản Seller.

Chọn một môi trường

Mỗi môi trường có dashboard riêng, tài khoản riêng và key riêng.

Môi trường	Dashboard	Giá trị SDK	Flag CLI
Sandbox	sandbox.inflowpay.ai	`environment: 'sandbox'`	`--sandbox`
Production	app.inflowpay.ai	`environment: 'production'`	không có. Đây là giá trị mặc định.

Một key chỉ hoạt động trong môi trường đã cấp key đó. Giá trị environment trong code của bạn phải khớp với dashboard của key.

Riêng sandbox không đảm bảo rằng một đích hoặc một blockchain dùng tiền thử nghiệm. Kiểm tra từng network và tài sản trước khi bạn thanh toán.

Đăng ký và tạo key

Đăng ký tài khoản Seller

Mở sandbox.inflowpay.ai. Đăng ký một tài khoản Seller.

Tạo API key

Trong dashboard, mở Configuration > API Keys.
Chọn Add API Key.
Nhập một tên để nhận biết key, ví dụ Report service - Sandbox. Chọn Save.
Sao chép giá trị trong Private Key. Giá trị này là INFLOW_API_KEY của bạn.

Public Key không phải là credential của API. Nếu người khác có thể thấy một key, thay key đó trong ứng dụng của bạn. Sau đó, xóa key cũ trong API Keys.

Lưu key cùng với môi trường của key

Đặt tên môi trường và key trong cùng một file .env. Hai giá trị này phải luôn thay đổi cùng nhau.

.env

INFLOW_ENVIRONMENT=sandbox
INFLOW_API_KEY=your_sandbox_key_here

Thêm .env vào .gitignore. Không bao giờ commit một key.

Kiểm tra key khi khởi động

Bắt lỗi sai loại tài khoản khi khởi động và dừng với một thông báo rõ ràng. Với x402, createInflowSellerClient gửi các lời gọi có xác thực khi bạn khởi tạo nó, nên lỗi xuất hiện khi khởi động. Với MPP, phương thức inflow tải cấu hình của nó ở chế độ nền, nên lỗi xuất hiện ở request trả phí đầu tiên.

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

startSeller là hàm khởi động của riêng bạn. Về 401 và các lỗi khác, xem Lỗi.

Giữ key an toàn

Giữ các key production trong trình quản lý secret của môi trường deploy của bạn. Không bao giờ commit các key này.
Không đưa key vào chat, file kế hoạch hoặc issue.
Xoay vòng một key nếu key đó xuất hiện bên ngoài trình quản lý secret của bạn.

Bước tiếp theo

Nhận thanh toán từ agent

Thu phí agent cho các endpoint của bạn bằng x402 và MPP.

Bắt đầu

Nhận thanh toán

Nhận biết khách hàng

Được tìm thấy

Xuất bản

Tạo tài khoản Seller

Chọn đúng loại tài khoản

Chọn một môi trường

Đăng ký và tạo key

Kiểm tra key khi khởi động

Giữ key an toàn

Bước tiếp theo

Nhận thanh toán từ agent