Geschenkkarten & eSIMs mit einem Aufruf ausgeben
Ein Katalog für jede Produktfamilie. Eine Bestellung wird in dem Moment bepreist, in dem Sie sie aufgeben, und nie über der von Ihnen festgelegten Obergrenze; sie ist idempotent gegenüber Ihrer Prepaid-Wallet, und Webhooks sind signiert – so sind Wiederholungen sicher und der Launch-Tag wird langweilig.
API-Schlüssel werden im Händler-Dashboard ausgestellt und verwaltet, sobald Ihr Arbeitsbereich freigegeben ist.
So läuft eine Bestellung ab
Ein kurzer Ablauf – drei Aufrufe und ein signierter Webhook – und er ist für jede Produktfamilie gleich.
Produkt finden
GET /products
Durchsuchen Sie einen einzigen Katalog mit Geschenkkarten, eSIM-Tarifen und Aufladungen nach Kategorie, Land oder Text – oder aktualisieren Sie gezielt die Produkte, die Sie verkaufen, per ID.
Bestellung aufgeben
POST /orders
Senden Sie den Artikel: Er wird in einem Aufruf bepreist und bestellt, nie über der von Ihnen festgelegten Obergrenze. Wiederholungen mit demselben Schlüssel liefern dieselbe Bestellung.
Webhook erhalten
order.fulfilled
Ein signiertes Ereignis meldet Ihnen sofort, wenn die Auslieferung abgeschlossen ist. Keine Polling-Schleifen.
Code anzeigen
POST /orders/{id}/fulfillment
Rufen Sie Codes und PINs über einen eigenen, protokollierten Endpunkt ab – nie zwischengespeichert, jede Anzeige wird gezählt.
Ihre Sprache, einfaches HTTPS
Eine klare, berechenbare REST-API – JSON rein, JSON raus, ein X-Api-Key-Header und kein SDK nötig. Finden, bestellen, anzeigen: Ihre erste Bestellung braucht drei Aufrufe.
const BASE = "https://integration.xegora.com/api/v1";const response = await fetch(`${BASE}/orders`, { method: "POST", headers: { "X-Api-Key": process.env.XEGORA_API_KEY!, "Content-Type": "application/json", "Idempotency-Key": "order-10231", }, body: JSON.stringify({ clientReference: "po-10231", item: { productId, variantId, quantity: 1, currency: "USD" }, maximumTotal: 60.0, // the price your buyer saw }),});const order = await response.json();// 409 price_above_maximum carries quotedTotal — show the new price insteadconsole.log(order.status); // "reserved" — wait for "fulfilled", then reveal- Idempotente Bestellungen
- Signierte Webhooks
- API-Schlüssel mit Scopes
- Vorab aufgeladene Wallet
Die Kernschnittstelle, durchgängig
Echte Anfrage- und Antwortformate – klicken Sie auf eine beliebige Zeile. Auszahlungen, Einzahlungsverlauf und Produktbilder runden die Schnittstelle ab; die vollständige Referenz finden Sie unter docs.xegora.com.
POST /api/v1/orders
Bestellt zulasten Ihrer Prepaid-Wallet: Senden Sie den Artikel, um ihn in einem Aufruf zu bepreisen und zu bestellen (mit optionalem maximumTotal), oder eine quoteId. Der Idempotency-Key-Header ist erforderlich – eine Wiederholung liefert dieselbe Bestellung. Scope: orders.create.
{
"id": "0198e000-1111-7abc-9def-222233334444",
"clientReference": "po-10231",
"status": "reserved",
"total": 58.50,
"currency": "USD",
"lines": [
{ "productId": "0198d72d-99d6-75a6-9f12-971050ba7a5f", "variantId": "0198d72d-a15b-7cbf-…",
"productName": "Everyday Digital Gift Card", "variantLabel": "50", "quantity": 1,
"unitPrice": 58.50, "currency": "USD", "faceValue": 50, "faceCurrency": "EUR" }
],
"createdAtUtc": "2026-09-05T12:01:02Z",
"updatedAtUtc": "2026-09-05T12:01:02Z"
}Die langweilige Infrastruktur, die Sie wirklich wollen
Alles, was eine Ausgabe-Integration im echten Betrieb bestehen lässt – Idempotenz, Signaturen, Zugangsdaten mit festgelegten Scopes und eine Wallet, die nicht überzogen werden kann.
Einheitlicher Katalog
Geschenkkarten, eSIM-Tarife und Handy-Aufladungen teilen sich ein Schema, einen Preis-Feed und einen Bestellablauf. Einmal integrieren – und jedes Produkt, das Xegora hinzufügt, steht Ihnen automatisch zur Verfügung.
Idempotente Bestellungen
Sowohl das Anlegen einer Bestellung als auch das Abrufen der gelieferten Codes akzeptieren einen Idempotency-Key-Header. Netzwerkaussetzer, Timeout, aggressive Retry-Schleife – wiederholen Sie die Anfrage so oft Sie möchten, es existiert genau eine Bestellung.
Signierte Webhooks
order.processing, order.fulfilled, order.failed, order.refunded und wallet.credited werden über HTTPS mit einer HMAC-SHA256-Signatur (X-Xegora-Signature) zugestellt, nach dem At-least-once-Prinzip wiederholt und über eine stabile X-Xegora-Event-Id dedupliziert.
Schlüssel mit minimalen Rechten
Jeder Schlüssel trägt einen expliziten Satz von Scopes – Katalog lesen, Preisangebote, Bestellen, Wallet lesen und Geldbewegungen sind jeweils getrennt – sowie eine optionale CIDR-Allowlist und ein Ablaufdatum. Ein Widerruf wirkt sofort.
Vorab aufgeladene Wallet
Bestellungen reservieren Beträge aus Ihrem Prepaid-Guthaben und buchen sie bei der Auslieferung ab; bei Fehlschlägen wird die Reservierung automatisch freigegeben. Laden Sie es On-Chain über eine dauerhafte Einzahlungsadresse auf und zahlen Sie ungenutzte Mittel nur an Ihre eigenen hinterlegten Auszahlungsdaten aus.
Ein Katalog, gebaut für die Auswahl
Suchen Sie nach Kategorie, Land oder Text, grenzen Sie auf feste oder frei wählbare Beträge ein und aktualisieren Sie die Produkte, die Sie verkaufen, per ID in einem einzigen Aufruf – mit Einlöseschritten und den weiteren Ländern der Marke bei jedem Produkt, bepreist in Ihrer Verkaufswährung.
Großhandelspreise, keine Überraschungen
Das Preisangebot ist der Preis. Alles Weitere zu Ihren kommerziellen Konditionen wird bei der Einrichtung Ihres Händler-Arbeitsbereichs vereinbart.
- Großhandelspreise in Ihrer Verkaufswährung – die Summe des Preisangebots ist genau der Betrag, mit dem Ihre Wallet belastet wird
- Keine versteckten Gebühren pro Aufruf; ein einheitliches Ratenlimit von 120 Anfragen/Minute pro Arbeitsbereich
- Der Tarif Ihres Arbeitsbereichs (Einrichtung und Konditionen) wird beim Händler-Onboarding vereinbart
- Auszahlungen ungenutzter Mittel werden transparent berechnet – Gebühr, Nettobetrag und Auszahlungsdatum vorab
Bereit für Ihre erste Bestellung?
Beantragen Sie in Ihrem Konto einen Händler-Arbeitsbereich, lassen Sie ihn freigeben und stellen Sie im Dashboard API-Schlüssel mit festgelegten Scopes aus – dann ist Ihre erste Bestellung nur drei Aufrufe entfernt. Die vollständige Referenz finden Sie unter docs.xegora.com.