コンテンツへスキップ

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/

カート

操作

ゲームキー

操作

仮想アイテム & 通貨

操作

バンドル

操作

ユーザートークン

操作

通知

操作

通知をキャンセルする

リクエスト

次の場合、支払いのキャンセルに関する通知を送信します：

  • 支払いが完了しなかった場合
  • 支払いが払い戻された場合
ボディapplication/json
payment_idinteger必須
curl -i -X POST \
  https://xsolla.redocly.app/_mock/ja/api/digital-distribution-hub/push-payments/cancel \
  -H 'Content-Type: application/json' \
  -d '{
    "payment_id": 784998479
  }'

レスポンス

OK。

支払い通知

リクエスト

ユーザーへの請求が成功した後に、この通知を送信します。

ボディapplication/json
paymentobject必須
payment.​amountnumber必須

決済金額。

payment.​currencystring

注文の通貨。仮想通貨はSKU、現実の通貨は3文字の ISO 4217コードを使用します。

payment.​geotype_idinteger必須

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

payment.​project_transaction_idstring

ゲーム開発者側のトランザクションID。

payment.​ps_transaction_idstring

配信パートナー側のトランザクションID。

project_idinteger必須

プロジェクトID。

purchaseobject必須
purchase.​order_idinteger必須

注文ID。

userobject必須
user.​emailstring

ユーザーのメールアドレス。

user.​idstring必須

ゲーム内の一意ユーザー識別子。

user.​phonestring

ユーザーの電話番号。

user.​ps_account_idstring

配信パートナー側のユーザーの決済アカウントID。

curl -i -X POST \
  https://xsolla.redocly.app/_mock/ja/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"
    }
  }'

レスポンス

OK。

ボディapplication/json
payment_idinteger
レスポンス
application/json
{
  "payment_id": 784998484
}

注文

操作