コンテンツへスキップ
/
Topup user's multicurrenc...

Metaverse Orbs API (1.0.0)

Metaverse Orbs API

OpenAPI記述をダウンロード
index.json
index.yaml
言語
サーバー
Mock server
https://xsolla.redocly.app/_mock/ja/api/metaframe/
http://orbs.babka.com/

MultiCurrencies

操作

Get multi virtual currencies balance

リクエスト

Gets information about multi virtual currencies and shards balance.

セキュリティ
Bearer
パス
merchantIdstring必須

Merchant ID of the client

projectIdstring必須

Project ID of the project

curl -i -X GET \
  'https://xsolla.redocly.app/_mock/ja/api/metaframe/v2/merchants/{merchantId}/projects/{projectId}/multicurrency-balance' \
  -H 'Authorization: YOUR_API_KEY_HERE'

レスポンス

Values of multi virtual crrencies balances.

ボディapplication/json
itemsArray of objects(Balances)

List of multicurrency balances.

例: [{"balance":14,"image_url":"https://imgurl.com","name":"Blue Orb Point","points":{"base":240,"point":80},"shards":2,"virtual_currency_sku":"xxxxx"}]
レスポンス
application/json
{
  "items": [
    { … }
  ]
}

Topup user's multicurrency balance

リクエスト

Top up user multicurrency balance.

セキュリティ
Server
パス
merchantIdstring必須

Merchant ID of the client

projectIdstring必須

Project ID of the project

ヘッダー
X-OPERATION-IDstring(UUID)= 36 characters必須

Unique operation ID.

X-HOST-IDstring(UUID)= 36 characters必須

Unique operator ID.

ボディapplication/json
shardsinteger(int64)>= 1必須

Number of Shards to topup.

例: 22
user_idstring(UUID)non-empty必須

Xsolla Account ID.

例: "b8fa3003-2448-49fb-bbe2-7f72f420e350"
virtual_currency_skustringnon-empty必須

Multicurrency SKU

例: "sapphire_point"
curl -i -X POST \
  'https://xsolla.redocly.app/_mock/ja/api/metaframe/v2/merchants/{merchantId}/projects/{projectId}/multicurrency-balance-topup' \
  -H 'Content-Type: application/json' \
  -H 'X-HOST-ID: stringstringstringstringstringstring' \
  -H 'X-OPERATION-ID: stringstringstringstringstringstring' \
  -H 'X-SERVER-AUTHORIZATION: YOUR_API_KEY_HERE' \
  -d '{
    "shards": 22,
    "user_id": "b8fa3003-2448-49fb-bbe2-7f72f420e350",
    "virtual_currency_sku": "sapphire_point"
  }'

レスポンス

Operation successful

ボディapplication/json
balanceobject
例: {"balance":1,"shards":5}
レスポンス
application/json
{
  "balance": {
    "balance": 1,
    "shards": 5
  }
}

Retrieve info about automatic purchase

リクエスト

Retrieve information about automatic purchase.

セキュリティ
Server
パス
merchantIdstring必須

Merchant ID of the client

projectIdstring必須

Project ID of the project

userIdstring(UUID)= 36 characters必須

Unique User ID.

ヘッダー
X-HOST-IDstring(UUID)= 36 characters必須

Unique operator ID.

curl -i -X GET \
  'https://xsolla.redocly.app/_mock/ja/api/metaframe/v2/merchants/{merchantId}/projects/{projectId}/user/{userId}/auto-topup' \
  -H 'X-HOST-ID: stringstringstringstringstringstring' \
  -H 'X-SERVER-AUTHORIZATION: YOUR_API_KEY_HERE'

レスポンス

Information about automatic purchase.

ボディapplication/json
itemsArray of objects(Item)
例: [{"enabled":false,"virtual_currency_sku":"xxx-xxx-xxx"}]
レスポンス
application/json
{
  "items": [
    { … }
  ]
}

Update info about automatic purchase

リクエスト

Updates information about automatic purchase.

セキュリティ
Server
パス
merchantIdstring必須

Merchant ID of the client

projectIdstring必須

Project ID of the project

userIdstring(UUID)= 36 characters必須

Unique User ID.

ヘッダー
X-HOST-IDstring(UUID)= 36 characters必須

Unique operator ID.

ボディapplication/json
itemsArray of objects(Item)
例: [{"enabled":false,"virtual_currency_sku":"xxx-xxx-xxx"}]
curl -i -X PUT \
  'https://xsolla.redocly.app/_mock/ja/api/metaframe/v2/merchants/{merchantId}/projects/{projectId}/user/{userId}/auto-topup' \
  -H 'Content-Type: application/json' \
  -H 'X-HOST-ID: stringstringstringstringstringstring' \
  -H 'X-SERVER-AUTHORIZATION: YOUR_API_KEY_HERE' \
  -d '{
    "items": [
      {
        "enabled": false,
        "virtual_currency_sku": "xxx-xxx-xxx"
      }
    ]
  }'

レスポンス

Information about automatic purchase.

ボディapplication/json
itemsArray of objects(Item)
例: [{"enabled":false,"virtual_currency_sku":"xxx-xxx-xxx"}]
レスポンス
application/json
{
  "items": [
    { … }
  ]
}

Charge

操作

Package

操作

Manual purchase

操作