So funktioniert die Upay-API-Integration: Ein vollständiger Leitfaden für Unternehmen

Ihr Unternehmen verschenkt bares Geld, wenn Sie keine Kryptozahlungen akzeptieren. Krypto-Zahlungs-Gateway Der Markt, dessen Wert im Jahr 2026 auf 2.39 Milliarden US-Dollar geschätzt wurde, soll bis 2030 auf 4.74 Milliarden US-Dollar anwachsen.

Das Problem ist jedoch nicht die Nachfrage, sondern die Einrichtung. Die meisten Unternehmen wissen nicht, wo sie anfangen sollen. Hier setzt die Upay-API-Integration an.

Upay bietet Unternehmen eine einfache und entwicklerfreundliche Möglichkeit, Kryptozahlungen zu akzeptieren, gebrandete Karten auszugeben und Auszahlungen weltweit zu versenden, ohne die Zahlungsinfrastruktur von Grund auf neu aufbauen zu müssen.

Wichtige Erkenntnisse

• Die Upay-API-Integration ermöglicht es Unternehmen, Kryptozahlungen zu akzeptieren, eigene Karten auszugeben und Auszahlungen zu tätigen, ohne die Zahlungsinfrastruktur von Grund auf neu aufbauen zu müssen.
• Der Integrationsprozess umfasst mehrere Schritte: Registrierung, Lesen der Dokumentation, Einrichtung der Sandbox, Generierung von API-Schlüsseln, erste Anfrage, Konfiguration der Webhooks und Livegang.
• Jede Upay-API-Anfrage erfordert eine IP-Whitelist, vier benutzerdefinierte Header und eine kryptografische Signatur, die 60 Sekunden gültig ist.
• Die Sandbox-Umgebung steht allen Partnern zur Verfügung und ermöglicht sicheres Testen vor der Live-Schaltung.
  

Lesen Sie auch: Die besten Kryptokarten mit Apple Pay- und Google Pay-Unterstützung

Was ist Upay?

Upay wurde 2023 gegründet und ist eine globale Krypto-Zahlungsplattform, die nicht nur Geld speichert, sondern auch Geldtransfers ermöglicht. Während sich viele Anbieter ausschließlich auf Wallets oder Börsen konzentrieren, vereint Upay Zahlungsinfrastruktur, Kartenausgabe, Krypto-Akzeptanz und Auszahlungsfunktionen in einem einzigen Ökosystem für Privat- und Geschäftskunden.

Das Unternehmen betreibt zwei unterschiedliche Plattformen. Sein Verbraucherangebot ist verfügbar über Upay.bestbietet Nutzern eine Krypto-Wallet und mit Kryptowährung verknüpfte Zahlungskarten zum Ausgeben digitaler Vermögenswerte weltweit. 

Auf der geschäftlichen Seite business.upay.com bietet eine Infrastruktur auf Unternehmensebene, die es Unternehmen ermöglicht, Kryptowährungszahlungen zu akzeptieren, gebrandete Visa-Karten über die White-Label-Lösung einzuführen, Wallets zu verwalten und Massenauszahlungen über eine einheitliche API zu automatisieren.

Was Upay auszeichnet, ist sein Fokus auf Zahlungen. Anstatt eigenständige Krypto-Dienstleistungen anzubieten, stellt das Unternehmen eine umfassende Finanzinfrastruktur bereit, die Unternehmen dabei hilft, die Brücke zwischen Blockchain und traditionellem Finanzwesen zu schlagen.

Durch eine einzige Integration können Unternehmen Kryptowährungen akzeptieren, Gelder umtauschen und Ausgaben tätigen. Kartes, Compliance verwalten und Zahlungen weltweit abwickeln.

Sicherheit und Compliance stehen im Mittelpunkt der Plattform. Upay ist in Dubai lizenziert und arbeitet mit dem Sicherheitspartner SlowMist, dem Abwicklungspartner StraitsX, dem KYC-Partner Sumsub und Tencent Cloud für die Infrastruktur zusammen.

