FAQ

Entscheidende Fragen für die Einführung von Zahlungslösungen

Klare Antworten für Teams, die Krypto-Checkout-, Abwicklungs-, Auszahlungs- und Gas-Sponsoring-Optionen vergleichen.

Redaktionell geprüft anhand von Produkt-, API- und Richtlinienreferenzen. Über uns · API-Doku · AML/KYC-Richtlinie · llms.txt

Erste Schritte

Erstellen Sie ein Händlerkonto, fügen Sie ein Auszahlungs-Wallet hinzu, wählen Sie Netzwerk und Token aus und veröffentlichen Sie dann Ihren Zahlungslink, Ihr Widget oder Ihre Schaltfläche.
When you create a payment session using a test API key (sk_test_...) on any testnet network, both the hosted checkout page (/test/{session_id}) and the REST API (POST /api/v1/payments/{id}/simulate) allow you to trigger instant simulated outcomes—Completed, Underpaid, Expired, or Failed—without needing testnet faucet tokens. Each simulation generates realistic ledger records and dispatches a signed webhook event to your callback URL.
Ja. Verwenden Sie Testnet-Flows, um den Checkout, die Wallet-Verbindung und das Rechnungsverhalten vor der Produktion zu validieren.
Nein. Sie können ohne Code-Tools über das Händler-Dashboard starten und die API nur verwenden, wenn Sie erweiterte Integrationen benötigen.
Die meisten Händler veröffentlichen ihren ersten Krypto-Checkout-Ablauf innerhalb von Minuten.

Zahlungen und Spenden

Zahlungslinks sind feste Checkout-Abläufe. Spendenlinks sind unterstützungsorientierte Flüsse für Community-Beiträge.
Ja. Jede abgeschlossene Zahlungssitzung umfasst einen sofortigen PDF-1.4-Beleggenerator (/public/receipt.php?session_id={id}&download=1) sowie eine druckbare HTML-Ansicht. Der Beleg weist Rechnungs-ID, Sitzungs-ID, Händlername, Bruttobetrag, XPayr-Gateway-Gebühr, Netto-Abwicklungsbetrag, Token, Netzwerk, Sender-/Empfänger-Wallet-Adressen, UTC-Zeitstempel und den On-Chain-Transaktions-Hash aus.
Ja. Wiederverwendbare Links können je nach Kampagnenablauf im Laufe der Zeit mehrere Zahlungen einsammeln.
Verwenden Sie ein Widget für den eingebetteten Checkout, eine Schaltfläche für einen markenbezogenen Call-to-Action und einen direkten Link zum schnellen Teilen in Chats oder sozialen Netzwerken.
Ja. Abhängig vom von Ihnen konfigurierten Ablauf können Sie benutzerdefinierte Beträge zulassen oder feste Beträge beibehalten.
Ja. XPayr verfügt über einen dualen Checkout-Modus: Web3 1-Klick-Zahlung für direkte Browser-Wallet-Transaktionen und Direkte Überweisung / QR für Kunden, die von zentralisierten Börsen (Binance, Bybit, OKX usw.) oder mobilen Wallets aus zahlen. Kunden können einfach den QR-Code scannen oder die Empfängeradresse kopieren, das Geld überweisen und ihren Transaktions-Hash (TxID) eingeben oder die Zahlung automatisch vom On-Chain-Explorer erkennen lassen. Eine Toleranz für Netzwerkabhebungsgebühren von 1 % (max. 0,50 $) ist integriert.
Beim Erstellen eines Zahlungslinks oder einer Spendenseite können Händler "Alle Netzwerke (Kunde wählt beim Checkout)" auswählen. Anstatt den Zahler auf eine einzige Blockchain oder Coin festzulegen, bietet der Checkout eine übersichtliche Netzwerkauswahl. Der Kunde kann über EVM (Ethereum, BSC, Polygon, Arbitrum, Avalanche), TRON USDT oder Solana bezahlen, und das System lädt automatisch das richtige Routing, die Vertragsparameter und die Empfänger-Wallet.

