Docs/Schnellstart

Schnellstart

Erhalten Sie Ihre erste Zahlung in unter 5 Minuten.

Voraussetzungen

Ein Fivo-Händlerkonto (hier erstellen)
Ihre Merchant ID (in Ihrem Dashboard zu finden)
Eine Website oder App, auf der Sie Zahlungen akzeptieren möchten
1

Ihre Merchant ID abrufen

Melden Sie sich in Ihrem an und navigieren Sie zu . Kopieren Sie Ihre Merchant ID.Fivo-Dashboard an und navigieren Sie zu Integration.

Ihre Merchant ID sieht so aus:

fivo_live_969c4442-5741-4624-8305-427391683190
2

Widget zu Ihrer Seite hinzufügen

Fügen Sie das folgende Script-Tag in Ihr HTML ein. Ersetzen Sie durch Ihre tatsächliche Merchant ID.IHRE_MERCHANT_ID

index.html
<!-- Fivo Payment Widget -->
<script async src="https://checkout.fivo.finance/v1/fivo.js"></script>

<fivo-button
  merchant-id="YOUR_MERCHANT_ID"
  amount="29.99"
  currency="USDC">
</fivo-button>
i

Fester vs. variabler Betrag

Das obige Beispiel verwendet einen festen Betrag (29,99 USDC). Für variable Beträge (z. B. Spenden) entfernen Sie einfach das Attribut amount. Weitere Details finden Sie unter .amount. Widget-Integration.
!

Testnet und Mainnet sind getrennte Umgebungen

Testnet verwendet simulierte Gelder und Test-Merchant-IDs (fivo_test_). Mainnet verwendet echte Gelder und Produktions-Merchant-IDs (fivo_live_). Wir empfehlen, Ihre gesamte Integration auf dem Testnet zu validieren, bevor Sie in Produktion gehen.
3

Eine Zahlung testen

Wahlen Sie den Testpfad, der zu Ihrer Phase passt:

Pfad A: Testnet (zuerst empfohlen)

Verwenden Sie Ihre fivo_test_ Merchant ID und kostenloses Test-USDC vom Circle Faucet, um Ihre Integration Ende-zu-Ende ohne echte Gelder zu validieren.

1

Holen Sie sich kostenloses Test-USDC vom Circle Faucet unter faucet.circle.com.

2

Verwenden Sie Ihre Testnet-Merchant-ID (fivo_test_...) im Widget-Code.

3

Fuhren Sie eine Testzahlung durch. Sie funktioniert genau wie in Produktion, aber mit simulierten Token.

Pfad B: Mainnet-Test

Sobald Ihre Integration auf dem Testnet validiert ist, testen Sie eine echte Zahlung mit einem minimalen Betrag.

1

Gehen Sie zu Integration in Ihrem Dashboard und klicken Sie auf "Live ausprobieren". Es offnet einen echten Checkout, vorkonfiguriert auf 0,01 $.

2

Verbinden Sie Ihr Wallet und wahlen Sie eine Chain, auf der Sie USDC oder EURC besitzen.

3

Bestatigen Sie die Transaktion uber 0,01 $. Es werden echte Gelder ubertragen.

4

Im Dashboard anzeigen

Nach Abschluss der Zahlung sehen Sie diese auf Ihrer Seite . Sie erhalten außerdem eine E-Mail-Bestätigung.Transaktionen

Alles bereit!

Sobald die Zahlung on-chain bestätigt ist, erscheint sie auf Ihrer Seite mit der E-Mail-Adresse des Kunden. Sowohl Sie als auch der Kunde erhalten eine E-Mail mit den Transaktionsdetails. Ihre Kunden können Sie ab sofort in USDC und EURC von jeder unterstützten Blockchain bezahlen.Transaktionen

Beispiele

Fester Betrag: Produkt oder Dienstleistung

Der Kunde zahlt einen exakten Betrag. Ideal für Produkte, Abonnements oder Rechnungen.

fixed-amount.html
<script async src="https://checkout.fivo.finance/v1/fivo.js"></script>

<fivo-button
  merchant-id="YOUR_MERCHANT_ID"
  amount="29.99"
  currency="USDC">
</fivo-button>

Dies zeigt eine Schaltfläche „29,99 $ mit USDC bezahlen“ auf Ihrer Seite (oder EURC, wenn Sie currency="EURC" festlegen). Beim Klicken öffnet sich die Fivo-Zahlung, bei der der Kunde sein Wallet verbindet, sein Guthaben auf jeder Chain sieht, ein Netzwerk auswählt und die Zahlung bestätigt.

Variabler Betrag: Spende oder Trinkgeld

Der Kunde wählt den Betrag selbst. Entfernen Sie einfach das Attribut amount.

donation.html
<script async src="https://checkout.fivo.finance/v1/fivo.js"></script>

<fivo-button
  merchant-id="YOUR_MERCHANT_ID"
  currency="USDC">
</fivo-button>

Dies zeigt eine Schaltfläche „Mit USDC bezahlen“ (oder „Mit EURC bezahlen“, je nach konfigurierter Währung). Beim Klicken öffnet sich die Zahlung und der Kunde gibt den gewünschten Betrag ein, bevor er ein Netzwerk auswählt und bestätigt.

i

Währungsoptionen

Sie können currency="USDC" oder currency="EURC" verwenden. USDC ist auf allen 9 Chains verfügbar. EURC ist auf Ethereum, Avalanche und Base verfügbar. Alle Konfigurationsoptionen finden Sie unter .Widget-Integration.

Nächste Schritte