How a deal works
A deal starts with a purchase and ends when the seller has the money or the buyer has it back. Its usual way is short.
paid → sent → protected → settledStatuses
paid | The buyer's money is held and the seller has to send the item. Without an offer the seller can cancel at any moment, the buyer after 30 minutes, and after 12 hours the money goes back by itself. With an offer the deal waits for that offer, up to 15 days. |
|---|---|
sent | The offer is confirmed and the buyer can accept it. After 24 hours without an answer the seller gets close_offer. |
protected | The buyer accepted, and Steam can still reverse the trade, so the money waits 8 days. The buyer can open a dispute. |
settled | The hold ended and the seller has the money, minus the fee. |
cancelled | One of the two called the deal off before an offer existed. The buyer has the money back. |
failed | The trade didn't happen. The buyer has the money back. |
rolled_back | The seller reversed the trade. The buyer has the money back and the seller is banned for good. |
disputed | A person has to look, and no money moves until then. Steam reports wait in the deal. |
deadline_at is when a deal moves on by itself, and buyer_cancels_at when the buyer can call it off.
Actions
Each deal lists in actions what you can do with it now. Follow that list instead of working it out from the status: it is the same one the site shows.
send | Seller: make the trade offer on Steam, and record it. |
|---|---|
cancel | Either side: call the deal off. |
close_offer | Seller: the buyer left the offer unanswered, so cancel it on Steam and report that. |
dispute | Buyer: report a problem during the hold. |
Reasons
reason says why a deal ended up where it did, when there is a reason.
buyer_cancelled | The buyer called the deal off. |
|---|---|
seller_cancelled | The seller called the deal off. |
seller_did_not_send | 12 hours passed without an offer. |
offer_declined | The buyer declined the offer. |
offer_cancelled | The offer was cancelled on Steam. |
offer_expired | The offer ran out of time. |
offer_void | The offer is no longer valid, or the buyer countered it. |
item_gone | The item is no longer in the seller's inventory. |
trade_failed | Steam says the trade failed. |
buyer_dispute | The buyer opened a dispute. |
seller_banned | The seller reversed another trade, so their other deals wait for a person. |
dispute_refund | A person decided for the buyer. |
steam_offer_state | Steam gave an offer state Rockvel doesn't know, so a person looks. |
steam_trade_status | Steam gave a trade status Rockvel doesn't know, so a person looks. |
stuck | The deal couldn't move by itself, so a person looks. |