Das ist ein auf Compliance ausgerichteter Stack, der für Unternehmen entwickelt wurde, die sichere, skalierbare und regulierte Zahlungslösungen für ihre globalen Geschäftstätigkeiten benötigen.

Was ist eine API und warum ist sie für Zahlungen wichtig?

Quelle: business.upay.com

Eine API (Application Programming Interface) ist eine Brücke zwischen zwei Softwaresystemen. Sie ermöglicht es Ihrer Website oder App, mit einer anderen Plattform zu kommunizieren und Informationen automatisch auszutauschen.

Stellen Sie es sich wie ein Bestellsystem im Restaurant vor: Sie sagen dem Kellner, was Sie möchten. Der Kellner geht in die Küche, wo das Essen zubereitet und serviert wird. Sie selbst bekommen die Küche nie zu Gesicht. 

An API Es funktioniert genauso. Ihre Website sendet eine Anfrage, das System von Upay verarbeitet diese und sendet eine Antwort zurück. Ihr Kunde bekommt von den Vorgängen im Hintergrund nichts mit.

Ohne eine API würde die Akzeptanz von Kryptowährungen den Betrieb einer eigenen API erfordern. Blockchain Knoten, manuelle Überwachung eingehender Transaktionen, Abwicklung von Währungsumrechnungen und Aufbau einer eigenen Sicherheitsebene.

Das entspricht monatelanger Entwicklungsarbeit. Dank der Upay-API-Integration müssen Sie sich jedoch nur einmal verbinden, und die Plattform kümmert sich um den Rest.

Lesen Sie auch: Coin Ticker: Die drei Buchstaben, die für ein ganzes Krypto-Projekt sprechen.

Was Sie mit der Upay-API-Integration tun können

Die Upay Business API umfasst mehrere Kernfunktionen und kann unter https://upay-api.readme.io/reference/api-list eingesehen werden.

Akzeptanz von Kryptozahlungen (Acquirer-API)

Ermöglichen Sie Ihrem Unternehmen, Kryptozahlungen von Kunden weltweit mit einer reibungslosen Zahlungsinfrastruktur zu akzeptieren.

Die Acquirer-API generiert für jede Transaktion eindeutige Wallet-Adressen, sodass Sie Zahlungen genau verfolgen und den Abgleich automatisieren können. 

Darüber hinaus ermöglicht es das Erstellen und Verwalten von Bestellungen, das Bearbeiten von Rückerstattungen und das Stornieren von Transaktionen bei Bedarf. Händler erhalten so die volle Kontrolle über den Zahlungszyklus und gleichzeitig wird die Akzeptanz von Kryptowährungen in großem Umfang vereinfacht.

Kartenausgabe (Karten-API)

Führen Sie gebrandete virtuelle und physische Zahlungskarten ein, ohne die Infrastruktur von Grund auf neu aufbauen zu müssen. Mit der Karten-API können Sie Karten an Kunden ausgeben und jeden Schritt des Kartenlebenszyklus verwalten – von der Aktivierung und Aufladung bis hin zur Sperrung, Entsperrung und Kündigung. 

UPay übernimmt mit seiner White-Label-Lösung die Kartenherstellung, den Versand und die Auslieferung und ermöglicht es Unternehmen so, ein vollständig gebrandetes Kartenprogramm mit minimalem operativem Aufwand anzubieten.

Krypto-Wallet-Verwaltung (Wallet-API)

Integrieren Sie sichere Krypto-Wallet-Funktionen direkt in Ihre Plattform. Die Wallet-API ermöglicht es Unternehmen, Wallet-Adressen zu generieren und zu verwalten, Einzahlungen zu überwachen, Auszahlungen abzuwickeln und digitale Assets effizient zu transferieren. 

