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.
01
Percorso frontend
- 1Raccogli importo, piattaforma di pagamento, valuta fiat e identificativo per il pagamento.
- 2Passa il WalletClient di viem connesso a useOfframp() o createOfframp({ walletClient }).
- 3Mostra gli stati di avanzamento: approvazione, registrazione, deposito, conferma, delega, restrizione, ripresa, completato.
- 4Intercetta EXTENSION_REGISTRATION_REQUIRED per PayPal e Wise, poi guida usePeerExtensionRegistration(platform).
- 5Chiama deposits(address) al caricamento della pagina così un refresh non lascia bloccato un venditore con un'operazione in corso.
02
Stato che dovresti memorizzare
| Campo | Motivo |
|---|---|
| depositId | Handle principale per close(), link OTC e assistenza |
| txHash | Prova che l'utente ha firmato e trasmesso la transazione di deposito |
| platform + currency | Visualizzazione della route, assistenza e segmentazione analytics |
| etichetta dell'identificativo | Riferimento leggibile per il pagamento; non memorizzare segreti |
| integratorId | Attribuzione 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.
- Tratta i webhook come indizi sul ciclo di vita, poi riconcilia lo stato ristretto del proprietario con deposits(); usa l'API Peerlytics per dati di mercato e analytics più ampi.
Keep exploring
Common questions
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?
Intercetta EXTENSION_REGISTRATION_REQUIRED, invita l'utente a installare o connettere l'estensione Peer, completa la cattura delle credenziali del venditore tramite usePeerExtensionRegistration(), poi riprova il deposito originale.