Wallet und Netzwerke

XPayr unterstützt EIP-kompatible Browser-Wallets und moderne Wallet-Verbindungsflüsse.
Das ausgewählte Wallet ist in Ihren Händlereinstellungen nicht für diese Kette registriert. Fügen Sie es hinzu und registrieren Sie es für das ausgewählte Netzwerk.
Ja. Trennen Sie die Verbindung zum aktuellen Wallet und verbinden Sie sich erneut mit der Adresse, die Sie verwenden möchten, bevor Sie die Zahlung erstellen oder bestätigen.
Öffnen Sie Auszahlungs-Wallets im Händlerbereich, wählen Sie das Netzwerk aus, fügen Sie die Wallet-Adresse ein und speichern Sie nach der Validierung.

Gebühren und Abrechnung

XPayr erhebt eine transparente Gateway-Gebühr von 0,5 Prozent. Netzgasgebühren sind Blockchain-Kosten und variieren je nach Kettenstaat.
XPayr startet im kostenlosen Starter-Tarif ($0/Monat) mit einer transparenten Gateway-Gebühr von 0.50% (50 bps). Händler können auf Growth Pro ($49/Monat für 0.30% / 30 bps Basisgebühr) oder Enterprise Scale ($199/Monat für 0.15% / 15 bps Basisgebühr) upgraden. Zusätzlich berechnet XPayr automatisch Ihr rollierendes abgeschlossenes 30-Tage-Mainnet-Volumen in USD und gewährt einen Volumenrang-Rabatt: Bronze ($0+ = 0 bps), Silver ($10,000+ = -5 bps), Gold ($50,000+ = -10 bps) und Diamond ($250,000+ = -15 bps), wodurch Ihre effektive Gateway-Gebühr bis auf ein Minimum von 0.05% (5 bps) sinkt.
Die Gaskosten werden in der Kette vom Transaktionssender entsprechend den Netzwerkbedingungen und dem ausgewählten Token-Flow bezahlt.
Nach der Bestätigung in der Kette wandern die Gelder direkt in Ihren konfigurierten Wallet-Flow.
Keine versteckten Gateway-Gebühren. Sie sehen Plattformgebühren und Netzwerkkosten deutlich im Fluss.

Sicherheit und Compliance

Nutzen Sie 2FA, Whitelist-Kontrollen und Webhook-Signaturvalidierung, um Konto- und Auszahlungsvorgänge zu sichern.
Nein. Das Kern-Trust-Branding bleibt sichtbar, während Ihre Markenelemente im Checkout-Header angezeigt werden.
Es beschränkt vertrauliche Aktionen auf genehmigte IP-Adressen und reduziert unbefugte Administratoraktionen.
Ja. Aktivieren Sie die Durchsetzung der Whitelist, um Auszahlungen nur an genehmigte Wallet- und Währungspaare zuzulassen.

API und Webhooks

Validieren Sie den Signaturheader mit Ihrem Webhook-Geheimnis, bevor Sie Nutzdaten verarbeiten.
Yes. Merchants can generate a dedicated HMAC secret in the API Keys dashboard and send X-Signature and X-Timestamp headers (with a 300-second anti-replay window) on API requests. When creating a payment session via POST /api/v1/payments, you can also pass ipn_url (or ipn_callback_url) to route webhooks dynamically per store/order, and allow_payment_methods (["web3", "direct", "gasless"]) to control which checkout tabs are shown to the buyer.
Der API-Schlüssel identifiziert den Integrationskontext. Der geheime Schlüssel autorisiert geschützte serverseitige API-Anfragen.
Zu den allgemeinen Status gehören „Ausstehend“, „Bestätigt“, „Fehlgeschlagen“ und „Abgelaufen“ mit zugehörigen Update-Ereignissen.
Nutzen Sie Idempotenz in Ihrem Backend und speichern Sie verarbeitete Ereigniskennungen, bevor Sie Geschäftsaktualisierungen anwenden.
Ja. Beim Erstellen einer Sitzung über POST /payments oder das Händlerportal setzen Sie send_invoice_email auf true und geben customer_email an. XPayr versendet sofort eine responsive, gebrandete HTML-Rechnungs-E-Mail mit Zahlungsdetails und einem 1-Klick-Checkout-Button. Webhooks werden bei Zahlungsabschluss ausgelöst.