Integrierte AML-Kontrollen helfen bei der Überprüfung eingehender Transaktionen und der Unterstützung von Compliance-Anforderungen und sind somit eine ideale Lösung für Börsen, Fintech-Plattformen und Anwendungen, die Gelder im Auftrag von Nutzern verwahren.

Auszahlungen (Outlay API)

Automatisieren Sie Krypto-Auszahlungen an Privatpersonen oder Unternehmen weltweit. Die Outlay API ermöglicht es Plattformen, schnell und effizient Gelder an externe Wallet-Adressen zu senden – sei es für Gehaltsabrechnungen, Honorare für Freelancer, Affiliate-Provisionen, Bonusprogramme oder Massenauszahlungen. 

Es wurde für Transaktionen mit hohem Volumen entwickelt und optimiert Zahlungsvorgänge bei gleichzeitiger Reduzierung der Komplexität bei der Verwaltung von Krypto-Überweisungen in großem Umfang.

Wie die Upay-API-Integration funktioniert – Schritt für Schritt

Hier erfahren Sie, wie der Upay-API-Integrationsprozess von der Anmeldung bis zu Ihrer ersten Live-Transaktion funktioniert.

Schritt 1: Registrieren und KYC-Prüfung abschließen

Quelle: business.upay.com

Zunächst müssen Sie sich direkt an deren Vertriebsteam wenden über die Upay-Website um Zugang zu ihrer skalierbaren B2B-Infrastruktur und ihren API-Tools zu beantragen.

Sobald Sie auf der Webseite sind, scrollen Sie nach unten zu „Partner werden“ und klicken Sie auf den entsprechenden Reiter. Die Seite öffnet sich mit dem oben abgebildeten Bild. Füllen Sie die erforderlichen Informationen im Abschnitt „Anfrage“ aus, wählen Sie den Reiter „API-Integration“ und klicken Sie auf „Kostenlose Demo anfordern“.

Sobald sich das Upay-Team bei Ihnen meldet, laden Sie Upay von der Website oder über den Apple Store oder Google Play Store herunter und erstellen Sie ein Geschäftskonto. 

Bevor Sie auf die API zugreifen können, müssen Sie eine Identitätsprüfung (KYC) durchführen. Dies ist Standard bei jeder regulierten Zahlungsplattform und schützt sowohl Sie als auch Ihre Kunden.

Schritt 2: Lesen Sie die Entwicklerdokumentation

Jede API wird mit einer Dokumentation geliefert, die als Bedienungsanleitung dient. Sie erklärt die verfügbaren Endpunkte, welche Daten gesendet werden müssen und welche Antworten zu erwarten sind.

Lesen Sie die Dokumentation, bevor Sie auch nur eine Zeile Code schreiben. Upay stellt die vollständige API-Dokumentation über sein Entwicklerportal unter [Link einfügen] bereit. https://upay-api-en.readme.io.

Schritt 3: Öffentlichen Schlüssel/API-Schlüssel/Geheimen Schlüssel der Plattform abrufen

Quelle: upay-api-en.readme.io

Den öffentlichen API-Schlüssel/API-Schlüssel/geheimen Schlüssel der Plattform finden Sie in Ihrem Händler-Dashboard. Ein API-Schlüssel ist eine lange Zeichenkette, die als Passwort für Ihr Konto bei der Kommunikation mit dem Upay-System dient.

• API-Schlüssel: Wird von UPay bereitgestellt und ist eine eindeutige Kennung für den Händler.
• Geheimer Schlüssel: Wird zur Datensignierung bei API-Anfragen verwendet.
• Öffentlicher Plattformschlüssel: Wird von UPay bereitgestellt und dient zur Verschlüsselung von Parametern bei API-Anfragen.
• Plattform-Privatschlüssel: Wird von UPay verwendet, um die Parameter nach dem Empfang der API-Anfrage zu entschlüsseln und so die Originaldaten zu erhalten.

Ejemplo: 

—–BEGINN ÖFFENTLICHER SCHLÜSSEL—–

MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEA2r69mrDofiNPIAKNRV5v

