Fix a Shopkeepers trade blocked by a full payment chest

A player shop needs space to receive payment as well as stock to sell. A chest full of sale items can prevent a valid trade even when the customer holds the correct currency.
Before you start
Shopkeepers player trades exchange physical items held in a linked container. A Vault balance is not the stock for these trades. Work with the shop owner and keep the container, shop record and item metadata together when investigating a failure.
Work through the check
Ask the owner to open the linked container and record which slots hold sale stock and which can accept the configured payment item.
Inspect the exact trade costs in the editor, including quantities and any custom currency item metadata.
As a normal customer, try one inexpensive trade while the owner watches the stock container, then note whether either side changes.
Move a small amount of the owner’s stock to a safe labeled container to leave payment space and repeat the same trade without changing its price.
Confirm the result
The trade should complete once enough matching stock and sufficient payment space are available. The customer receives the advertised item and the linked container receives the exact currency items.
If the result differs
A free slot may still be insufficient for a large payment or an unstackable custom currency. If space is adequate, compare the payment item’s metadata and the offered quantity with the recipe.
Recover safely
Return the temporarily moved stock after arranging permanent payment capacity. Do not replace the entire chest or delete the shop, because that can separate ownership and stock from the existing trade record.
Documentation and related help
Check the Shopkeepers maintainer documentation and Shopkeepers maintainer reference against your installed release before applying changes.
Related CloudExa help: Create Shopkeepers player shops and test trades safely and Find Minecraft logs and send useful troubleshooting details.