Zum Inhalt springen
/
Bestellung abrufen

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
https://store.xsolla.com/api/
Mock server
https://xsolla.redocly.app/_mock/de/api/digital-distribution-hub/

Warenkorb

Operationen

Spielschlüssel

Operationen

Virtuelle Gegenstände und Währung

Operationen

Bundles

Operationen

Benutzertoken

Operationen

Benachrichtigungen

Operationen

Bestellung

Operationen

Bestellung abrufen

Anfrage

Ruft eine angegebene Bestellung ab.

Sicherheit
AuthForClient
Pfad
project_idintegererforderlich

Projekt-ID.

Beispiel: 44056
order_idstringerforderlich

Bestell-ID.

Beispiel: 656
curl -i -X GET \
  https://store.xsolla.com/api/v2/project/44056/distribution_hub/order/656 \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>'

Antworten

Erfolgreiche Bestellanfrage.

Bodyapplication/json
contentobject(Order_inline_response_200_1_content)

Bestelldetails.

content.​is_freestring

Ist true festgelegt, ist die Bestellung kostenlos.

Beispiel: "false"
content.​itemsArray of objects(Order_inline_response_200_1_content_items)

Artikelliste.

Beispiel: [{"is_free":false,"price":{"amount":"30","amount_without_discount":"30","currency":"USD"},"quantity":1,"sku":"some_sku"}]
content.​items[].​is_freestring

Ist true festgelegt, ist der Artikel kostenlos.

Beispiel: "false"
content.​items[].​priceobject(Order_inline_response_200_1_content_price_1)

Artikelpreis.

content.​items[].​price.​amountstring

Rabattierter Artikelpreis.

Beispiel: "30"
content.​items[].​price.​amount_without_discountstring

Artikelpreis.

Beispiel: "30"
content.​items[].​price.​currencystring

Standardkaufwährung. Code, bestehend aus drei Buchstaben, gemäß ISO 4217.

Beispiel: "USD"
content.​items[].​quantityinteger

Artikelmenge.

Beispiel: 1
content.​items[].​skustring

Eindeutige Artikel-ID. Die SKU darf nur lateinische alphanumerische Kleinbuchstaben, Punkte, Bindestriche und Unterstriche enthalten.

Beispiel: "some_sku"
content.​priceobject(Order_inline_response_200_1_content_price)

Bestellpreis.

content.​price.​amountstring

Rabattierter Bestellpreis.

Beispiel: "30"
content.​price.​amount_without_discountstring

Bestellpreis.

Beispiel: "30"
content.​price.​currencystring

Standardkaufwährung. Code, bestehend aus drei Buchstaben, gemäß ISO 4217.

Beispiel: "USD"
content.​virtual_priceobject(Order_inline_response_200_1_content_virtual_price)

Bestellpreis in virtueller Währung.

content.​virtual_price.​amountstring

Rabattierter Bestellpreis.

Beispiel: "100"
content.​virtual_price.​amount_without_discountstring

Bestellpreis.

Beispiel: "150"
content.​virtual_price.​currencystring

Die bei Bestellungen verwendete SKU der virtuellen Währung.

Beispiel: "test_vc"
order_idinteger

Bestell-ID.

Beispiel: 1
statusstring

Bestellstatus: new/paid/done/canceled.

Beispiel: "paid"
Antwort
application/json
{
  "content": {
    "is_free": "false",
    "items": [ … ],
    "price": { … }
  },
  "order_id": 1,
  "status": "paid"
}

Bestellung mit allen Artikeln aus dem aktuellen Warenkorb erstellen

Anfrage

Erstellt eine Bestellung mit allen Artikeln aus dem Warenkorb. Der erstellten Bestellung wird der Bestellstatus new zugewiesen.

Sicherheit
AuthForClient
Pfad
project_idintegererforderlich

Projekt-ID.

Beispiel: 44056
Bodyapplication/jsonerforderlich

Objekt mit Bestellerstellungsdaten.

currencystring(Cart-Payment_settings_currency)erforderlich

Bevorzugte Zahlungswährung. Währungscode, bestehend aus drei Buchstaben gemäß ISO 4217.

geotypenumbererforderlich