BeVBjEnrYPgKf8LKDK+gLhLrepuTc+gxlJurH/gYwgRwD8DL5rmdcXRZMpX+L8gx

yszzD0qFWnBoumN1RHx2kkok1vgLr/dBlJRwVPZbZT69m/B8kGWR8JboBVOWJwxn

DX6WaRDyWVa2qu1KogQq4m028gJWZlVzs0bSExQqSW5ZiUFGyJygjTa2XAKqceSe

xHov8jR66mpnv0vJy6+4YJK34t2VzyNdEqseTE3spZkSJCzzxNV7xIs63u/WTenK

J1BWar+/rA63A+/0Lt2BB/Uf/iq0OwGm4t2d0Pf1O7hylXXP65BGunWvu0QWCsNo

xQIDAQAB

—–ÖFFENTLICHER SCHLÜSSEL ENDE—–

Wichtig: Fügen Sie Ihren API-Schlüssel niemals direkt in den Frontend-Code Ihrer Website ein. Bewahren Sie ihn sicher auf Ihrem Server auf, da jeder, der ihn findet, Anfragen in Ihrem Namen stellen kann.

Schritt 4: Händler-Öffentlichen Schlüssel konfigurieren

Quelle: upay-api-en.readme.io

Händler öffentlicher SchlüsselDer Händler konfiguriert den generierten öffentlichen Schlüssel auf der Händlerplattform. Wenn eine API-Anfrage verschlüsselt ist, werden auch die Antwortdaten verschlüsselt.

UPay verschlüsselt die Antwortdaten mit dem öffentlichen Schlüssel des Händlers.

Händler-PrivatschlüsselNach Erhalt der API-Antwortdaten entschlüsselt der Händler diese mit Hilfe seines privaten Händlerschlüssels, um die ursprünglichen Antwortdaten wiederherzustellen.

Schritt 5: API für Zahlungsanfragen erstellen

Wenn ein Kunde mit Kryptowährung bezahlen möchte, sendet Ihr Backend eine Anfrage an die Upay-API. Die Anfrage teilt Upay mit: Ein Kunde möchte bezahlen. Generiere eine Zahlungsadresse.

POST /v2/payments/addresses