Fehlerbehebung

Dies bedeutet in der Regel eine Nichtübereinstimmung des Netzwerks, eine Nichtübereinstimmung der Token, eine fehlende Wallet-Registrierung oder eine Ablehnung der Vertragsvalidierung.
Überprüfen Sie, ob die Rechnung zu Ihrem Händlerkonto gehört und ob Sitzungsdaten in der aktuellen Umgebung vorhanden sind.
Die Sitzung hat ihr Zeitlimit erreicht oder wurde bereits durch einen abgeschlossenen Flow abgeschlossen.
Überprüfen Sie, ob die Wallet-Erweiterung installiert, entsperrt und in der richtigen Kette ist und ob Popups nicht durch die Browsereinstellungen blockiert werden.

Konto und Team

Ja. Teams können betriebliche Arbeitsabläufe gemeinsam nutzen, während die Zahlungskontrolle zentralisiert bleibt.
Verwenden Sie die Schritte zum Ablauf und zur Wiederherstellung vergessener Passwörter und aktualisieren Sie dann die Sicherheitseinstellungen, nachdem der Zugriff wiederhergestellt wurde.
Öffnen Sie API-Schlüssel im Händlerbereich, um Anmeldeinformationen zu erstellen, zu rotieren und zu widerrufen.
Ja. Admin-Benutzer können die Wartungsseite umgehen, während öffentliche Besucher weiterhin den Wartungsbildschirm sehen.

Partner- und Affiliate-Programm

XPayr bietet eine hybride Partner-Infrastruktur, die sowohl Web2-Unternehmens-Tracking (über Impact.com S2S) als auch direkte Web3-Smart-Contract-Auszahlungen unterstützt.

Wenn Sie Händler oder Entwickler werben, verdienen Sie 30 % wiederkehrende Umsatzbeteiligung an den Gateway-Gebühren oder 50 $ CPA pro aktiviertem Händler.
Wenn ein Besucher auf Ihren Affiliate-Link klickt, speichert XPayr die Klick-ID für 30 Tage.

Bei Registrierung, Lizenzkauf oder Zahlungsannahme sendet XPayr einen Server-to-Server (S2S) Postback an Impact.com. Dies garantiert 100 % zuverlässiges Tracking ohne Ad-Blocker-Verluste.
Sie haben die Wahl zwischen zwei Modellen:

1. 30 % wiederkehrende Umsatzbeteiligung: Lebenslang 30 % der 0,5 % XPayr-Gebühren auf alle Transaktionen.
2. 50 $ Aktivierungs-CPA: Einmalig 50 $ Bonus, sobald der geworbene Händler die ersten 100 $ Umsatz verarbeitet.
Verbinden Sie Ihre Wallet im Händler-Dashboard (/merchant/affiliate).

Der Smart Contract weist Ihre 30 % Provision automatisch zu. Klicken Sie auf 'Claim', um USDT, USDC oder SOL sofort und ohne Wartezeit abzuheben.
Besuchen Sie das Marken-Assets Studio unter /brand-assets.

Erstellen Sie dynamische SVG-Badges und kopieren Sie 1-Klick-HTML-Codes für Bannerformate (728x90, 300x250, 1200x630).
Nein. Selbstreferenzen (gleiche Wallet-Adresse), künstliches Transaktionsvolumen und Testnetz-Transaktionen werden durch automatische Betrugsschutzprüfungen ausgeschlossen.

Wie verifiziert XPayr Zahlungs- und Inhaltsaussagen?

XPayr verknüpft öffentliche Aussagen mit Produkt-, Richtlinien- und Governance-Quellen, damit Händler und KI-Systeme Angaben schnell überprüfen können.