Wie nutzt man Bitfinex Pay für Händler? (Zahlungsintegration)

Bitfinex-Gehaltsübersicht

1. Bitfinex Pay ist eine händlerorientierte Zahlungsabwicklungslösung, die von iFinex Inc. entwickelt wurde, dem gleichen Unternehmen, das auch Bitfinex und Tether betreibt.

2. Es ermöglicht Unternehmen, Kryptowährungszahlungen direkt auf ihren Websites oder Point-of-Sale-Systemen zu akzeptieren, ohne dass Kunden über Börsenkonten verfügen müssen.

3. Der Dienst unterstützt die wichtigsten Kryptowährungen, darunter BTC, ETH, USDT und UNUS SED LEO, mit Echtzeit-Umrechnungsoptionen in Fiat-Währungen.

4. Die Integration basiert auf RESTful-APIs und einer Webhook-basierten Benachrichtigungsarchitektur für die Aktualisierung des Bestellstatus und den Abrechnungsabgleich.

5. Händler müssen die KYC-Überprüfung über das institutionelle Onboarding-Portal von Bitfinex abschließen, bevor sie auf Produktionsanmeldeinformationen zugreifen können.

Technische Integrationsschritte

1. Entwickler greifen auf das Bitfinex Pay Developer Portal zu, um eine Händleranwendung zu registrieren und API-Schlüssel für die Zahlungsinitiierung und Webhook-Signierung zu erhalten.

2. Mithilfe von HMAC-SHA256 wird serverseitig eine vorsignierte Rechnungsnutzlast mit dem geheimen Schlüssel des Händlers, dem Einbettungsbetrag, der Währung, der Rückruf-URL und dem Ablaufzeitstempel generiert.

3. Die signierte Nutzlast wird per POST-Anfrage an https://pay.bitfinex.com/api/v1/invoice gesendet und sendet eine eindeutige Rechnungs-ID und QR-Code-SVG-Daten zurück.

4. Der Händler rendert den QR-Code oder leitet den Kunden über die bereitgestellte URL zur gehosteten Checkout-Seite weiter.

5. Nach erfolgreicher On-Chain-Bestätigung sendet Bitfinex Pay einen HTTP-POST an den registrierten Webhook-Endpunkt, der ein JSON-Objekt mit Status, Transaktions-Hash und Abrechnungsdetails enthält.

Abrechnung und Versöhnung

1. Die Abrechnung erfolgt stapelweise alle 6 Stunden, wobei das Geld dem vom Händler angegebenen Bitfinex-Wallet oder dem externen Bankkonto gutgeschrieben wird, wenn die Fiat-Umrechnung aktiviert ist.

2. Zu jeder Abrechnung gehört eine kryptografisch signierte Quittung mit Angabe der ursprünglichen Rechnungs-ID, der Blockhöhe und des Nettobetrags nach Netzwerkgebühren.

3. Händler können historische Rechnungen mithilfe des Endpunkts /api/v1/invoices mit Paginierungs- und Datumsbereichsfiltern abfragen.

4. Fehlgeschlagene oder abgelaufene Rechnungen lösen automatisch Webhook-Benachrichtigungen mit Fehlercodes wie ERR_INVOICE_EXPIRED oder ERR_INSUFFICIENT_CONFIRMATIONS aus.

5. Rückerstattungen werden ausschließlich über das Händler-Dashboard oder über den Endpunkt /api/v1/refund veranlasst, wobei die ursprüngliche Rechnungs-ID und der Ursachencode erforderlich sind.

Sicherheitsprotokolle

1. Alle Webhook-Nutzlasten enthalten einen X-BFX-Signature- Header, der einen Base64-codierten HMAC des Rohkörpers unter Verwendung des gemeinsamen Geheimnisses des Händlers enthält.

2. Die IP-Zulassungsliste wird auf Kontoebene erzwungen. Nur IPv4/IPv6-Bereiche auf der Whitelist können Anfragen zur Rechnungserstellung initiieren.

3. Rückruf-URLs müssen TLS 1.2+ mit gültigen X.509-Zertifikaten verwenden, die von vertrauenswürdigen Zertifizierungsstellen ausgestellt wurden; Selbstsignierte Zertifikate werden abgelehnt.

4. Rechnungsnutzlasten verfallen innerhalb von 15 Minuten nach der Erstellung, wodurch Replay-Angriffe verhindert werden.

5. Private Schlüssel, die zur Signaturüberprüfung verwendet werden, werden niemals über das Netzwerk übertragen und müssen in Hardware-Sicherheitsmodulen (HSMs) oder gleichwertigen sicheren Enklaven gespeichert werden.

Häufig gestellte Fragen

F: Unterstützt Bitfinex Pay wiederkehrende Abrechnungs- oder Abonnementmodelle? A: Nein. Bitfinex Pay ist für die einmalige, atomare Rechnungsbegleichung konzipiert. Wiederkehrende Logik muss extern mithilfe der geplanten Rechnungserstellung implementiert werden.

F: Können Händler die automatische Fiat-Umrechnung während der Abrechnung deaktivieren? A: Ja. Händler können die Abrechnungswährung pro Rechnung oder global über das Dashboard unter „Abrechnungseinstellungen“ konfigurieren und Kryptoguthaben in nativen Wallets behalten.

F: Was passiert, wenn eine Blockchain-Transaktion bestätigt wird, die endgültige Abwicklung jedoch aufgrund unzureichender Liquidität fehlschlägt? A: Bitfinex Pay garantiert die Abwicklung nach Bestätigung. Liquiditätsengpässe werden intern von iFinex behoben; Händler erhalten unabhängig von den Marktbedingungen den vollen Wert.

F: Gibt es eine Sandbox-Umgebung zum Testen von Integrationsabläufen? A: Ja. Das Entwicklerportal bietet einen Staging-Endpunkt unter https://pay-staging.bitfinex.com mit Schein-Blockchain-Bestätigungen und gebührenfreien Testtransaktionen.