Предоставление товаров пользователям ввиду покупки

Digital Distribution Hub API

In-Game Store & Buy Button API

Введение

Скачать спецификацию API

АТРИБУТЫ ПОЛЬЗОВАТЕЛЯ

Admin

Персонализированный каталог

БАНДЛЫ

Admin

Каталог

КОРЗИНА И ОПЛАТА

Корзина (на стороне клиента)

Корзина (на стороне сервера)

Оплата (на стороне клиента)

Оплата (на стороне сервера)

Заказ

Бесплатные товары

ОБЩИЕ

Вебхуки

Предзаказы

Продавец

Каталог

Общие регионы

ИГРОВЫЕ КЛЮЧИ

Каталог

Владение играми

Admin

ИНВЕНТАРЬ ИГРОКА

Клиент

Управление

post

Предоставление товаров пользователям ввиду покупки

post

Изъятие товаров из инвентаря

post

Предоставление товаров пользователям

post

Настройка товаров для пользователей

Кроссплатформенный инвентарь

АКЦИИ

Общие

Купоны

Промокоды

Уникальный каталог предложений

Скидки

Бонусы

ВИРТУАЛЬНЫЕ ПРЕДМЕТЫ И ВАЛЮТА

Admin

Каталог

Виртуальная оплата

NFT-ПРЕДМЕТЫ

Admin

Каталог

Ограничения

Управление

REWARD CHAINS & VALUE POINTS

Admin

Клиент

Pay Station API

Publisher Account API

Subscriptions API

Webhooks

Предоставление товаров пользователям ввиду покупки

post/v2/project/{project_id}/inventory/purchase

Добавляет указанные товары в инвентари указанных пользователей ввиду покупки.

Внимание

Одновременно может быть обработано только 50 операций. Операции сверх данного ограничения будут игнорироваться.

SecuritybasicAuth

Request

path Parameters

project_id

required

integer

Default: 44056

ID проекта.

Request Body schema: application/json

Array

required

object

id	string Default: "d342dad2-9d59-11e9-a384-42010aa8003f" Уникальный идентификатор пользователя на платформе.

required

Array of objects non-empty

Array (non-empty)

sku required	string Default: "booster_mega_1" Идентификатор класса товара. Артикул может содержать только строчные латинские буквы, цифры, точки, тире и подчеркивания.
quantity required	number Default: 1 Количество товаров этого класса, которое необходимо предоставить.

required

object

amount required	string Default: "2.99" Сумма покупки до каких-либо вычетов.
currency required	string Default: "USD" Валюта покупки согласно ISO 4217.
external_purchase_id required	string Default: "10-534-35" Идентификатор заявки на покупку с платформы, на которой была совершена покупка.
external_purchase_date required	string Default: "2020-01-01T05:00:00+05:00" Дата покупки согласно ISO 8601.

comment

string [ 1 .. 255 ] characters

Default: "Monthly challenge rewards"

Описание операции. Пример: "Ежемесячные награды за участие в испытаниях".

object [ 1 .. 200 ] properties

Дополнительные пользовательские параметры проекта.

additional property	Array of arrays or object or string or integer or null or number or boolean
One of: arrays

platform

string

Default: "xsolla"

Платформа публикации, на которой играет пользователь.

Enum: "playstation_network" "xbox_live" "xsolla" "pc_standalone" "nintendo_shop" "google_play" "app_store_ios" "android_standalone" "ios_standalone" "android_other" "ios_other" "pc_other"

Responses

200

Успешная покупка пользователем.

422

Необрабатываемая сущность.

Request samples

application/json

[{"purchase": {"amount": "3.5",
"comment": "xsolla",
"currency": "USD",
"custom_parameters": [{"user_device_info": {"engine_version": "Unity 2020.2.0b5",
"os": "windows"
},
"user_public_id": {"nickname": "player1"
}
},
{"comment": "xsolla",
"custom_parameters": {"content_creator_rewards": [{"content_creator": {"id": "cc1"
},
"reward": {"amount": "10.00",
"currency": "USD"
}
},
{"content_creator": {"id": "cc2"
},
"reward": {"amount": "15.00",
"currency": "RUB"
}
}
]
},
"items": [{"quantity": 5,
"sku": "panda_sdk3"
},
{"quantity": 3,
"sku": "panda_sdk2"
}
],
"platform": "xsolla",
"purchase": {"amount": "3.5",
"currency": "USD",
"external_purchase_date": "2020-01-01T00:00:00+05:00",
"external_purchase_id": "1000001"
},
"user": {"id": "83857636-65b4-11e8-9ccb-42010a8a001c"
}
}
],
"external_purchase_date": "2020-01-01T00:00:00+05:00",
"external_purchase_id": "1000000",
"items": [{"quantity": 5,
"sku": "panda_sdk"
},
{"quantity": 3,
"sku": "panda_sdk2"
}
],
"platform": "xsolla",
"user": {"id": "672c91cd-65db-4b6e-ad68-6e93b21249d8"
}
}
}
]

Response samples

application/json

{"count": 2,
"operations": [{"amount": "2.99",
"comment": "Quest completed",
"currency": "USD",
"custom_parameters": {"array_param": [{"user_device_info": {"engine_version": "Unity 2020.2.0b5",
"os": "windows"
},
"user_public_id": {"nickname": "player1"
}
},
{"user_device_info": {"engine_version": "UE 4.25",
"os": "mac"
},
"user_public_id": {"nickname": "player2"
}
}
]
},
"external_purchase_date": "2020-01-01T05:00:00+05:00",
"external_purchase_id": "10-534-35",
"items": [{"quantity": 5,
"sku": "boots_1"
},
{"quantity": 3,
"sku": "crystal_pack_1"
}
],
"order_id": 123456,
"platform": "xbox_live",
"user_id": "0125760a-6810-11e9-84c0-42010aa80029"
},
{"amount": "2.99",
"comment": "Daily reward",
"currency": "USD",
"custom_parameters": null,
"external_purchase_date": "2020-01-01T05:00:00+05:00",
"external_purchase_id": "10-534-35",
"items": [{"quantity": 2,
"sku": "helmet_1"
},
{"quantity": 3,
"sku": "minigun_1"
}
],
"order_id": 123457,
"platform": "xbox_live",
"user_id": "a7d10a4e-3f68-43cc-a6b2-893d2c68fd14"
}
]
}