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.
01
Con đường frontend
- 1Thu 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.
- 2Truyền viem WalletClient đã kết nối vào useOfframp() hoặc createOfframp({ walletClient }).
- 3Hiể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.
- 4Bắt EXTENSION_REGISTRATION_REQUIRED cho PayPal và Wise, rồi điều khiển usePeerExtensionRegistration(platform).
- 5Gọ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ường | Lý do |
|---|---|
| depositId | Handle chính cho close(), liên kết OTC, và hỗ trợ |
| txHash | Bằng chứng rằng người dùng đã ký và phát giao dịch ký gửi |
| platform + currency | Hiển thị tuyến, hỗ trợ, và phân khúc phân tích |
| nhãn định danh | Tham chiếu nhận tiền dễ đọc cho con người; đừng lưu trữ bí mật |
| integratorId | Ghi 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.
- Coi webhook là gợi ý vòng đời, rồi đối soát trạng thái sở hữu hẹp với deposits(); dùng API Peerlytics cho dữ liệu thị trường và phân tích rộng hơn.
Keep exploring
Common questions
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?
Bắt EXTENSION_REGISTRATION_REQUIRED, nhắc người dùng cài hoặc kết nối extension Peer, hoàn tất việc thu thập thông tin xác thực người bán qua usePeerExtensionRegistration(), rồi thử lại khoản ký gửi ban đầu.