WebHook

Notification about a status change will be sent to the Withdraw Callback URL set in the project settings after each purchase status update.

The service sends POST requests in JSON format with the "Content-Type: application/json" header.

To verify request, ensure that the signature parameter matches the MD5 hash of your API Key.

WebHook signature verification

WebHook params description

ПАРАМЕТР	ОПИСАНИЕ
signature	WebHook signature
payment_id	Purchase ID in your system
transaction_id	Purchase ID in the Skinout Pay system
time	Purchase creation time in unix timestamp
skin	Object with data of the purchased skin
status	Purchase status. Possible values
amount	Purchase amount in USD * 1000
trade_id	Steam Trade Offer ID. (if the trade has been created)
time_settlement	Unix timestamp Time when trade offer cannot be reversed via Steam Trade protection The parameter will only be passed if tradeoffer was successfully sent in steam.

status possible values:

Значение	Описание
pending	Your request is being processed. The skin will be sent within 2 minutes
sent	Trade offer sent, waiting for the trade to be accepted by the user
accepted	Trade offer has been accepted by the user.
canceled	Trade offer has been canceled by the user, or the time to accept has expired.
error_invalid_token	Error. An invalid partner or token parameter was passed when creating the purchase
error_user_not_tradable	Error. User has restrictions on steam trades
error_inventory_private	Error. The user's inventory is hidden by privacy settings, sending trade offer is not possible.
error	Unknown error while sending the trade offer.
rollback_user	Trade offer canceled via Steam Trade Protection by user. Funds have been returned to the project balance.
rollback_provider	Trade offer canceled via Steam Trade Protection by provider. Funds have been returned to the project balance.

WebHook examples

{
    "signature": "e94c98250a1d30ed1e7119a12a020c2a",
    "payment_id": "1692224763052",
    "transaction_id": "8",
    "skin": {
        "name": "Nova | Plume (Factory New)",
        "price": 970
    },
    "time": "1692224763",
    "status": "sent",
    "amount": 970,
    "trade_id": "6313520489"
}

{
    "signature": "e94c98250a1d30ed1e7119a12a020c2a",
    "payment_id": "1692224976212",
    "transaction_id": "9",
    "skin": {
        "name": "Nova | Plume (Factory New)",
        "price": 970
    },
    "time": "1692224976",
    "status": "error_inventory_private",
    "amount": 970
}