Chuyển sang production

Chuyển tích hợp sandbox đã kiểm thử của bạn sang production. Trước tiên, làm cho thanh toán, ghi danh và listing của bạn hoạt động trong sandbox. Không dùng production cho lần kiểm thử đầu tiên. Xem Kiểm thử thanh toán. Chuyển sang production là một thay đổi cấu hình. Nếu bạn đã làm theo Bắt đầu nhanh, server của bạn đọc môi trường và key từ .env lúc khởi động. Phát hành bản build mà bạn đã kiểm thử.

Những gì thay đổi

Chỉ ba giá trị này thay đổi.

Giá trị	Sandbox	Production
`INFLOW_ENVIRONMENT`	`sandbox`	`production`
`INFLOW_API_KEY`	key từ `sandbox.inflowpay.ai`	key từ `app.inflowpay.ai`
`MPP_SECRET_KEY` (chỉ MPP)	secret của sandbox	một secret production riêng

INFLOW_ENVIRONMENT và INFLOW_API_KEY phải luôn thay đổi cùng nhau. Một key chỉ hoạt động với dashboard đã cấp key đó. Nếu bạn chỉ thay đổi một giá trị, mọi lời gọi của người bán đều thất bại.

Chuyển sang production

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

Đăng ký tại app.inflowpay.ai. Tài khoản này tách biệt với tài khoản sandbox của bạn.Tài khoản Developer không thể nhận thanh toán. Lời gọi của người bán bằng key Developer thất bại với 403 SELLER_ACCOUNT_REQUIRED.

Tạo API key production

Tạo key trong dashboard production. Lưu key trong trình quản lý secret của môi trường deploy. Không bao giờ commit key.

Đặt secret MPP cho production

Bước này chỉ áp dụng cho MPP. Tạo một secret mới.

openssl rand -base64 32

Secret phải dài ít nhất 32 byte. Secret phải giữ nguyên giữa các lần deploy, vì secret ký và ràng buộc các challenge 402 của bạn. Mỗi lần thay đổi làm mất hiệu lực mọi challenge đang chờ xử lý.

Đặt môi trường production

.env

INFLOW_ENVIRONMENT=production
INFLOW_API_KEY=your_production_key_here
MPP_SECRET_KEY=your_production_secret_here

Deploy bản build mà bạn đã kiểm thử

Không sửa server.ts. Cùng bản build đó đọc các giá trị mới lúc khởi động.

Không bao giờ đặt baseUrl. SDK xác định đúng host chỉ từ environment. Một baseUrl gửi lưu lượng production đến một host không mong muốn.

Kiểm tra endpoint production

Xác nhận challenge

Gọi endpoint production của bạn mà không kèm thanh toán. Kết quả mong đợi là 402 và header của từng giao thức.

curl -i https://api.example.com/api/widgets

Xác nhận những gì bạn công bố

inflow inspect https://api.example.com/api/widgets

Xác nhận rằng kết quả cho thấy MPP và x402.

Nhận một khoản thanh toán thật với số tiền nhỏ

Đặt giá một endpoint ở số tiền nhỏ nhất của bạn. Tự thanh toán endpoint đó bằng CLI. Khoản thanh toán này quyết toán bằng tiền thật.

inflow x402 pay https://api.example.com/api/widgets --interval 5

inflow mpp pay https://api.example.com/api/widgets --interval 5

Xác nhận quyết toán

Với khoản thanh toán bằng stablecoin, mở app.inflowpay.ai và xác nhận rằng khoản thanh toán đã vào số dư InFlow của bạn. Với khoản thanh toán bằng thẻ, xác nhận khoản thanh toán trong tài khoản Stripe mà bạn kết nối. Xác nhận rằng số tiền khớp. Về phí và rút tiền, xem Phí và rút tiền.

Sau khi chuyển sang production

Xuất bản dịch vụ của bạn lên directory. Directory không có sandbox, nên bước này cần origin production của bạn. Xem Xuất bản lên directory.
Xoay vòng key production nếu bạn từng dán key ra ngoài trình quản lý secret.
Giữ bản deploy sandbox. Kiểm thử mọi thay đổi ở đó trước khi phát hành.
Thêm endpoint webhook của bạn trong dashboard production. Xem Webhook.

Khắc phục sự cố

Triệu chứng	Nguyên nhân
Mọi lời gọi của người bán thất bại sau khi chuyển.	`INFLOW_ENVIRONMENT` và `INFLOW_API_KEY` không khớp nhau. Key production phải lấy từ `app.inflowpay.ai`.
Người mua báo challenge đã hết hạn.	`MPP_SECRET_KEY` thay đổi giữa các lần deploy.
Request đến một host không mong muốn.	Bạn đã truyền một `baseUrl`. Xóa tham số đó.

Với các lỗi khác, xem Lỗi.

Bước tiếp theo

Kiểm tra tích hợp

Kiểm thử listing, ghi danh và cả hai giao thức thanh toán trên dịch vụ production.

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

Chuyển sang production

Những gì thay đổi

Chuyển sang production

Kiểm tra endpoint production

Sau khi chuyển sang production

Khắc phục sự cố

Bước tiếp theo

Kiểm tra tích hợp