Nhà phát triển · Ứng dụng

Xây dựng một luồng bán-USDC mà người dùng thực sự có thể hoàn tất.

Một ứng dụng off-ramp tốt phần lớn là việc quản lý trạng thái nhàm chán: thu thập tuyến, để ví ký, khôi phục các phương thức thanh toán bị kiểm soát bằng extension, hiển thị một liên kết ký gửi, và đối soát các sự kiện vòng đời sau khi tab đóng.

Mở hướng dẫn SDKClone một starter
01

Con đường frontend

  1. 01Thu thập số tiền, nền tảng thanh toán, loại tiền pháp định, và định danh nhận tiền.
  2. 02Hiển thị ranh giới chính sách hiện tại của nhà cung cấp và yêu cầu người dùng xác nhận tính đủ điều kiện của tài khoản, khu vực và giao dịch.
  3. 03Truyền viem WalletClient đã kết nối vào useOfframp() hoặc createOfframp({ walletClient }).
  4. 04Hiển thị các trạng thái tiến trình: đang phê duyệt, đang đăng ký, đang ký gửi, đang xác nhận, đang ủy thác, đang giới hạn, đang tiếp tục, hoàn tất.
  5. 05Đối với tuyến đường có cổng mở rộng đủ điều kiện, hãy bắt EXTENSION_REGISTRIC_REQUIRED và thúc đẩy usePeerExtensionRegistration(platform).
  6. 06Gọi deposits(address) khi tải trang để việc làm mới không bỏ rơi một người bán đang trong tiến trình.
02

Trạng thái bạn nên lưu

TrườngLý do
depositIdHandle chính cho close(), liên kết OTC, và hỗ trợ
txHashBằng chứng rằng người dùng đã ký và phát giao dịch ký gửi
platform + currencyHiển thị tuyến, hỗ trợ, và phân khúc phân tích
nhãn định danhTham chiếu nhận tiền dễ đọc cho con người; đừng lưu trữ bí mật
integratorIdGhi nhận đóng góp ổn định cho đo lường sản phẩm và hỗ trợ
03

Các ràng buộc trải nghiệm

  • SDK nhắm tới Base mainnet; không có sandbox công khai. Hãy kiểm thử với mức tối thiểu 1 USDC.
  • Mọi khoản ký gửi do SDK tạo đều ủy thác việc định giá cho kho Delegate. Đừng hiển thị các điều khiển tỷ giá thủ công cho con đường này.
  • Tiền pháp định nằm ngoài SDK. Người mua và người bán thanh toán trực tiếp bên trong ứng dụng thanh toán đã chọn.
  • Reconcile narrow owner state with deposits(); use Peerlytics API for broader market data, deposits, intents, and analytics.

Tiếp tục khám phá

API PeerlyticsTrung tâm nhà phát triển

Câu hỏi thường gặp

Một ứng dụng ví nên dùng hàm độc lập hay React hook?

Dùng React hook khi bạn muốn có sẵn trạng thái loading, tiến trình, lỗi và kết quả. Dùng createOfframp({ walletClient }) khi ứng dụng của bạn có máy trạng thái riêng.

Tôi nên hiển thị gì khi PayPal hoặc Wise đăng ký thất bại?

Trước tiên, hãy hiển thị ranh giới chính sách: Wise cấm biên lai bán tiền điện tử P2P và PayPal có thể yêu cầu phê duyệt trước. Chỉ đối với luồng nhà cung cấp đủ điều kiện, bạn mới nên nắm bắt EXTENSION_REGISTATION_REQUIRED, kết nối tiện ích mở rộng, hoàn tất usePeerExtensionRegistration() và thử lại.