Sviluppatori · App

Costruisci un flusso di vendita USDC che gli utenti riescono davvero a completare.

Una buona app di off-ramp è per lo più noiosa gestione dello stato: raccogli la route, lascia firmare il wallet, recupera i metodi di pagamento vincolati a un'estensione, mostra un link al deposito e riconcilia gli eventi del ciclo di vita dopo la chiusura della scheda.

Apri la guida all'SDKClona uno starter
01

Percorso frontend

  1. 01Raccogli importo, piattaforma di pagamento, valuta fiat e identificativo per il pagamento.
  2. 02Mostra il confine attuale della politica del fornitore e richiede all'utente di confermare l'account, la regione e l'ammissibilità delle transazioni.
  3. 03Passa il viem WalletClient connesso a useOfframp() o createOfframp({ walletClient }).
  4. 04Mostra gli stati di avanzamento: approving, registering, depositing, confirming, delegating, restricting, resuming e done.
  5. 05Per un percorso idoneo che richiede l’estensione, intercetta EXTENSION_REGISTRATION_REQUIRED ed esegui usePeerExtensionRegistration(platform).
  6. 06Chiama deposits(address) al caricamento della pagina così un refresh non lascia bloccato un venditore con un'operazione in corso.
02

Stato che dovresti memorizzare

CampoMotivo
depositIdHandle principale per close(), link OTC e assistenza
txHashProva che l'utente ha firmato e trasmesso la transazione di deposito
platform + currencyVisualizzazione della route, assistenza e segmentazione analytics
etichetta dell'identificativoRiferimento leggibile per il pagamento; non memorizzare segreti
integratorIdAttribuzione stabile per la telemetria di prodotto e l'assistenza
03

Vincoli di UX

  • L'SDK opera sulla mainnet di Base; non c'è una sandbox pubblica. Testa con il minimo di 1 USDC.
  • Ogni deposito creato dall'SDK delega il pricing al vault Delegate. Non presentare controlli manuali del tasso per questo percorso.
  • Il fiat resta fuori dall'SDK. Acquirente e venditore si regolano direttamente all'interno dell'app di pagamento selezionata.
  • Reconcile narrow owner state with deposits(); use Peerlytics API for broader market data, deposits, intents, and analytics.

Continua a esplorare

API di PeerlyticsHub per sviluppatori

Domande frequenti

Un'app con wallet dovrebbe usare la funzione standalone o l'hook React?

Usa l'hook React quando vuoi stati integrati di caricamento, avanzamento, errore e risultato. Usa createOfframp({ walletClient }) quando la tua app ha la propria macchina a stati.

Cosa dovrei mostrare quando PayPal o Wise fallisce la registrazione?

In primo luogo mostrare il confine di politica: Wise vieta ricevute di cripto-vendita P2P e PayPal può richiedere la preapprovazione. Solo per un flusso di fornitori idonei è necessario prendere EXTENSION_REGISTRATION_REQUIRED, collegare l'estensione, uso completoPeerExtensionRegistration(), e riprovare.