Styrer en kontos pengeflader. actions viser kontrollerne Deposit, Accept, Send og Convert: Deposit, Send og Convert åbner deres Wallet-overlays, mens Accept åbner Whops værktøj til oprettelse af checkout-links for en virksomhedskonto eller oprettelse af en virksomhed for en personlig konto. deposit returnerer aktive indbetalingskanaler; convert bytter USD med guld, Bitcoin eller et aktietoken og viser FX-valutaer, når værten aktiverer fxEnabled; send flytter penge til en modtager eller opretter et offentligt indløsningslink; withdraw viser udbetalingsmetoder og opretter udbetalingen, når værten ikke allerede styrer det API; balances har to flader – listen over beholdninger og saldoblokken, der tegner værdien over et tidsvindue; cards er den kompakte liste over udstedte kort; cardsTable viser den fulde sorterbare kortoversigt; cardsChart plotter kortforbrug; whopCard viser ét kort, hvis oplysninger kan vises; activity viser bevægelser i hovedbogen; activityDetail viser en forudhentet bevægelse eller henter en efter aktivitets-ID eller korttransaktions-ID i en selvstændig skuffe. Bjælken med udestående handlinger og påmindelsen om identitetsverifikation ligger på dashboard-controlleren. Alle datadrevne flader kan bruge seerens session, når der ikke angives et token.
Denne side dokumenterer @whop/elements@1.10.0 og @whop/elements-react@1.10.0.
Siden v1.0.0.
Playground
Sæt elementerne sammen med eksempeldata. Betjen kontrollerne, tilføj og arrangér elementer, og se hændelser blive udløst live:
import { WhopElements, Wallet } from "@whop/elements-react";import { loadWhop } from "@whop/elements";function Example() { return ( <WhopElements elements={loadWhop()}> <Wallet /* options */> {/* mount elements here */} </Wallet> </WhopElements> );}
Send disse til whop.wallet.create({ … }), eller som props på <Wallet> i React.
string
Trebogstavs ISO 4217-valutakode for beløbsfelter. En ukendt kode falder tilbage til usd. Standard er "usd".
string
Valgfrit afgrænset token, der videregives til datadrevne wallet-underelementer. Uden det bruger læsninger seerens session.
boolean
Vis en beholdnings saldoside i stedet for saldodiagrammet og -listen, når der klikkes på en række. Slået fra som standard, så en vært, der router på balanceSelected, ikke bliver dækket af en ekstra skærm. Standard er false.
string
påkrævet
Konto- eller bruger-ID, hvis penge disse flader læser. Konto-ID’er har præfikset biz_; bruger-ID’er har præfikset user_ og kan kun læse seerens egen saldo.
Appearance
Visuel tilpasning af denne gruppes elementer. Tilsidesætter den globale WhopElements({ appearance }). Ændr den live med update({ appearance }).
WhopElementsLocale
Sprogindstilling for UI-teksten i denne gruppes elementer. Sæt den til en af appens indbyggede sprogindstillinger for at tilsidesætte den globale konfiguration. Enhver anden værdi falder tilbage til standardsprogindstillingen.
Hændelser
Send callbacks i create-indstillingerne eller React-props.
onIdentityVerificationRequested
En indbetaling kræver identitetsverifikation. Håndtér denne callback for at åbne dine indstillinger eller dit verifikationsflow; Wallet navigerer ikke.
object
Skjul egenskaber
string
påkrævet
onLoadingChange
Kører, når den samlede indlæsningstilstand ændres. Værdien er true, så længe et monteret element stadig indlæses.
boolean
Metoder
Kald disse på Wallet-handlet fra whop.wallet.create({ … }) eller useWallet().
update
Fletter nye handle-indstillinger ind i alle monterede elementer. I React skal du i stedet ændre namespace-props.Parametre
Partial<WalletOptions>
påkrævet
destroy
Ødelægger alle elementer og sub-controllere, som dette handle har oprettet, fjerner controller-frame’en og frigiver dens abonnementer. Du kan kalde det mere end én gang, men et ødelagt handle afviser alle andre kald – opret et nyt handle for at starte forfra. React fjerner gruppen automatisk, når provideren afmonteres.
Elementer
De elementer, denne gruppe monterer. Hvert har sin egen side:
ActionsElement
Kontoens handlingsrække fra Whops saldodashboard. Deposit, Send, Withdraw og Convert åbner Wallet-controllerens indbyggede overlays. Accept åbner Whops værktøj til oprettelse af checkout-links for en virksomhedskonto eller oprettelse af en virksomhed for en personlig konto. Hver knap udsender også sin anmodningshændelse, så den indlejrende side kan observere handlingen.
Saldi
Tre visninger af en kontos penge. Saldovisningen viser totalen, et diagram over, hvordan den har ændret sig, og en vælger til tidsintervallet. Listevisningen viser de beholdninger, der udgør totalen, værdiansat i dollars. Opdelingsvisningen deler én valuta op i tilgængelige, afventende, reserverede og negative beløb uden kontroller til pengebevægelser. Når openHoldingOnSelect er slået til, erstatter en listerække denne enheds lærred – diagrammet og listen – med den pågældende beholdnings saldoside i stedet for kun at rapportere klikket. (sub-controller, 4 elementer)
Rapporter
Saldohistorik og den økonomiske aktivitet bag den, inklusive CSV-eksporter. Kontoudtog er tilgængelige i Whop-dashboardet. (sub-controller, 2 elementer)
ActivityElement
En kontos aktivitet i hovedbogen: hver bevægelse af penge ind eller ud, nyeste først. Listen indlæser flere sider, efterhånden som seeren scroller, og rækkerne rapporterer, hvilken der blev trykket på, i stedet for at navigere, så du kan åbne din egen detaljeskærm.
ActivityDetailElement
En selvstændig detaljeskuffe for én bevægelse. Peg den på en forudhentet række med økonomisk aktivitet, et aktivitets-ID fra hovedbogen eller et korttransaktions-ID – en forudhentet række har forrang, ellers henter elementet selv posten. En korttransaktion åbner kortkvitteringen: forhandler, beløb, status, det kort, den blev trukket på, kortholderen på en virksomhedskonto, afregningsdatoen, kategori, valutaomregning og cashback.
DepositElement
Indbetaler penge på en Whop-konto. Viser et beløbsfelt og kontoens aktive indbetalingskanaler – krypto (en indbetalingsadresse pr. netværk med tilhørende QR-kode) og bankoverførsel (overførselsfelterne for hver afregningsvaluta). En virksomhedskontos kanaler opløses uden legitimation, så de virker på enhver side; en personlig (user_) konto viser kun sine kanaler for sig selv, så send accessToken for den – hvis det udelades, dækker seerens egen session på samme origin det. Kort og platformssaldo er valgfrie: send savedCards, allowNewCard eller showPlatformBalance, så indsamler elementet beløbet og valget, udsender derefter cardDepositRequested / addCardRequested / platformBalanceSelected og venter på, at du kalder showStep({ step: 'amount' }), når din egen skærm er færdig.
ConvertElement
Konverterer en kontos USD-saldo til guld, Coinbase Wrapped Bitcoin eller et aktietoken og tilbage via Whops offentlige swaps-API. En montering på tværs af origins kræver et accessToken med scopet company:balance:read plus crypto_wallet:swap eller crypto_wallet:manage.
WithdrawElement
Indsamler et udbetalingsbeløb og en gemt udbetalingsmetode, grupperer valg mellem standard- og øjeblikkelig levering med aktuelle gebyrer og estimerede ankomsttider og indsamler en ny udbetalingsmetode, når det er nødvendigt. Når værten ikke styrer flowet, viser elementet metoderne og opretter selv udbetalingen – send accessToken (eller benyt seerens session på samme origin). En vært, der allerede taler med udbetalings-API’et, kan stadig levere metoder, grænser og indlæsningsflag; en bekræftelse udsender så withdrawalRequested, så værten kan oprette udbetalingen.
SendElement
Sender penge fra en konto til en modtager – en bruger, en anden konto eller et offentligt indløsningslink, som alle kan indløse. Direkte overførsler bruger kildekontoens konfigurerede fiat- eller kryptokanal. Viser sin egen modtagersøgning, der opløses ud fra konto-ID’et uden anden legitimation end kontoens eget token. Kræver et accessToken med scopet payout:transfer_funds for direkte overførsler og payout:withdraw_funds for modtagerlister; søgning efter modtagere for en konto kræver desuden company:authorized_user:read og member:basic:read, og indløsningslinks for en konto kræver airdrop_link:manage – en vært uden et af disse scopes bør slå den tilsvarende prop fra i stedet for at efterlade en række, der vil give 403.
CardDetailsElement
Ét kort og det, der er brugt på det: selve kortet, hvad det har brugt i forhold til sin grænse, og dets seneste transaktioner. Åbner som en skuffe. Kortets forside, visningen af kortoplysninger og låsen kommer fra whopCard-elementet, der er sammensat indeni, så en vært får én flade i stedet for at samle tre. Et tryk på en transaktion eller en anmodning om den fulde liste rapporterer anmodningen – skuffen navigerer aldrig.
Kort
En kontos kortflader, monteret fra ét sted: den kompakte liste over udstedte kort, den fulde sorterbare oversigt, forbrugsdiagrammet og et enkelt kort, hvis oplysninger kan vises. Montér de flader, siden har brug for – de deler kontoen og den legitimation, denne enhed er udstedt med, så en side, der viser et diagram over en oversigt, kun skal forbinde dem én gang. (sub-controller, 5 elementer)
Assistant
Responses are generated using AI and may contain mistakes.