API-Integration
VerfügbarAPI-Integration
Du planst, eSIMs in deiner eigenen App oder in deinem Buchungsprozess zu verkaufen? Sag uns, was du brauchst.
Die API steht genehmigten Partnern nach Freischaltung durch den Vertrieb zur Verfügung. Erstellen Sie im Partner-Dashboard einen Schlüssel mit Lese- oder Bestellberechtigung. Alle Käufe werden über Ihre Prepaid-Wallet in USD bezahlt.
API-Schnellstart
Nach der Kontogenehmigung weist der Vertrieb Preise zu und schaltet den API-Zugang frei. Erstellen Sie im Partner-Dashboard einen Schlüssel. Leseschlüssel können keine Bestellungen aufgeben. Auch Ihr Konto benötigt eine Kaufberechtigung.
https://simvoro.com/api/partner/v1Verwenden Sie bei jeder Anfrage einen serverseitigen Bearer-Schlüssel. Halten Sie ihn aus Browsercode und URLs heraus. Schlüssel können im Partner-Dashboard widerrufen werden.
Authorization: Bearer YOUR_API_KEY| Methode | Endpunkt | Ergebnis |
|---|---|---|
| GET | /products?destination=japan | Ihre zugewiesenen USD-Preise und Produkt-IDs. Nach Ziel-Slug filtern und mit cursor durch die Seiten blättern. |
| GET | /balance | Wallet-Guthaben, reservierte Beträge und verfügbare USD. |
| GET | /transactions | Wallet-Transaktionen und nextCursor. |
| GET | /orders | Zusammenfassungen der Partnerbestellungen und nextCursor (50 pro Seite). |
| POST | /orders | Guthaben reservieren und eine eSIM bestellen. Erfordert einen Schlüssel mit Bestellberechtigung. |
| GET | /orders/{orderId} | Bestellstatus, zuletzt synchronisierter Datenverbrauch und Installationsdaten nach Bereitstellung. |
Bestellung erstellen
Senden Sie eine UUID als Idempotency-Key. Verwenden Sie nach Zeitüberschreitungen oder Verbindungsfehlern dieselbe UUID erneut. Senden Sie den vom Kunden bestätigten Preis und bestätigen Sie, dass das Zielgerät eSIM unterstützt und keinen SIM-Lock hat. Geänderte Live-Preise liefern 409 PRICE_CHANGED. Dies ist eine Live-API; angenommene Käufe verwenden echtes Wallet-Guthaben.
POST /api/partner/v1/orders
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
Idempotency-Key: 83c77d9f-395f-4ff0-8ed6-c461bda46559
{"productId":"PRODUCT_ID_FROM_CATALOG","expectedPrice":"2.25","deviceConfirmed":true}Eine 201-Antwort enthält orderId und esim; prüfen Sie esim.status und esim.failure. Fragen Sie die Bestellung alle 10 Sekunden ab. Geld wird zunächst reserviert und erst nach bestätigter Bereitstellung abgebucht. Eine Wiederholung kann auch eine fehlgeschlagene Bestellung zurückgeben. Bei unklarem Lieferantenergebnis bleibt der Betrag reserviert, während die ursprüngliche Bestellung abgeglichen wird. Installationsdaten sind vertraulich und erscheinen erst nach bestätigter Bereitstellung.
Beträge sind dezimale USD-Zeichenfolgen. Listen liefern items und nextCursor; fahren Sie fort, bis nextCursor null ist. Limits: 120 Anfragen pro Schlüssel und Minute sowie 10 Kaufversuche pro Nutzer und Minute. Beachten Sie Retry-After bei 429. Häufige Fehler: 401 ungültiger Schlüssel, 403 fehlende Berechtigung, 402 unzureichendes Guthaben, 404 unzugängliche Bestellung, 409 Preis- oder Idempotenzkonflikt, 503 Dienst nicht verfügbar. Prüfen Sie vor einem erneuten Kauf die ursprüngliche Bestellung.
Was deine Anfrage enthalten sollte
- Deine Plattform und wer deine Kundschaft ist
- Dein erwartetes monatliches Volumen
- Die Reiseziele, die du anbieten möchtest
- Was dein System können muss, zum Beispiel eine eSIM bestellen und deiner Kundschaft ihren QR-Code anzeigen
Partner werden
Stell einen Antrag, dann meldet sich unser Team dazu bei dir.