Skip to content
User token/
Create user token

Digital Distribution Hub (1.0.0)

Overview

Digital Distribution Hub is a new Xsolla solution that aims to connect digital and cash based payments via push payments technology and e-commerce.

This reference combines API endpoints for two Xsolla products: In-Game Store and Pay Station. There are two base URLs:

  • https://store.xsolla.com/api for the Common, Catalog, Cart, and Order groups.
  • https://ps.xsolla.com for the Notifications group.

API endpoints in the Catalog group don’t require authorization.

To work with operations in the Cart and Order groups, you need to generate a token via Create user token.

Note

This reference shows a design of a future API and not a fully functioning interface. Currently, you can try only Catalog and Notifications groups endpoints. If you’d like to share your feedback, please email us at techdoc@xsolla.com.
Download OpenAPI description
index.json
index.yaml
Languages
Servers
Mock server
https://xsolla.redocly.app/_mock/api/digital-distribution-hub/
https://store.xsolla.com/api/

Cart

Operations

Game keys

Operations

Virtual items & currency

Operations

Bundles

Operations

User token

Operations

Create user token

Request

Verifies that a user exists in the game and creates a user token.

Security
basicAuth
Path
project_idintegerrequired

Project ID.

Example: 44056
Bodyapplication/json
userobject(email-required)required
user.​idstring or null

Unique user identifier in the game.

Example: "public_id"
user.​emailstringrequired

The user's email address where he can receive the purchased game key.

Example: "public_email@test.com"
user.​ipstring or null

The user's IP address.

Example: "127.0.0.1"
user.​phonestring or null

The user's phone number.

Example: "+66-000-000-00-00"
user.​namestring or null

The user's public name.

Example: "Public name"
user.​countrystring or null

Two-letter uppercase country code per ISO 3166-1 alpha-2.

Example: "US"
curl -i -X POST \
  -u <username>:<password> \
  https://xsolla.redocly.app/_mock/api/digital-distribution-hub/v2/project/44056/distribution_hub/user/auth \
  -H 'Content-Type: application/json' \
  -d '{
    "user": {
      "id": "public_id",
      "email": "public_email@test.com",
      "ip": "127.0.0.1",
      "phone": "+66-000-000-00-00",
      "name": "Public name",
      "country": "US"
    }
  }'

Responses

User token successfully received.

Bodyapplication/json
tokenstring

User token.

Response
application/json
{
  "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c"
}

Notifications

Operations

Order

Operations