Zum Inhalt springen

Digital Distribution Hub (1.0.0)

Überblick

Der Digital Distribution Hub ist eine neue Lösung von Xsolla, mit der sich digitale und bargeldbasierte Zahlungen über Push-Payment-Technologie und E-Commerce verknüpfen lassen.

Diese Referenz enthält API-Endpunkte für zwei Xsolla-Produkte: Ingame-Online-Shop und Bezahlstation. Es gibt zwei grundlegende URLs:

  • https://store.xsolla.com/api für die Gruppen Allgemeines, Katalog, Warenkorb und Bestellung.
  • https://ps.xsolla.com für die Gruppe Benachrichtigungen.

API-Endpunkte in der Gruppe Katalog erfordern keine Autorisierung.

Um Aufrufe aus den Gruppen Warenkorb und Bestellung nutzen zu können, müssen Sie einen Token mithilfe der Methode Benutzertoken erstellen generieren.

Hinweis:

Diese Referenz beschreibt eine im Entwurfsstadium befindliche zukünftige API, die Schnittstelle ist noch nicht voll funktionsfähig. Derzeit können Sie nur die Endpunkte der Gruppen Katalog und Benachrichtigungen ausprobieren. Feedback können Sie gerne per E-Mail an techdoc@xsolla.com senden.
OpenAPI-Beschreibung herunterladen
index.json
index.yaml
Sprachen
Server
Mock server
https://xsolla.redocly.app/_mock/de/api/digital-distribution-hub/
https://store.xsolla.com/api/

Warenkorb

Operationen

Spielschlüssel

Operationen

Virtuelle Gegenstände und Währung

Operationen

Bundles

Operationen

Benutzertoken

Operationen

Benachrichtigungen

Operationen

Benachrichtigung abbrechen

Anfrage

Senden Sie die Benachrichtigung über die Zahlungsstornierung, wenn:

  • die Zahlung nicht abgeschlossen wurde
  • die Zahlung erstattet wurde
Bodyapplication/json
payment_idintegererforderlich
curl -i -X POST \
  https://xsolla.redocly.app/_mock/de/api/digital-distribution-hub/push-payments/cancel \
  -H 'Content-Type: application/json' \
  -d '{
    "payment_id": 784998479
  }'

Antworten

OK.

Zahlungsbenachrichtigung

Anfrage

Senden Sie diese Benachrichtigung nach erfolgreicher Abbuchung vom Konto eines Benutzers.

Bodyapplication/json
paymentobjecterforderlich
payment.​amountnumbererforderlich

Zahlungsbetrag.

payment.​currencystring

Währung der Bestellung. Bei virtuellen Währungen wird die SKU und bei echten Währungen der aus drei Buchstaben bestehende Code gemäß ISO 4217 genutzt.

payment.​geotype_idintegererforderlich

Vertriebspartner-ID aufseiten von Xsolla.

payment.​project_transaction_idstring

Transaktions-ID aufseiten des Spieleentwicklers.

payment.​ps_transaction_idstring

Transaktions-ID aufseiten des Vertriebspartners.

project_idintegererforderlich

Projekt-ID.

purchaseobjecterforderlich
purchase.​order_idintegererforderlich

Bestell-ID.

userobjecterforderlich
user.​emailstring

E-Mail-Adresse des Benutzers.

user.​idstringerforderlich

Individuelle Benutzerkennung im Spiel.

user.​phonestring

Telefonnummer des Benutzers.

user.​ps_account_idstring

Zahlungskonto-ID des Benutzers aufseiten des Vertriebspartners.

curl -i -X POST \
  https://xsolla.redocly.app/_mock/de/api/digital-distribution-hub/push-payments/pay \
  -H 'Content-Type: application/json' \
  -d '{
    "payment": {
      "amount": 10,
      "currency": "USD",
      "geotype_id": 13038,
      "ps_transaction_id": "ps_transaction_id"
    },
    "project_id": 18404,
    "purchase": {
      "order_id": 1334430
    },
    "user": {
      "id": "s.ivanov"
    }
  }'

Antworten

OK.

Bodyapplication/json
payment_idinteger
Antwort
application/json
{
  "payment_id": 784998484
}

Bestellung

Operationen