コンテンツへスキップ
/
注文を受ける

Digital Distribution Hub (1.0.0)

概要

Digital Distribution Hubは、プッシュペイメント技術やEコマースを介して、デジタルとキャッシュベースの決済を結びつけることを目的とした、エクソラの新しいソリューションです。

この参照は、以下の2つエクソラ製品のAPIエンドポイントを組み合わせたものです：ゲーム内ストアと決済ステーション。2つのベースURLがあります：

  • 一般、カタログ、カート、及び注文グループの場合は https://store.xsolla.com/api。
  • 通知グループの場合は、https://ps.xsolla.com。

カタロググループのAPIエンドポイントは認証を必要としません。

カートと注文グループの操作を行うには、ユーザートークンを作成するを介してトークンを生成する必要があります。

注意

この参照は、将来のAPIのデザインを示すものであり、完全に機能するインターフェースではありません。現在は、カタログおよび通知グループのエンドポイントのみを試すことができます。ご意見をお聞かせいただける場合は、techdoc@xsolla.comまでご連絡ください。
OpenAPI記述をダウンロード
index.json
index.yaml
言語
サーバー
Mock server
https://xsolla.redocly.app/_mock/ja/api/digital-distribution-hub/
https://store.xsolla.com/api/

カート

操作

ゲームキー

操作

仮想アイテム & 通貨

操作

バンドル

操作

ユーザートークン

操作

通知

操作

注文

操作

注文を受ける

リクエスト

指定された注文を取得します。

セキュリティ
AuthForClient
パス
project_idinteger必須

プロジェクトID。

例: 44056
order_idstring必須

注文ID。

例: 656
curl -i -X GET \
  https://xsolla.redocly.app/_mock/ja/api/digital-distribution-hub/v2/project/44056/distribution_hub/order/656 \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>'

レスポンス

注文リクエストが成功しました。

ボディapplication/json
contentobject(Order_inline_response_200_1_content)

注文内容。

order_idinteger

注文ID。

例: 1
statusstring

注文状況：new/paid/done/canceled。

例: "paid"
レスポンス
application/json
{
  "content": {
    "is_free": "false",
    "items": [ … ],
    "price": { … }
  },
  "order_id": 1,
  "status": "paid"
}

現在のカートからすべてのアイテムを注文する

リクエスト

カートからすべてのアイテムを含む注文を作成します。作成された注文は、newの注文ステータスになります。

セキュリティ
AuthForClient
パス
project_idinteger必須

プロジェクトID。

例: 44056
ボディapplication/json必須

注文作成データを持つオブジェクト。

currencystring(Cart-Payment_settings_currency)必須

標準の決済通貨。ISO 42173文字通貨コード。

geotypenumber必須

エクソラ側の配信者パートナーID。

例: 13038
quantityinteger

アイテム数量。

例: 1
curl -i -X POST \
  https://xsolla.redocly.app/_mock/ja/api/digital-distribution-hub/v2/project/44056/distribution_hub/payment/cart \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "geotype": 13038
  }'

レスポンス

注文が正常に作成されました。

ボディapplication/json
billing_infoobject(Order_inline_response_200_billing_info)

課金情報。

order_idinteger

注文ID。

レスポンス
application/json
{
  "billing_info": {
    "direct_taxes": [ … ],
    "indirect_taxes": [ … ],
    "price": { … }
  },
  "order_id": 641
}

特定のカートからすべてのアイテムを注文する

リクエスト

特定のカートからすべてのアイテムを含む注文を作成します。作成された注文は、new注文ステータスを取得します。

セキュリティ
AuthForClient
パス
project_idinteger必須

プロジェクトID。

例: 44056
cart_idstring必須

カートID。

例: custom_id
ボディapplication/json必須

注文作成データを持つオブジェクト。

currencystring(Cart-Payment_settings_currency)必須

標準の決済通貨。ISO 42173文字通貨コード。

geotypenumber必須

エクソラ側の配信者パートナーID。

例: 13038
quantityinteger

アイテム数量。

例: 1
curl -i -X POST \
  https://xsolla.redocly.app/_mock/ja/api/digital-distribution-hub/v2/project/44056/distribution_hub/payment/cart/custom_id \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "geotype": 13038
  }'

レスポンス

注文が正常に作成されました。

ボディapplication/json
billing_infoobject(Order_inline_response_200_billing_info)

課金情報。

order_idinteger

注文ID。

レスポンス
application/json
{
  "billing_info": {
    "direct_taxes": [ … ],
    "indirect_taxes": [ … ],
    "price": { … }
  },
  "order_id": 641
}