How a sale settles
On the XRP Ledger a sale is a single transaction that moves the NFT and the payment together. This guide explains how that works, how a marketplace completes a sale, and what the ledger’s answer means for your money.
Both sides move together
A sale is one transaction. The NFT moves to the buyer and the payment moves to the seller together, or neither moves at all: there is no moment when one side has given and the other has not.
Everything moves by offer
Nothing on the ledger takes an NFT from its holder. An NFT moves only when an offer is accepted: a sell offer its holder made, or a buy offer its holder chooses to accept.
An offer can name the one account allowed to accept it. That is how a private sale reaches one buyer, and how a listing is kept for one marketplace to complete.
The offers guide and the selling guide explain both sides.
How a marketplace completes a sale
A marketplace completes a sale from an account that matches a sell offer with a buy offer in one transaction. The buyer’s offer has to cover the seller’s price plus the marketplace’s fee, and the ledger checks that before it lets the match through.
The XRP Ledger has no other way to pay a marketplace, so this is how a marketplace charges a fee. A First Ledger listing is addressed to First Ledger, so that only First Ledger can complete the sale.
The matching account never holds the NFT or the money. Both go directly from one side to the other, inside the matching transaction.
Under the hood
The match is one NFTokenAcceptOffer carrying both offers, with the marketplace’s cut in NFTokenBrokerFee. A listing kept for one marketplace names that marketplace’s account in Destination.
The royalty is part of the same transaction
The creator’s royalty is taken out of the sale by the ledger, in the same transaction, and paid straight to the issuer. No marketplace handles it, and none can skip it. The royalties guide explains more.
What the ledger’s answer means for your money
Every transaction gets a result from the ledger, and the kind of result settles whether anything was charged. The trade dialog says it in these words:
- It settled
It settled. The only cost was the network fee.
- It reached a ledger and failed
It reached a ledger, so its network fee — a fraction of an XRP — was burned. Nothing else moved: no NFT changed hands and no payment was made.
- It never reached a ledger
It never reached a ledger, so nothing was charged at all — not even a network fee.
- It has not been decided yet
Nothing has been charged yet — it has not been rejected, and it may still apply.
Under the hood
A result code’s first three letters are its kind: tes settled; tec reached a ledger and failed there; tef, tem and tel never reached one; ter may still apply.
The troubleshooting guide lists each result you can meet here, and what to do next.
Every transaction has a deadline
Every transaction First Ledger builds carries a deadline, a few ledgers ahead, after which it can no longer settle. So a price you saw cannot settle against a market that has since moved.
If you sign too late, the transaction never reaches a ledger and costs nothing. Start again, and the new one is built against the ledger as it is now.
Under the hood
The deadline is the transaction’s LastLedgerSequence field.
A settled sale is final
Once a sale settles, nobody can reverse it: not the buyer, not the seller, and not First Ledger. The only way back is a new trade.