Unaffiliated

Home Documentation & Help
Steamworks Documentation
RefundPurchase/v0001
This is called by Steam after a user has submitted their refund request and it was approved by Steam Support. Implementations should remove the purchased items from the user's account. This will usually only be called once per refund request, but it is possible that this will be called more than once for the same purchase, if, for example, Steam failed to read the response the first time it made the call. Implementations should work in such a way that both calls succeed.

Called by: Steam Refunds

HTTP Method: POST

Parameters:

NameTypeRequiredDescription
appiduint3232bit App ID of the application associated with the purchase. This will be your game's App ID.
steamiduint6464bit Steam ID of the user who made the purchase.
orderiduint64Unique 64-bit ID for order. This is the same order ID that was given to us in the ISteamMicroTxn/InitTxn call.
forceboolTrue if a Steam Support agent has reviewed the transaction, saw that some of the items are marked as not refundable, but has decided to grant the refund anyways.

Returns

The output from this method should be encoded in the JSON format.

Response:
  • result
    • success - True if the method was successful. If the asset server is returning false, it should set error to a string that explains why.
    • error - A string describing why this call failed. This message will be recorded in the error log, which is available under the Economy tab in the App Admin panel on the Steamworks website.

Example Output

{ "result": { "success": true } }