Типы данных игровой валюты

Страница содержит типы текущего публичного контракта игровой валюты. Типы пополнения баланса приведены рядом с полными примерами в разделе «Пополнение баланса игрока».

Типы игровой валюты

GameCurrencyOffer

Поле	Тип	Описание
id	ID!	Идентификатор предложения
sku	String!	Код предложения
name	String!	Локализованное название
description	String!	Локализованное описание
shortName	String!	Короткое название валюты
iconReference	String!	Ссылка на оформление
message	String!	Сообщение о выдаче
deliveryType	GameCurrencyDeliveryType!	Тип выдачи
unitsPerPurchase	Int!	Единицы в одном пакете
unitPrice	GameCurrencyMoney!	Цена одного пакета

GameCurrencyMoney

Поле	Тип	Описание
units	String!	Атомарное целое значение
code	String!	Код денежного актива
scale	Int!	Точность
decimal	String!	Готовое десятичное представление

При нулевом итоге покупка подтверждается без оплаты: paymentId равен null, paymentStatus равен NOT_REQUIRED. Заказ проходит состояния CONFIRMED, FULFILLING и FULFILLED; подтверждение ещё не означает завершённую выдачу.

GameCurrencyQuote

Поле	Тип	Описание
id	ID!	Идентификатор зафиксированного расчёта покупки
offer	GameCurrencyOffer!	Снимок предложения
quantity	Int!	Число пакетов
deliveredUnits	Int!	Итоговая выдача
unitAmount	GameCurrencyMoney!	Цена пакета
subtotal	GameCurrencyMoney!	Сумма до скидок
adjustments	[GameCurrencyPriceAdjustment!]!	Корректировки
total	GameCurrencyMoney!	Итог к оплате
hasSavings	Boolean!	Есть ли скидка
delivery	GameCurrencyDeliveryTarget!	Получатель
expiresAt	DateTime!	Срок действия

GameCurrencyPriceAdjustment

Поле	Тип	Описание
code	String!	Код корректировки
kind	GameCurrencyPriceAdjustmentKind!	DISCOUNT или SURCHARGE
source	GameCurrencyPriceAdjustmentSource!	Источник правила
amount	GameCurrencyMoney!	Размер корректировки

GameCurrencyDeliveryTarget

Поле	Тип	Описание
type	GameCurrencyDeliveryTargetType!	CHARACTER или GAME_ACCOUNT
accountName	String	Игровой аккаунт или null для гостевой доставки персонажу
characterName	String	Персонаж или null

GameCurrencyPurchase

Поле	Тип	Описание
orderId	ID!	Заказ
quoteId	ID!	Идентификатор использованного расчёта покупки
orderStatus	GameCurrencyOrderStatus!	Состояние заказа
paymentId	ID	Платёж из кошелька
paymentStatus	GameCurrencyPaymentStatus!	Состояние списания
total	GameCurrencyMoney!	Сумма заказа
createdAt	DateTime!	Время создания

StorefrontMoney

Поле	Тип	Описание
units	String!	Атомарное целое значение
decimal	String!	Готовое десятичное представление
currencyCode	String!	Код валюты
currencyScale	Int!	Точность валюты

StorefrontExternalPaymentPreparation

Поле	Тип	Описание
orderId	ID!	Заказ, ожидающий внешней оплаты
quoteId	ID!	Расчёт покупки
orderStatus	StorefrontOrderStatus!	Состояние заказа
intent	StorefrontExternalPaymentIntent!	Намерение оплаты
methods	[StorefrontExternalPaymentMethod!]!	Подходящие способы с расчётами

StorefrontExternalPaymentMethod

Поле	Тип	Описание
id	ID!	Идентификатор профиля способа
code	String!	Код способа
name	String!	Отображаемое название
iconAssetId	String	Зарегистрированная иконка или null
paymentQuote	StorefrontExternalPaymentQuote!	Сумма, комиссия и срок действия

StorefrontExternalPaymentQuote

Поле	Тип	Описание
id	ID!	Расчёт выбранного способа
paymentAmount	StorefrontMoney!	Сумма в валюте платежа
destinationAmount	StorefrontMoney!	Сумма заказа
payerFee	StorefrontMoney!	Комиссия плательщика
expiresAt	DateTime!	Срок действия

