Skip to Content
Bắt đầuGiới thiệu
View as Markdown

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), 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.

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ậpNạp tiền cho ví testnet từ faucet

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 [email protected].

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 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 để biết ma trận đang hỗ trợ.

Tiếp theo

Chào mừngBắt đầu nhanh