Vertriebspartner-ID aufseiten von Xsolla.

Beispiel: 13038
quantityinteger

Artikelmenge.

Beispiel: 1
curl -i -X POST \
  https://store.xsolla.com/api/v2/project/44056/distribution_hub/payment/cart \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "geotype": 13038
  }'

Antworten

Bestellung wurde erfolgreich erstellt.

Bodyapplication/json
billing_infoobject(Order_inline_response_200_billing_info)

Abrechnungsdaten.

billing_info.​direct_taxArray of objects(Order_inline_response_200_billing_info_direct_tax)
billing_info.​direct_tax[].​amountnumber
Beispiel: 150
billing_info.​direct_tax[].​namestring
Beispiel: "TAX"
billing_info.​direct_tax[].​ratenumber
Beispiel: 10
billing_info.​indirect_taxArray of objects(Order_inline_response_200_billing_info_indirect_tax)
billing_info.​indirect_tax[].​amountnumber
Beispiel: 246.75
billing_info.​indirect_tax[].​namestring
Beispiel: "VAT"
billing_info.​indirect_tax[].​ratenumber
Beispiel: 20
billing_info.​priceobject(Order_inline_response_200_billing_info_price)
billing_info.​price.​amountnumber
Beispiel: 1480.45
billing_info.​price.​currencystring= 3 characters

Kaufwährung. Code, bestehend aus drei Buchstaben, gemäß ISO 4217.

Beispiel: "USD"
order_idinteger

Bestell-ID.

Antwort
application/json
{
  "billing_info": {
    "direct_taxes": [ … ],
    "indirect_taxes": [ … ],
    "price": { … }
  },
  "order_id": 641
}

Bestellung mit allen Artikeln aus einem bestimmten Warenkorb erstellen

Anfrage

Erstellt eine Bestellung mit allen Artikeln aus dem entsprechenden Warenkorb. Der erstellten Bestellung wird der Bestellstatus new zugewiesen.

Sicherheit
AuthForClient
Pfad
project_idintegererforderlich

Projekt-ID.

Beispiel: 44056
cart_idstringerforderlich

Warenkorb-ID.

Beispiel: custom_id
Bodyapplication/jsonerforderlich

Objekt mit Bestellerstellungsdaten.

currencystring(Cart-Payment_settings_currency)erforderlich

Bevorzugte Zahlungswährung. Währungscode, bestehend aus drei Buchstaben gemäß ISO 4217.

geotypenumbererforderlich

Vertriebspartner-ID aufseiten von Xsolla.

Beispiel: 13038
quantityinteger

Artikelmenge.

Beispiel: 1
curl -i -X POST \
  https://store.xsolla.com/api/v2/project/44056/distribution_hub/payment/cart/custom_id \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "geotype": 13038
  }'

Antworten

Bestellung wurde erfolgreich erstellt.

Bodyapplication/json
billing_infoobject(Order_inline_response_200_billing_info)

Abrechnungsdaten.

billing_info.​direct_taxArray of objects(Order_inline_response_200_billing_info_direct_tax)
billing_info.​direct_tax[].​amountnumber
Beispiel: 150
billing_info.​direct_tax[].​namestring
Beispiel: "TAX"
billing_info.​direct_tax[].​ratenumber
Beispiel: 10
billing_info.​indirect_taxArray of objects(Order_inline_response_200_billing_info_indirect_tax)
billing_info.​indirect_tax[].​amountnumber
Beispiel: 246.75
billing_info.​indirect_tax[].​namestring
Beispiel: "VAT"
billing_info.​indirect_tax[].​ratenumber
Beispiel: 20
billing_info.​priceobject(Order_inline_response_200_billing_info_price)
billing_info.​price.​amountnumber
Beispiel: 1480.45
billing_info.​price.​currencystring= 3 characters

Kaufwährung. Code, bestehend aus drei Buchstaben, gemäß ISO 4217.

Beispiel: "USD"
order_idinteger

Bestell-ID.

Antwort
application/json
{
  "billing_info": {
    "direct_taxes": [ … ],
    "indirect_taxes": [ … ],
    "price": { … }
  },
  "order_id": 641
}