[POST] /purchase

Description

A generic purchase handler used across the entire purchase system. When invoked, the API attempts to deduct the required amount of in-game currency from the user by reading their current balance from the database.

Behavior

• 200 – Purchase Successful The user has sufficient cash and meets all requirements.

• 400 – Purchase Failed Failure reasons may include:

  • Insufficient cash

  • Insufficient level

  • Other validation failures

Request Body

Field	Type	Description
PlayerID	int	Unique identifier of the player
Deduct_Amount	int	Amount of currency to be deducted