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

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ó TTL (mặc định 30 phút) và chỉ dùng một lần.

Trang checkout do hệ thống host

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ỉ deposit + QR được sinh ra, và gửi tiền từ ví của họ.

Xác nhận thanh toán

payment-service theo dõi chain tương ứng để phát hiện các giao dịch chuyển vào khớp với địa chỉ deposit 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.

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ý, đối chiếu lại đơn hàng của mình thông qua external_ref, và thực hiện fulfillment.

Mô hình dữ liệu trong một sơ đồ

CheckoutSession  ←  1:1  →  Order  ←  1:N  →  PaymentIntent
   (có TTL)               (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 / chọn chain.

Chúng tôi xử lý gì so với bạn xử lý gì

InfraIO Pay xử lýBạn xử lý
UI checkout do hệ thống host (địa chỉ deposit, 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 chainWebhook receiver + xác thực chữ ký
Checkout đa tài sản (USDT, USDC, native ETH/BNB/POL/MNT theo từng chain)Á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.

Test mode vs live mode

Mọi tài khoản đều bắt đầu ở test mode. Khóa test có prefix pk_test_ / sk_test_. Khóa live (pk_live_ / sk_live_) bị gate bởi:

  1. Hoàn thành KYB
  2. Chứng thực ví treasury (bạn ký một thông điệp để chứng minh quyền kiểm soát ví đích trên mỗi chain bạn muốn nhận tiền)

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. Test mode 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.

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ừ ví người mua sang ví merchant on-chain. Chúng tôi không bao giờ giữ số dư.
  • Không phải nhà cung cấp ví. Khách hàng tự mang ví của mình; trang checkout do hệ thống host có tùy chọn WalletConnect tích hợp sẵn nhưng không lưu ký gì.
  • 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.
  • Hiện tại không phải gateway Tron hay Solana. Ưu tiên EVM. Xem Chains & tài sản để biết ma trận đang hỗ trợ.

Tiếp theo

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