StorefrontExternalPaymentExecution

Поле	Тип	Описание
orderId	ID!	Заказ
quoteId	ID!	Расчёт покупки
orderStatus	StorefrontOrderStatus!	Состояние заказа
intent	StorefrontExternalPaymentIntent!	Состояние намерения
attempt	StorefrontExternalPaymentAttempt!	Текущая попытка
action	StorefrontExternalPaymentAction	Действие клиента или null

StorefrontExternalPaymentIntent и StorefrontExternalPaymentAttempt содержат id, типизированное состояние и expiresAt. StorefrontExternalPaymentAction содержит kind, expiresAt и ровно одно подходящее представление: redirect, formPost, qrCode, deepLink или wait.

Перечисления игровой валюты

Enum	Значения
GameCurrencyDeliveryType	CHARACTER_ITEM, ACCOUNT_POINTS
GameCurrencyDeliveryTargetType	CHARACTER, GAME_ACCOUNT
GameCurrencyPriceAdjustmentKind	DISCOUNT, SURCHARGE
GameCurrencyPriceAdjustmentSource	CATALOG_SALE, REFERRAL, VIP, CAMPAIGN
GameCurrencyOrderStatus	CONFIRMED, PENDING_PAYMENT, PAID, FULFILLING, FULFILLED, CANCELLED
GameCurrencyPaymentStatus	NOT_REQUIRED, DEBIT_PENDING, PAID, REVERSAL_PENDING, REVERSED, REQUIRES_REVIEW
StorefrontOrderStatus	CONFIRMED, PENDING_PAYMENT, PAID, FULFILLING, FULFILLED, CANCELLED
StorefrontExternalPaymentIntentStatus	OPEN, PROCESSING, SETTLED, CANCELLED, EXPIRED
StorefrontExternalPaymentAttemptStatus	CREATED, REQUIRES_CUSTOMER_ACTION, PENDING_PROVIDER, AUTHORIZED, CAPTURED, DECLINED, CANCELLED, EXPIRED, REVIEW_REQUIRED
StorefrontExternalPaymentActionKind	REDIRECT, FORM_POST, QR_CODE, DEEP_LINK, WAIT

PrepareGameCurrencyPurchaseInput

Поле	Тип	Обязательное	Описание
requestId	ID!	да	UUIDv7 подготовки
offerId	ID!	да	Предложение
quantity	Int!	да	От 1 до 1 000 000
accountName	String!	да	Принадлежащий игроку аккаунт
characterName	String	нет	Обязателен для выдачи персонажу

PurchaseGameCurrencyInput

Поле	Тип	Обязательное	Описание
orderRequestId	ID!	да	UUIDv7 создания заказа
paymentRequestId	ID!	да	UUIDv7 списания
quoteId	ID!	да	Идентификатор действующего расчёта покупки

PrepareGuestGameCurrencyPurchaseInput

Поле	Тип	Обязательное	Описание
gameServerId	Int!	да	Выбранный игровой сервер
requestId	ID!	да	UUIDv7 расчёта
offerId	ID!	да	Гостевое предложение CHARACTER_ITEM
quantity	Int!	да	Число пакетов от 1 до 1 000 000
characterName	String!	да	Персонаж-получатель
payerEmail	String!	да	Email плательщика

PrepareGuestGameCurrencyCheckoutInput

Поле	Тип	Обязательное	Описание
gameServerId	Int!	да	Игровой сервер расчёта
orderRequestId	ID!	да	UUIDv7 заказа
paymentRequestId	ID!	да	UUIDv7 подготовки оплаты
quoteId	ID!	да	Расчёт покупки
characterName	String!	да	Тот же персонаж
payerEmail	String!	да	Тот же email
payerCountry	String	нет	Двухбуквенный код страны

ExecuteGuestGameCurrencyCheckoutInput

Поле	Тип	Обязательное	Описание
gameServerId	Int!	да	Игровой сервер заказа
requestId	ID!	да	UUIDv7 запуска или повтора
orderId	ID!	да	Подготовленный заказ
quoteId	ID!	да	Расчёт покупки
characterName	String!	да	Проверенный персонаж
payerEmail	String!	да	Email плательщика
methodProfileId	ID!	да	Выбранный способ
paymentQuoteId	ID!	да	Действующий расчёт способа