コンテンツへスキップ

Subscriptions API (2.0)

概要

  • Version: 2.0
  • Servers: https://api.xsolla.com/merchant/v2/

このAPIリファレンスでは、サブスクリプション、クーポン、およびプロモーションを管理するためのエンドポイントについて説明します。 サブスクリプションの詳細については、製品ガイドおよび用語集を参照してください。

OpenAPI記述をダウンロード
言語
サーバー
Mock server
https://xsolla.redocly.app/_mock/ja/api/subscriptions/
操作
操作
操作

リクエスト

サブスクリプション型の製品を作成します。

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

プロジェクトID。

ボディapplication/json必須
descriptionobject

ローカライズされたアイテムの説明。

group_idstring必須

製品がリンクされているグループID。

namestring必須

製品名。

curl -i -X POST \
  -u <username>:<password> \
  'https://xsolla.redocly.app/_mock/ja/api/subscriptions/projects/{project_id}/subscriptions/products' \
  -H 'Content-Type: application/json' \
  -d '{
    "description": {
      "en": "Kids TV"
    },
    "group_id": "charge",
    "name": "Channel2"
  }'

レスポンス

Created (作成済み)。

ボディapplication/json
product_idinteger
レスポンス
application/json
{ "product_id": 172003 }

リクエスト

サブスクリプション型の製品を削除します。

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

プロジェクトID。

product_idinteger必須

プランがリンクされている製品のID。

curl -i -X DELETE \
  -u <username>:<password> \
  'https://xsolla.redocly.app/_mock/ja/api/subscriptions/projects/{project_id}/subscriptions/products/{product_id}'

レスポンス

No Content (コンテンツなし) 。

リクエスト

サブスクリプション型の製品を更新します。

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

プロジェクトID。

product_idinteger必須

プランがリンクされている製品のID。

ボディapplication/json必須
descriptionobject

ローカライズされたアイテムの説明。

group_idstring必須

製品がリンクされているグループID。

namestring必須

製品名。

curl -i -X PUT \
  -u <username>:<password> \
  'https://xsolla.redocly.app/_mock/ja/api/subscriptions/projects/{project_id}/subscriptions/products/{product_id}' \
  -H 'Content-Type: application/json' \
  -d '{
    "description": {
      "en": "Description in English."
    },
    "group_id": "charge13",
    "name": "Channel23"
  }'

レスポンス

OK。

ボディapplication/json
idinteger or null

プランがリンクされている製品のID。

descriptionobject

ローカライズされたアイテムの説明。

group_idstring

製品がリンクされているグループID。

namestring

製品名。

レスポンス
application/json
{ "description": { "en": "Description in English." }, "group_id": "charge13", "id": 1713603, "name": "Channel23" }

Subscription management

操作
操作

プロモーション

操作
操作

Subscription management

操作