{ “chain”: “ETH”, “asset”: “USDT”, “label”: “order_00245”, “callback_url”: “https://yourshop.com/webhooks/crypto” }

Antwort: { “address”: “0x742d35Cc6634C0532925a3b844Bc…”, “asset”: “USDT”, “created_at”: “2026-05-18T10:30:00Z” }

So sieht diese Anfrage in einfachen Worten aus:

• Was Sie senden: Der Betrag, die Währung (z. B. USDT) und eine Callback-URL (Ihr Webhook-Endpunkt)
• Was Sie zurückbekommen: Eine eindeutige Wallet-Adresse und ein QR-Code zum Scannen für den Kunden.
  

Jede Bestellung erhält eine eigene, eindeutige Wallet-Adresse. Dadurch werden Überschneidungen zwischen Transaktionen vermieden und die Abstimmung vereinfacht.

Schritt 6: Webhooks einrichten

Ein Webhook ist eine automatische Benachrichtigung, die Upay an Ihren Server sendet, sobald eine Zahlung in der Blockchain bestätigt wurde.

Anstatt dass Ihr System ständig fragt: „Ist die Zahlung eingegangen?“, benachrichtigt Sie Upay sofort, sobald die Zahlung eingegangen ist. Stellen Sie es sich wie eine Benachrichtigung bei einem Kurierdienst vor.

Sie müssen die Tracking-Seite nicht ständig aktualisieren, sondern warten auf die SMS. Sobald der Webhook eintrifft, aktualisiert Ihr System den Bestellstatus, sendet dem Kunden eine Bestätigung und leitet den nächsten Schritt im Auftragsabwicklungsprozess ein.

Lesen Sie auch: Was bedeutet 5x in der Kryptowelt?

Schritt 7: Erstellen einer Whitelist von IP-Adressen

Quelle: upay-api-en.readme.io

Beschränken Sie den API-Zugriff, indem Sie die zulässigen IP-Adressen angeben. Wenn keine IP-Adressen konfiguriert sind, akzeptiert die API standardmäßig Anfragen von allen IP-Adressen.

Sie können mehrere IP-Adressen auf die Whitelist setzen, indem Sie diese durch Kommas trennen.

Beispiel : 127.0.0.1, 127.0.0.2

Schritt 8: Sandbox-Umgebung einrichten

Eine Sandbox ist eine Testumgebung, in der kein echtes Geld fließt. Sie bildet das Live-System exakt nach. Die Testumgebung von Upay ist verfügbar unter [Link einfügen]. https://openapi.upay-test.best und ist für alle Partner vom ersten Tag an zugänglich. 

Nutzen Sie die Sandbox, um Zahlungen zu simulieren, Webhook-Benachrichtigungen auszulösen und zu testen, wie Ihr System mit fehlgeschlagenen oder Teilzahlungen umgeht. Dieser Schritt ist sehr wichtig, überspringen Sie ihn also nicht.

Schritt 9: Live gehen

Sobald alles getestet und verifiziert ist, wechseln Sie mit Ihrem Produktions-API-Schlüssel vom Sandbox-Modus in den Live-Modus. Upay teilt die Zugangsdaten für die Produktionsumgebung nach der Onboarding-Prüfung direkt mit den autorisierten Partnern. Nun können echte Zahlungen über Ihr System abgewickelt werden.

UPay API-Umgebung 

UPay bietet separate Sandbox- und Produktionsumgebungen, sodass Entwickler Integrationen sicher testen können, bevor sie live gehen. Erstellen und validieren Sie Ihre Zahlungsabläufe in der Sandbox und wechseln Sie dann in die Produktionsumgebung, sobald Sie bereit sind, echte Transaktionen zu verarbeiten.

Arbeitsumfeld	URL	Beschreibung
Test	https://openapi.upay-test.best	Steht allen Partnern zum Erstellen und Testen ihrer Integration zur Verfügung.
STG (Staging)	momentan nicht verfügbar	N / A
Produktion	Nicht öffentlich bekannt gegeben	Die von Upay bereitgestellte Live-Modus-Umgebung

Upay-API-Sicherheit: Zugriffsbedingungen und -beschränkungen

Jede API-Anfrage an Upay muss vier Sicherheitsanforderungen erfüllen.

Sicherheitsfaktor	Was es macht	Erforderlich
IP-Whitelisting	Die IP-Adresse Ihres Servers muss bei Upay registriert sein, bevor Anfragen angenommen werden können.	richtig
Antwort-IP-Verifizierung	Ihr System akzeptiert nur Antworten von der verifizierten IP-Adresse von Upay.	richtig
Webhook-Rückrufe	Manche Transaktionen lösen eine zweite Bestätigung per Webhook aus.	falsch
60-Sekunden-Signaturfenster	Jede signierte Anfrage läuft nach 60 Sekunden ab, um Replay-Angriffe zu verhindern.	Ja

Das 60-Sekunden-Fenster ist das wichtigste. Ein Replay-Angriff liegt vor, wenn jemand eine gültige Anfrage abfängt und versucht, sie später erneut zu senden.

Das Signaturfenster verhindert dies. Stellen Sie sicher, dass die Serveruhr vor Beginn der Integration mit NTP (Network Time Protocol) synchronisiert ist.

Upay API Anfrage-/Antwort-Header

Jede Anfrage/Antwort erfordert vier benutzerdefinierte HTTP-Header. Diese Header dienen gemeinsam der Überprüfung, ob jede Anfrage echt, zeitnah und vom richtigen Konto stammt.

• X-UPA-APIKEY: Dies ist Ihr von UPay zugewiesener, individueller API-Schlüssel. Nur wer diesen Schlüssel besitzt, kann API-Anrufe tätigen.
• X-UPA-REQUESTID: Jede Anfrage erhält eine eindeutige ID, um doppelte Bearbeitungen zu vermeiden.
• X-UPA-TIMESTAMP: Der aktuelle Zeitstempel in Millisekunden
• X-UPA-SIGN: Eine kryptografische Signatur, die beweist, dass die Anfrage nicht verändert wurde.
  

Header anfordern

Feld	Datentyp	Erläuterung	Ergebnisse
X-UPA-APIKEY	Schnur	Anfrage für API-Schlüssel	White-Label-Nutzer identifizieren und differenzieren
X-UPA-REQUESTID	Schnur	Anfrage nach einem eindeutigen Code	Anfrage Idempotenz
X-UPA-TIMESTAMP	Schnur	Zeitstempel in Millisekunden	Anfragezeitraum; wird innerhalb von 60 Sekunden nicht geantwortet, erfolgt ein Timeout und die Anfrage wird nicht beantwortet. Replay-Angriffe werden verhindert.
X-UPA-SIGN	Schnur	Signature	Unterschrift zur Bestätigung der Echtheit und Richtigkeit der Angaben des Antragstellers.

Antwort-Header

Feld	Datentyp	Erläuterung
X-UPA-REQUESTID	Schnur	Um die Konsistenz der Antwort zu gewährleisten, fordern Sie einen eindeutigen Code an, der mit der Anfrage-ID identisch ist.
X-UPA-TIMESTAMP	Schnur	Antwortzeitstempel, Zeitstempel, Millisekunden

Ein praktisches Beispiel für die Integration der Upay-API

Tunde, ein in Lagos ansässiger Händler für digitale Güter, beliefert Kunden in Nigeria, Großbritannien, Kanada und den Vereinigten Arabischen Emiraten. Früher dauerten internationale Banküberweisungen oft mehrere Werktage und verursachten hohe Gebühren für die Währungsumrechnung.

Nach der Integration der Upay-API in seinen Bezahlvorgang erfolgten Zahlungen nahezu in Echtzeit. Wählt ein Kunde in Toronto „Mit Kryptowährung bezahlen“, sendet Tundes System eine Anfrage an Upay, welches eine eindeutige USDT-Zahlungsadresse und einen QR-Code generiert. 

Der Kunde führt die Zahlung über seine Wallet durch, und Upay überwacht und verifiziert die Transaktion automatisch in der Blockchain. Nach der Bestätigung benachrichtigt ein Webhook die Plattform von Tunde, wodurch die Auftragsabwicklung und Lieferung ausgelöst werden.

Der gesamte Vorgang dauert weniger als zwei Minuten, wodurch Verzögerungen im Bankwesen vermieden und unnötige Zahlungskosten reduziert werden. Laut Eigentumsdaten von Triple-AWeltweit besaßen im Jahr 2024 rund 562 Millionen Menschen Kryptowährungen, ein Anstieg um 34 % gegenüber 420 Millionen im Vorjahr. 

Dieses Wachstum ist genau der Grund, warum immer mehr Unternehmen wie Tunde's eine Krypto-Zahlungsoption anbieten, anstatt sie als Nischenfunktion zu behandeln, und UPay liefert auf globaler Ebene.

Warum Unternehmen sich für Upay entscheiden

Wenn Sie Kryptozahlungen ohne technische Komplexität integrieren möchten, bietet UPay eine praktische und skalierbare Lösung.

Die API bietet Händlern vielfältige Möglichkeiten, White-Label-Kartenbranding und mehr mit sofortiger Abrechnung und automatischer Krypto-zu-Fiat-Umrechnung. 

Gestützt auf behördliche Zulassungen in den USA, Kanada, Hongkong und den VAE bietet UPay die Sicherheit, die Einhaltung von Vorschriften und die globale Reichweite, die erforderlich sind, um moderne Kryptozahlungen zu optimieren und langfristiges Wachstum zu unterstützen.