Pengembang · Aplikasi

Bangun alur sell-USDC yang benar-benar bisa diselesaikan pengguna.

Aplikasi off-ramp yang baik sebagian besar adalah manajemen state yang membosankan: kumpulkan rute, biarkan wallet menandatangani, pulihkan metode pembayaran yang dikunci ekstensi, tampilkan tautan deposit, dan rekonsiliasi event siklus hidup setelah tab ditutup.

Buka panduan SDKClone starter
01

Jalur frontend

  1. 01Kumpulkan jumlah, platform pembayaran, mata uang fiat, dan identifikasi payout.
  2. 02Tampilkan batasan kebijakan penyedia saat ini dan minta pengguna mengonfirmasi kelayakan akun, wilayah, dan transaksi.
  3. 03Teruskan viem WalletClient yang terhubung ke useOfframp() atau createOfframp({ walletClient }).
  4. 04Status kemajuan permukaan: menyetujui, mendaftarkan, menyetor, mengonfirmasi, mendelegasikan, membatasi, melanjutkan, selesai.
  5. 05Untuk rute yang memenuhi syarat dan memerlukan ekstensi, tangkap EXTENSION_REGISTRATION_REQUIRED lalu jalankan usePeerExtensionRegistration(platform).
  6. 06Setoran panggilan (alamat) saat memuat halaman sehingga penyegaran tidak membuat penjual dalam penerbangan terlantar.
02

State yang harus disimpan

BidangAlasan
depositIdHandle utama untuk close(), tautan OTC, dan dukungan
txHashBukti bahwa pengguna menandatangani dan menyiarkan transaksi deposit
platform + currencyTampilan rute, dukungan, dan segmentasi analitik
label identifikasiReferensi payout yang dapat dibaca manusia; jangan simpan rahasia
integratorIdAtribusi stabil untuk telemetri produk dan dukungan
03

Batasan UX

  • SDK menargetkan mainnet Base; tidak ada sandbox publik. Uji dengan minimum 1 USDC.
  • Setiap deposit yang dibuat SDK mendelegasikan penetapan harga ke vault Delegate. Jangan tampilkan kontrol tarif manual untuk jalur ini.
  • Fiat tetap di luar SDK. Pembeli dan penjual menyelesaikan langsung di dalam aplikasi pembayaran yang dipilih.
  • Reconcile narrow owner state with deposits(); use Peerlytics API for broader market data, deposits, intents, and analytics.

Teruslah menjelajah

Peerlytics APIPusat pengembang

Pertanyaan umum

Haruskah aplikasi wallet menggunakan fungsi mandiri atau React hook?

Gunakan React hook ketika Anda menginginkan state loading, progres, error, dan hasil bawaan. Gunakan createOfframp({ walletClient }) ketika aplikasi Anda memiliki mesin state sendiri.

Apa yang harus ditampilkan ketika registrasi PayPal atau Wise gagal?

Pertama-tama tunjukkan batasan kebijakan: Wise melarang P2P tanda terima penjualan kripto dan PayPal mungkin memerlukan persetujuan awal. Hanya untuk alur penyedia yang memenuhi syarat Anda dapat menangkap EXTENSION_REGISTRATION_REQUIRED, menghubungkan ekstensi, menyelesaikan usePeerExtensionRegistration(), dan mencoba lagi.