Octroyer des objets à des utilisateurs par achats

Digital Distribution Hub API

In-Game Store & Buy Button API

Présentation

Télécharger la définition d'API

ATTRIBUTS UTILISATEUR

Administrateur

Catalogue personnalisé

LOTS

Administrateur

Catalogue

PANIER ET PAIEMENT

Panier (côté client)

Panier (côté serveur)

Paiement (côté client)

Paiement (côté serveur)

Commande

Biens gratuits

COMMUNS

Webhooks

Pré-commandes

Commerçant

Catalogue

Régions communes

CLÉS DE JEU

Catalogue

Droit

Administrateur

INVENTAIRE DU JOUEUR

Client

Gestion

post

Octroyer des objets à des utilisateurs par achats

post

Révoquer des objets d'inventaire

post

Octroyer des objets à des utilisateurs

post

Définir des objets à des utilisateurs

Inventaire multiplateforme

PROMOTIONS

Communs

Coupons

Codes promo

Offres uniques du catalogue

Remises

Bonus

OBJETS ET MONNAIE VIRTUELS

Administrateur

Catalogue

Paiement virtuel

OBJETS NFT

Administrateur

Catalogue

LIMITES

Gestion

REWARD CHAINS & VALUE POINTS

Administrateur

Client

Pay Station API

Publisher Account API

Subscriptions API

Webhooks

Octroyer des objets à des utilisateurs par achats

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

Ajoute des objets spécifiques aux inventaires des utilisateurs spécifiques en fonction de leurs achats.

Attention

Seules 50 opérations peuvent être traitées à la fois. Les opérations qui dépassent cette limite seront ignorées.

SecuritybasicAuth

Request

path Parameters

project_id

required

integer

Default: 44056

ID de projet.

Request Body schema: application/json

Array

required

object

id	string Default: "d342dad2-9d59-11e9-a384-42010aa8003f" Identifiant unique de l'utilisateur sur la plateforme.

required

Array of objects non-empty

Array (non-empty)

sku required	string Default: "booster_mega_1" Identifiant de la classe de l'objet. L'UGS ne peut comprendre que des caractères alphanumériques latins minuscules, des points, des tirets et des traits bas.
quantity required	number Default: 1 Nombre d'objets de cette classe à octroyer.

required

object

amount required	string Default: "2.99" Montant de l'achat avant toute déduction.
currency required	string Default: "USD" Devise d'achat selon la norme ISO 4217.
external_purchase_id required	string Default: "10-534-35" Identifiant de facture de l'achat sur la plateforme sur laquelle l'achat a été effectué.
external_purchase_date required	string Default: "2020-01-01T05:00:00+05:00" Date d'achat selon la norme ISO 8601.

comment

string [ 1 .. 255 ] characters

Default: "Monthly challenge rewards"

Description de l'opération. Par exemple : « Récompenses mensuelles. »

object [ 1 .. 200 ] properties

Paramètres spécifiques au projet.

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

platform

string

Default: "xsolla"

Plateforme de publication sur laquelle l'utilisateur joue.

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

Achat de l'utilisateur effectué avec succès.

422

Unprocessable Entity.

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"
}
]
}